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

Na tej stronie wyjaśniamy, jak aplikacje w Google Chat mogą identyfikować i określać ustawienia Użytkownicy czatu.

Jeśli chcesz wykonać dowolną z tych czynności, aplikacja Google Chat musi określać użytkownika:

Jak Google Chat identyfikuje użytkowników

Interfejs Google Chat API generuje User zasób za każdą osobę, która korzysta z Google Chat. Oto 2 ważne kwestie: User pola:

  • name to nazwa zasobu w formacie users/{user}, gdzie {user} to unikalny, trwały identyfikator. users/app puszka być używane jako alias wywołującego aplikację Google Chat.
  • Użytkownik jest typem użytkownika type. Ten typ informuje Google Chat, czy to osoba lub aplikacja do obsługi czatu. Dla: komunikatorów, wartość wynosi BOT. Dla ludzi wartość jest HUMAN

Określ użytkownika w wywołaniu interfejsu Google Chat API

Aby wskazać użytkownika, użyj tej wartości w polu {user}:

  • W przypadku użytkowników z organizacji Google Workspace użyj jednej z następujące działania:

    • name User zasób w interfejsie Chat API, na przykład users/123456789.
    • {person_id} dla nazwy zasób Person w interfejsie People API, gdzie resourceName to people/{person_id}, na przykład users/123456789 w interfejsie Chat API reprezentuje tę samą osobę jako people/123456789 w interfejsie People API.
    • Identyfikator id zasobu User w interfejsie Directory API, na przykład users/123456789 w interfejsie Chat API reprezentuje tę samą osobę jako 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 wejdzie w interakcję z aplikacją Google Chat, Google Chat wysyła zdarzenia interakcji z informacjami o do interakcji z użytkownikiem. Na przykład, gdy plik użytkownik wspomina w wiadomości o aplikacji Google Chat, aplikacja do obsługi czatu otrzymuje informacje o interakcji, łącznie z treścią wiadomości i tym, kto ją wysłał. Komunikatory odniesienia do użytkowników przy pobieraniu informacji o zasobach Google Chat.

Aby zidentyfikować użytkownika, który korzystał z aplikacji Google Chat: pobierz wartość właściwości name w funkcji User zasób, które są dostępne Event.user.name

Poniższy przykładowy kod JSON pokazuje oczekiwany format tożsamości użytkownika w interakcja z aplikacją do obsługi czatu:

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

Wiadomość to określony typ interakcji. Identyfikowanie użytkownika, który wysłał wiadomość do aplikacji Google Chat, pobierz wartość właściwości name w funkcji User, używając jednej z :