Identyfikowanie i określanie użytkowników Google Chat

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:

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 formacie users/{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ść to BOT. W przypadku osób wartość wynosi HUMAN.

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 zasobu User w interfejsie Chat API, np. users/123456789.
    • Pole {person_id} nazwy zasobu Person w interfejsie People API, gdzie resourceName to people/{person_id} – np. users/123456789 w interfejsie Chat API reprezentuje tę samą osobę co people/123456789 w interfejsie People API.
    • Parametr id zasobu User w interfejsie Directory API, np. users/123456789 w interfejsie Chat API, reprezentuje tę samą osobę co users/123456789 w interfejsie Directory API.

  • 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 lub users/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: