Method: spaces.findDirectMessage

Renvoie le message privé existant avec l'utilisateur spécifié. Si aucun espace de messages directs n'est trouvé, une erreur 404 NOT_FOUND est renvoyée. Pour obtenir un exemple, consultez Rechercher un message privé.

Avec l'authentification de l'application, renvoie l'espace de messages privés entre l'utilisateur spécifié et l'application Chat appelante.

Avec l'authentification de l'utilisateur, renvoie l'espace de messages privés entre l'utilisateur spécifié et l'utilisateur authentifié.

Compatible avec les types d'authentification suivants:

  • Authentification de l'application avec le champ d'application:

    • https://www.googleapis.com/auth/chat.bot

  • Authentification des utilisateurs avec l'un des champs d'application d'autorisation suivants:

    • https://www.googleapis.com/auth/chat.spaces.readonly
    • https://www.googleapis.com/auth/chat.spaces

Requête HTTP

GET https://chat.googleapis.com/v1/spaces:findDirectMessage

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
name

string

Obligatoire. Nom de la ressource de l'utilisateur avec lequel rechercher un message privé.

Format: users/{user}, où {user} correspond à l'id de la personne de l'API People ou à l'id de l'utilisateur de l'API Directory. Par exemple, si l'ID de profil de l'API People est 123456789, vous pouvez trouver un message privé avec cette personne en utilisant users/123456789 comme name. Lorsque vous êtes authentifié en tant qu'utilisateur, vous pouvez utiliser l'adresse e-mail comme alias pour {user}. Par exemple, users/[email protected], où [email protected] correspond à l'adresse e-mail de l'utilisateur Google Chat.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Space.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.bot

Pour en savoir plus, consultez le guide d'autorisation.