Odpowiadanie na wydarzenia z Google Meet

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ń:

  • Obserwowanie zmian w spotkaniu i reagowanie 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.

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:

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
  • przetwarzać zdarzenia i na nie odpowiadać w czasie rzeczywistym;
  • Monitoruj zmiany w zasobach, aby poprawić wydajność aplikacji.
  • Pobierz dane ręcznie.
  • 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 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.

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