Identifier et spécifier des utilisateurs Google Chat

Cette page explique comment les applications Google Chat peuvent identifier ou spécifier des utilisateurs Chat.

Pour effectuer l'une des opérations suivantes, une application Chat doit spécifier un utilisateur:

Comment Chat identifie-t-il les utilisateurs ?

L'API Google Chat génère une ressource User pour chaque personne qui utilise Chat. Vous trouverez ci-dessous deux champs User importants:

  • name est le nom de la ressource, au format users/{user}, où {user} représente un identifiant unique et stable. users/app peut être utilisé comme alias pour l'application Chat appelante.
  • type est le type d'utilisateur. Ce type indique à Chat si l'utilisateur est une application Chat ou une personne. Pour les applications de chat, la valeur est BOT. Pour les personnes, la valeur est HUMAN.

Spécifier un utilisateur dans un appel à l'API Google Chat

Pour spécifier un utilisateur, utilisez les valeurs suivantes pour la valeur {user}:

  • Pour les utilisateurs de votre organisation Google Workspace, utilisez l'une des approches suivantes:

    • name de la ressource User dans l'API Chat, par exemple users/123456789.
    • {person_id} pour le nom d'une ressource Person dans l'API People, où resourceName est people/{person_id}. Par exemple, users/123456789 dans l'API Chat représente la même personne que people/123456789 dans l'API People.
    • id pour une ressource User dans l'API Directory (par exemple, users/123456789 dans l'API Chat représente la même personne que users/123456789 dans l'API Directory).

  • Pour un utilisateur d'une organisation Google Workspace externe ou d'un compte Google, utilisez un alias d'adresse e-mail (par exemple, users/EMAIL_USERNAME@WORKSPACE_DOMAIN.com ou users/EMAIL_USERNAME@gmail.com).

Identifier un utilisateur à partir d'un événement d'interaction

Chaque fois qu'un utilisateur interagit avec une application Chat, Chat envoie un événement d'interaction contenant des informations sur l'interaction et l'utilisateur. Par exemple, lorsqu'un utilisateur mentionne une application Chat dans un message, l'application Chat reçoit des informations sur l'interaction, y compris le contenu du message et son expéditeur. Les applications Chat font référence aux utilisateurs lorsqu'elles récupèrent des informations sur les ressources Chat.

Pour identifier l'utilisateur qui a interagi avec une application Chat, obtenez la valeur de la propriété name sur la ressource User, que vous pouvez obtenir à partir de Event.user.name.

L'exemple JSON suivant montre le format attendu de l'identité de l'utilisateur lors d'une interaction avec une application Chat:

{
  ...,
  "user": {
    "name": "users/12345678901234567890",
    "displayName": "Sasha",
    "avatarUrl": "https://lh3.googleusercontent.com/.../photo.jpg",
    "email": "sasha@example.com"
  }
}

Un message est un type d'interaction spécifique. Pour identifier un utilisateur qui a envoyé un message à une application Chat, obtenez la valeur de la propriété name sur la ressource User, à l'aide de l'une des méthodes suivantes: