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:
- Crea un messaggio che @ menziona un utente.
- Invitare o aggiungere un utente a un spazio esistente, o aggiungere un utente a un nuovo spazio.
- Trovare i messaggi diretti tra l'app Chat e un utente specifico oppure tra due utenti.
- Recuperare i dettagli dell'iscrizione di un utente in uno spazio.
- Invia un messaggio privato a un utente.
- Iscriviti a un utente utilizzando API Google Workspace Events per ricevere eventi relativi alle modifiche dei loro abbonamenti.
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 formatousers/{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
delUser
risorsa nell'API Chat, ad esempiousers/123456789
. {person_id}
per il nome di unPerson
risorsa nell'API People, doveresourceName
èpeople/{person_id}
, ad esempio,users/123456789
nell'API Chat rappresenta la stessa persona comepeople/123456789
nell'API People.id
per una risorsaUser
nell'API Directory, ad esempiousers/123456789
nell'API Chat rappresenta la stessa persona comeusers/123456789
nell'API Directory.
- Il
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
ousers/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:
Argomenti correlati
- Aggiungere un utente a uno spazio.
- Gestire i membri in uno spazio.
- @ menzionare un utente in un messaggio.