Na tej stronie opisujemy, jak aplikacje Google Chat mogą identyfikować i określać użytkowników tej usługi.
Aby można było wykonać dowolną z tych czynności, aplikacja do obsługi czatu musi określić użytkownika:
- Utwórz wiadomość, w której @ wzmianki zawiera wzmiankę o użytkowniku.
- Zaproś lub dodaj użytkownika do istniejącego pokoju lub dodaj użytkownika do nowego pokoju.
- Znajdowanie wiadomości na czacie między aplikacją Google Chat a określonym użytkownikiem lub między 2 użytkownikami.
- Uzyskiwanie informacji o członkostwie użytkownika w pokoju
- Wyślij prywatną wiadomość do użytkownika.
Jak Google Chat identyfikuje użytkowników
Interfejs Google Chat API generuje zasób User
dla każdej osoby korzystającej z Google Chat. Te 2 ważne pola User
:
name
to nazwa zasobu w formacieusers/{user}
, gdzie{user}
to unikalny i stabilny identyfikator.users/app
może służyć jako alias aplikacji do rozmów w Google Chat.type
to typ użytkownika. Ten typ informuje Google Chat, czy użytkownik jest człowiekiem czy aplikacją Google Chat. W przypadku aplikacji do obsługi czatu wartość toBOT
. W przypadku osób wartość wynosiHUMAN
.
Określanie użytkownika w wywołaniu interfejsu Google Chat API
Aby określić użytkownika, użyj tych wartości jako wartości {user}
:
W przypadku użytkowników w organizacji Google Workspace skorzystaj z jednego z tych sposobów:
- Wartość
name
zasobuUser
w interfejsie Chat API, np.users/123456789
. - Pole
{person_id}
nazwy zasobuPerson
w interfejsie People API, gdzieresourceName
topeople/{person_id}
– np.users/123456789
w interfejsie Chat API reprezentuje tę samą osobę copeople/123456789
w interfejsie People API. - Parametr
id
zasobuUser
w interfejsie Directory API, np.users/123456789
w interfejsie Chat API, reprezentuje tę samą osobę cousers/123456789
w interfejsie Directory API.
- Wartość
W przypadku użytkownika z zewnętrznej organizacji Google Workspace lub użytkownika, który korzysta z konta Google, użyj aliasu e-mail, na przykład
users/EMAIL_USERNAME@WORKSPACE_DOMAIN.com
lubusers/EMAIL_USERNAME@gmail.com
.
Identyfikowanie użytkownika na podstawie zdarzenia interakcji
Za każdym razem, gdy użytkownik wchodzi w interakcję z aplikacją Google Chat, Google Chat wysyła zdarzenie interakcji z informacjami o interakcji i użytkowniku. Jeśli na przykład użytkownik wspomni w wiadomości o aplikacji Google Chat, otrzyma ona informacje o tej interakcji, w tym treść wiadomości i jej autora. Aplikacje do obsługi czatu odwołują się do użytkowników, gdy pobierają informacje o zasobach Google Chat.
Aby zidentyfikować użytkownika, który wszedł w interakcję z aplikacją do Google Chat, pobierz wartość właściwości name
dla zasobu User
, który możesz uzyskać z Event.user.name
.
Ten przykładowy kod JSON przedstawia oczekiwany format tożsamości użytkownika podczas interakcji z aplikacją do obsługi czatu:
{
...,
"user": {
"name": "users/12345678901234567890",
"displayName": "Sasha",
"avatarUrl": "https://lh3.googleusercontent.com/.../photo.jpg",
"email": "sasha@example.com"
}
}
Komunikat to określony typ interakcji. Aby zidentyfikować użytkownika, który wysłał wiadomość do aplikacji Google Chat, pobierz wartość właściwości name
w zasobie User
, korzystając z jednego z tych sposobów: