Na tej stronie wyjaśniamy, jak aplikacje Google Chat mogą odbierać zdarzenia w Google Chat i odpowiadać na nie.
Zdarzenie w Google Chat odpowiada aktywności lub zmianie w tej usłudze, na przykład nowej wiadomości w pokoju. Aplikacja do obsługi czatu może korzystać ze zdarzeń, aby zrozumieć, co się stało, i podjąć odpowiednie działania lub zareagować w istotny sposób dla użytkowników.
Oto kilka przykładów użycia zdarzeń:
- Sprawdzaj nowe wiadomości i odpowiadaj na nie w pokoju, na przykład sprawdzaj słowa kluczowe i wyrażenia.
- Wyślij wiadomość powitalną do użytkowników dołączających do pokoju, aby wyjaśnić wytyczne dotyczące pokoju lub udzielić wskazówek na temat efektywnego korzystania z aplikacji Google Chat.
- Śledź i analizuj aktywność w Google Chat. aby na przykład wysyłać comiesięczny raport o nowych członkach grupy lub wiadomościach, które wzbudzają najwięcej reakcji lub odpowiedzi.
- Komunikacja na różnych platformach komunikacyjnych Na przykład użytkownicy mogą wysyłać i odbierać wiadomości z innej platformy do obsługi wiadomości bez opuszczania Google Chat.
Jak działają zdarzenia
Za każdym razem, gdy w Google Chat coś się stanie, zasób Google Chat API zostanie utworzony, zaktualizowany lub usunięty. Zdarzenia dostarczają informacji o czasie wystąpienia aktywności oraz o zasobie Chat API, którego to dotyczy.
Google Chat kategoryzuje zdarzenia według typu. Typy zdarzeń pomagają filtrować i wysyłać żądania tylko tych typów informacji, których potrzebujesz, a także obsługiwać podobne zdarzenia w ten sam sposób.
W tabeli poniżej pokazujemy, jak aktywność w Google Chat wpływa na powiązany zasób interfejsu Chat API oraz na jaki rodzaj zdarzenia odbierana jest aplikacja Google Chat:
| Aktywność | Zasób interfejsu Chat API | Typ zdarzenia |
|---|---|---|
Użytkownik publikuje wiadomość w pokoju Chat |
Zostanie utworzony zasób Message. |
Nowa wiadomość |
| Użytkownik staje się menedżerem pokoju. | Zaktualizowano zasób Membership. |
Zaktualizowane członkostwo |
| Użytkownik reaguje na wiadomość. | Zostanie utworzony zasób Reaction. |
Nowa reakcja |
| użytkownik opuści pokój; | Zasób Membership został usunięty. |
Usunięto członkostwo |
Odbieranie zdarzeń z Google Chat
Aby otrzymywać wydarzenia, aplikacja Google Chat może:
- Aby otrzymywać zdarzenia na bieżąco, subskrybuj zdarzenia za pomocą interfejsu Google Workspace Event API.
- Wysyłanie zapytań o zdarzenia przez wywoływanie interfejsu Chat API.
Interfejs Google Workspace Event API i Chat API obsługują i zapewniają te same typy zdarzeń. Aby dowiedzieć się, czy subskrybować zdarzenia lub wysyłać dotyczące ich zapytania, przejrzyj tę tabelę:
| Subskrybuj wydarzenia | Zapytanie dotyczące zdarzeń | |
|---|---|---|
| Przykłady zastosowań |
|
|
| API | Interfejs Google Workspace Events API | Chat API |
| Źródło zdarzeń | Pokoje i użytkownicy | Tylko pokoje |
| Format zdarzenia | Komunikat Google Cloud Pub/Sub sformatowany zgodnie ze specyfikacją CloudEvent. Więcej informacji znajdziesz w artykule Struktura zdarzeń Google Workspace. |
Zasób interfejsu Chat API (
spaces.spaceEvent)
|
| Dane zdarzenia | Ciąg zakodowany w standardzie Base64 z danymi zasobu lub bez nich. Przykładowe ładunki znajdziesz w sekcji Dane zdarzeń. | Ładunek JSON zawierający dane zasobów. Niektóre typy zdarzeń zawierają tylko określone pola zasobów. Przykładowe ładunki znajdziesz w dokumentacji referencyjnej SpaceEvents. |
Więcej informacji o tworzeniu subskrypcji za pomocą interfejsu Google Workspace Event API znajdziesz w dokumentacji interfejsu Google Workspace Event API. Jeśli chcesz wysyłać zapytania o zdarzenia przy użyciu interfejsu Chat API, zapoznaj się z tymi przewodnikami:
- Wyświetlanie szczegółowych informacji o wydarzeniu w pokoju Google Chat
- Wyświetlanie listy wydarzeń z pokoju Google Chat
Ograniczenia
-
W przypadku subskrypcji dla użytkowników zdarzenia dotyczące nowych członków na czacie lub w czatach grupowych bez nazw (
google.workspace.chat.membership.v1.created) są wywoływane dopiero po opublikowaniu pierwszej wiadomości. - Zmiany w historii pokoju nie wyzwalają zaktualizowanych zdarzeń dotyczących pokoju (typ zdarzenia:
google.workspace.chat.spaces.v1.updated). - Aby otrzymywać zdarzenia związane z członkostwem, użytkownik musi być bezpośrednim członkiem pokoju. Jeśli użytkownik został dodany, zaktualizowany lub usunięty pośrednio z pokoju za pomocą grupy dyskusyjnej Google, nie otrzyma tych zdarzeń członkostwa. Aby dowiedzieć się, jak działa członkostwo w Grupach dyskusyjnych Google, zobacz Dodawanie grupy dyskusyjnej Google do pokoju.