Identificare e specificare gli utenti di Google Chat

Questa pagina spiega in che modo le app Google Chat possono identificare o specificare gli utenti di Chat.

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

In che modo Chat identifica gli utenti

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

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

Specificare 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 uno dei seguenti approcci:

    • Il name della risorsa User nell'API Chat, ad esempio users/123456789.
    • {person_id} per il nome di una risorsa Person nell'API People, dove resourceName è people/{person_id}. Ad esempio, users/123456789 nell'API Chat rappresenta la stessa persona di people/123456789 nell'API People.
    • Il valore id per una risorsa User nell'API Directory, ad esempio, users/123456789 nell'API Chat rappresenta la stessa persona users/123456789 nell'API Directory.

  • Per un utente di un'organizzazione Google Workspace esterna o di un utente che utilizza un Account Google, utilizza 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 un evento di interazione con informazioni sull'interazione e sull'utente. Ad esempio, quando un utente menziona un'app di chat in un messaggio, l'app di chat riceve informazioni sull'interazione, incluso il contenuto del messaggio e chi lo ha inviato. Le app di Chat fanno riferimento agli utenti quando recuperano informazioni sulle risorse di Chat.

Per identificare l'utente che ha interagito con un'app di Chat, recupera il valore della proprietà name nella risorsa User, che puoi ottenere da 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, recupera il valore della proprietà name nella risorsa User utilizzando una delle seguenti opzioni: