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:
- Utwórz wiadomość, która @ zawiera wzmiankę o użytkowniku.
- Zaproś lub dodaj użytkownika do istniejąca przestrzeń, lub dodaj użytkownika do nowej przestrzeni.
- Znajdowanie czatów między aplikacją Google Chat a konkretnym użytkownikiem, między 2 użytkownikami.
- Wyświetlanie informacji o członkostwie użytkownika w pokoju
- Wyślij wiadomość prywatną do użytkownika.
- Subskrybuj użytkownika za pomocą Interfejs Google Workspace Events API do pobierania zdarzeń dotyczących zmian w członkostwie.
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 formacieusers/{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ść wynosiBOT
. Dla ludzi wartość jestHUMAN
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 podejść do tych kwestii:
name
User
zasób w interfejsie Chat API, na przykładusers/123456789
.{person_id}
dla nazwy zasóbPerson
w interfejsie People API, gdzieresourceName
topeople/{person_id}
, na przykładusers/123456789
w interfejsie Chat API reprezentuje tę samą osobę jakopeople/123456789
w interfejsie People API.- Identyfikator
id
zasobuUser
w interfejsie Directory API, na przykładusers/123456789
w interfejsie Chat API reprezentuje tę samą osobę jakousers/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
lubusers/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
:
Powiązane artykuły
- Dodawanie użytkownika do pokoju
- Zarządzanie użytkownikami w pokoju
- Dodaj wzmiankę o użytkowniku w wiadomości.