Identificare e specificare gli utenti di Google Chat

Questa pagina spiega i modi in cui le app di Google Chat possono identificare o specificare Utenti di Chat.

Per eseguire una delle seguenti operazioni, un'app di Chat devi specificare un utente:

In che modo Chat identifica gli utenti

L'API Google Chat genera User risorsa per ogni persona che utilizza Chat. Di seguito sono riportati due aspetti importanti User campi:

  • name è il nome della risorsa, nel formato users/{user}, dove {user} rappresenta un identificatore univoco e stabile. users/app può essere utilizzato come un alias per l'app Chat che chiama.
  • type è il tipo di utente. Questo tipo indica a Chat se l'utente è un'app di Chat o una persona. Per App di chat, il valore è BOT. Per le persone, il valore è HUMAN.

Specifica un utente in una chiamata all'API Google Chat

Per specificare un utente, utilizza i seguenti valori per il valore {user}:

  • Per gli utenti della tua organizzazione Google Workspace, utilizza una delle seguenti opzioni: i seguenti approcci:

    • Il name del User risorsa nell'API Chat, ad esempio users/123456789.
    • {person_id} per il nome di un Person risorsa nell'API People, dove resourceName è people/{person_id}, ad esempio, users/123456789 nell'API Chat rappresenta la stessa persona come people/123456789 nell'API People.
    • id per una risorsa User nell'API Directory, ad esempio users/123456789 nell'API Chat rappresenta la stessa persona come users/123456789 nell'API Directory.
  • Per gli utenti di un'organizzazione Google Workspace esterna che utilizza un Account Google, usi un alias email, ad esempio users/EMAIL_USERNAME@WORKSPACE_DOMAIN.com o users/EMAIL_USERNAME@gmail.com.

Identificare un utente da un evento di interazione

Ogni volta che un utente interagisce con un'app di Chat, Chat invia evento di interazione con informazioni sul l'interazione e l'utente. Ad esempio, quando l'utente menziona un'app di Chat in un messaggio, L'app di chat riceve informazioni sull'interazione, incluso il testo del messaggio e chi lo ha inviato. App di chat riferimento agli utenti quando recuperano informazioni sulle risorse di Chat.

Per identificare l'utente che ha interagito con un'app di chat: trova il valore della proprietà name nella User risorsa, che puoi ottenere Event.user.name.

Il seguente esempio JSON mostra il formato previsto dell'identità utente in un interazione con un'app di chat:

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

Un messaggio è un tipo specifico di interazione. Per identificare un utente che ha inviato un messaggio a un'app di Chat, trova il valore della proprietà name nella User, utilizzando uno dei due seguenti: