Ten dokument wyjaśnia, jak otrzymywać zdarzenia Google Meet z Google Cloud Pub/Sub i na nie odpowiadać.
Wydarzenie w Meet reprezentuje aktywność lub zmianę w zasobie Meet, np. utworzenie nowego spotkania. Dzięki zdarzeniom możesz dowiedzieć się, co się stało, a potem podjąć odpowiednie działania lub zareagować w sposób, który będzie miał znaczenie dla użytkowników.
Oto kilka przykładów zastosowań zdarzeń:
Obserwuj zmiany w spotkaniu i reaguj na nie, np. gdy spotkanie się rozpoczyna lub kończy.
śledzić, kto uczestniczył w spotkaniu, na potrzeby regulacyjne lub szkoleniowe;
Nasłuchiwanie transkrypcji 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.
Space. Meet utworzy wtedy wydarzenie, które zawiera dane o nowej przestrzeni do spotkań.Meet kategoryzuje wydarzenia według typu. Typy zdarzeń pomagają filtrować i otrzymywać tylko potrzebne informacje 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 wydarzeń 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 |
|
|
| 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 sekcji 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 pokoju 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ą metody subscribe lub query.
Subskrybowanie zdarzeń
Aby otrzymywać zdarzenia w czasie rzeczywistym, aplikacja Meet wywołuje metodę interfejsu subscriptions.create
Google Workspace Events API
w celu subskrybowania przestrzeni 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 wideo 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 wysłać zapytanie 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 zdarzenia:
google.workspace.meet.conference.v2.startedigoogle.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