Odpowiadanie na wydarzenia z Google Meet

Ten dokument wyjaśnia, jak odbierać zdarzenia Google Meet z Google Cloud Pub/Sub i na nie odpowiadać.

Zdarzenie Meet reprezentuje działanie lub zmianę zasobu Meet, np. utworzenie nowego spotkania. Zdarzenia możesz wykorzystywać do analizowania tego, co się wydarzyło, a potem podejmować odpowiednie działania lub reagować w sposób, który będzie miał znaczenie dla użytkowników.

Oto kilka przykładów zastosowań zdarzeń:

• Obserwowanie zmian w spotkaniu i reagowanie na nie, np. gdy spotkanie się rozpoczyna lub kończy.

• śledzić, kto uczestniczył w spotkaniu, na potrzeby szkolenia lub ze względu na przepisy;

• Odsłuchaj transkrypcję spotkania, aby można było przeanalizować zawartość pliku i zapisać ją w systemie CRM lub bazie danych.

Jak działają zdarzenia

Gdy w Google Meet coś się dzieje, tworzony lub aktualizowany jest zasób interfejsu Google Meet REST API. Meet używa zdarzeń, aby przekazywać do aplikacji informacje o rodzaju aktywności i zasobie interfejsu Meet REST API, którego dotyczy.

Meet kategoryzuje wydarzenia według typu. Typy zdarzeń pomagają filtrować i otrzymywać tylko te informacje, których potrzebujesz, oraz umożliwiają podobne działania w ten sam sposób.

Poniższy przykład pokazuje, jak aktywność w Meet wpływa na powiązany zasób interfejsu Meet REST API oraz typ zdarzenia, które otrzymuje aplikacja Meet:

Aktywność	Zasób interfejsu Meet REST API	Typ zdarzenia
Użytkownik dołącza do pokoju spotkań.	Utworzono zasób ConferenceRecord.	Nowy rekord konferencji

Odbieranie danych o zdarzeniach z Google Meet

Aby otrzymywać dane o wydarzeniach, aplikacja może wykonać jedną z tych czynności:

• Subskrybuj zdarzenia za pomocą interfejsu Google Workspace Events API, aby otrzymywać zdarzenia w miarę ich występowania. Więcej informacji znajdziesz w artykule Subskrybowanie zdarzeń w Google Meet.

• Wysyłanie zapytań o najnowsze dane za pomocą interfejsu Meet REST API.

W tabeli poniżej znajdziesz wyjaśnienie różnic między subskrybowaniem zdarzeń a wysyłaniem zapytań o nie oraz powody, dla których warto subskrybować zdarzenia:

	Subskrybowanie zdarzeń	Wysyłanie zapytania o dane
Przypadki użycia	Przetwarzaj zdarzenia i reaguj na nie w czasie rzeczywistym. Monitoruj zmiany w zasobach, aby poprawić wydajność aplikacji.	Ręczne pobieranie danych. Pobieranie wszystkich danych z Meet (z powodu awarii lub nieaktywnego abonamentu).
Interfejs API	Interfejs Google Workspace Events API	Meet REST API
Źródło zdarzeń	Rekord konferencji i użytkownicy	Pokój i zapis konferencji
Obsługiwane zdarzenia	Nagranie konferencji Listę obsługiwanych typów zdarzeń znajdziesz w artykule Typy zdarzeń do tworzenia subskrypcji w dokumentacji interfejsu Google Workspace Events API.	Przestrzeń i rekord konferencji Listę obsługiwanych punktów końcowych znajdziesz w dokumentacji interfejsu Meet REST API w sekcjach dotyczących zasobu Space i zasobu ConferenceRecord.
Format zdarzenia	Wiadomość Google Cloud Pub/Sub sformatowana zgodnie ze specyfikacją CloudEvent. Więcej informacji znajdziesz w artykule Struktura zdarzeń Google Workspace.	Zasób interfejsu Meet REST API (Space i ConferenceRecord)
Dane zdarzenia	Ciąg tekstowy zakodowany w formacie Base64 z danymi zasobu lub bez nich. Przykładowe ładunki znajdziesz w sekcji Dane zdarzenia.	Ładunek JSON zawierający dane zasobu. Przykładowy ładunek znajdziesz w ConferenceRecord w dokumentacji.

Przykład: pobieranie zdarzeń dotyczących uczestników w pokoju spotkań

W tym przykładzie aplikacja Meet chce otrzymywać informacje o zmianach uczestników w pomieszczeniu do spotkań. W przestrzeni spotkania uczestnik dołącza do aktywnej konferencji, co powoduje wypełnienie zasobu ParticipantSession i wywołanie nowego wydarzenia. Informacje o tych zdarzeniach możesz uzyskać za pomocą metod subscribe lub query.

Subskrybowanie zdarzeń

Aby otrzymywać zdarzenia w czasie rzeczywistym, aplikacja Meet wywołuje metodę subscriptions.create interfejsu Google Workspace Events API, aby subskrybować przestrzeń spotkania dla wszystkich typów zdarzeń. Po utworzeniu subskrypcji aplikacja Meet może zacząć odbierać zdarzenia.

Na ilustracji 2 aplikacja Meet ma aktywną subskrypcję przestrzeni spotkania, więc otrzymuje zdarzenie za każdym razem, gdy w przestrzeni spotkania zmieni się sesja uczestnika. Aplikacja Meet może wtedy odpowiadać w czasie rzeczywistym na wszelkie działania, np. wiedzieć, kiedy uczestnik dołącza do aktywnej rozmowy lub ją opuszcza.

Więcej informacji o tworzeniu subskrypcji za pomocą interfejsu Google Workspace Events API znajdziesz w dokumentacji interfejsu Google Workspace Events API.

Zapytanie o ostatnie zdarzenia

Aplikacja Meet może też wywoływać interfejs Meet REST API, aby wyświetlać listę ostatnich zdarzeń w pokoju spotkań związanych z aktywnością uczestników, zamiast otrzymywać zdarzenia w miarę ich występowania.

Na ilustracji 3 aplikacja Meet wywołuje metodę interfejsu Meet REST API conferenceRecords.participants.participantSessions.list po zakończeniu wszystkich działań w sesji uczestnika. Interfejs Meet REST API zwraca listę zasobów ParticipantSession, które reprezentują każdą ze zmian. Aplikacja Meet może wtedy przetwarzać informacje lub odpowiadać na podstawie ostatnich działań, np. tworzyć listę uczestników, którzy dołączyli do konferencji i ją opuścili.

Aby wysyłać zapytania o zdarzenia za pomocą interfejsu Meet REST API, zapoznaj się z artykułem Wyświetlanie listy wszystkich sesji uczestników.

Ograniczenia

• Goście zaproszeni do Kalendarza i inni uczestnicy rozmowy mogą otrzymywać tylko te wydarzenia: google.workspace.meet.conference.v2.started i google.workspace.meet.transcript.v2.fileGenerated.

Powiązane artykuły

• Omówienie interfejsu Google Workspace Events API
• Tworzenie subskrypcji Google Workspace
• Subskrybowanie wydarzeń w Google Meet