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

Na tej stronie wyjaśniamy, jak aplikacje Google Chat mogą identyfikować lub wskazywać użytkowników czatu.

Aby wykonać którąkolwiek z tych czynności, aplikacja Google Chat musi określić użytkownika:

Jak Google Chat identyfikuje użytkowników

Interfejs Google Chat API generujeUser zasób dla każdej osoby korzystającej z Google Chat. Oto 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 do aplikacji Google Chat do wykonywania połączeń.
  • type to typ użytkownika. Ten typ określa, czy użytkownik jest aplikacją Google Chat czy osobą. W przypadku aplikacji do czatu wartość to BOT. W przypadku osób jest to wartość HUMAN.

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

Aby określić użytkownika, użyj tych wartości w polu {user}:

  • W przypadku użytkowników w organizacji Google Workspace zastosuj jedną z tych metod:

    • name zasobu User w interfejsie Chat API, np. users/123456789.
    • {person_id} to nazwa zasobu Person w People API, gdzie resourceName to people/{person_id} – na przykład users/123456789 w Chat API reprezentuje tę samą osobę co people/123456789 w People API.
    • id zasobu User w Directory API – na przykład users/123456789 w Chat API reprezentuje tę samą osobę co users/123456789 w 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, Chat wysyła zdarzenie interakcji z informacjami o tej interakcji i użytkowniku. Jeśli na przykład użytkownik wspomni w wiadomości o aplikacji Google Chat, aplikacja Google Chat otrzyma informacje o tej interakcji, w tym o treści wiadomości i jej nadawcy. Aplikacje do obsługi czatu odwołują się do użytkowników podczas pobierania informacji o zasobach Google Chat.

Aby zidentyfikować użytkownika, który wszedł w interakcję z aplikacją Google Chat, pobierz wartość właściwości name w zasobach User, do których możesz uzyskać dostęp z poziomu Event.user.name.

Ten przykładowy kod JSON pokazuje oczekiwany format tożsamości użytkownika w interakcjach z aplikacją do czatu:

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

Wiadomość to określony typ interakcji. Aby zidentyfikować użytkownika, który wysłał wiadomość do aplikacji Google Chat, uzyskaj wartość właściwości name w zasobach User, korzystając z jednej z tych metod: