Na tej stronie opisujemy wydarzenia w Google Meet, które Twoja aplikacja może subskrybować przy użyciu interfejsu Google Workspace Event API. Gdy określisz potrzebne typy zdarzeń, utwórz subskrypcję, aby zacząć otrzymywać wydarzenia z Google Meet.
Więcej informacji o tworzeniu aplikacji na potrzeby Google Meet znajdziesz w omówieniu interfejsu Google Meet API typu REST.
Obsługiwane zasoby docelowe Meet
Aby odbierać wydarzenia w Meet, interfejs Google Workspace Event API obsługuje subskrypcje tych zasobów:
- Miejsca spotkań oznaczone jako zasoby
space
. - Użytkownicy przedstawiani jako zasoby
user
interfejsu Cloud Identity API.
Obsługiwane zdarzenia Meet
Subskrypcje Google Workspace pozwalają otrzymywać zdarzenia dotyczące następujących typów zmian w Meet:
- Rozmowa wideo rozpoczyna się lub kończy w sali konferencyjnej.
- uczestnik dołącza do rozmowy lub ją opuszcza.
- Na potrzeby rozmowy wideo zostanie wygenerowane nagranie.
- Wygenerowany transkrypcja rozmowy wideo.
Podczas tworzenia subskrypcji zasobu Meet w polu eventTypes[]
możesz określić typy zdarzeń, które chcesz otrzymywać. Typy zdarzeń są formatowane zgodnie ze specyfikacją CloudEvents, np. google.workspace.APPLICATION.RESOURCE.VERSION.ACTION
.
Aby na przykład otrzymywać informacje o wydarzeniach dotyczących nowych uczestników konferencji w pokoju Meet, jako typ wydarzenia ustaw google.workspace.meet.participant.v2.joined
. Więcej informacji o tym, jak działają zdarzenia, znajdziesz w artykule Struktura wydarzeń w Google Workspace.
Poniższa tabela zawiera obsługiwane typy zdarzeń, opis i zmieniony zasób Meet reprezentowany w danych zdarzenia:
Typ zdarzenia | Opis | Zasób dotyczący Google Meet |
---|---|---|
|
Rozmowa rozpoczyna się w sali konferencyjnej. |
|
|
Rozmowa wideo kończy się w sali konferencyjnej. |
|
|
Uczestnik dołącza do aktywnej konferencji w miejscu spotkania. |
|
|
Uczestnik opuszcza aktywną konferencję w miejscu spotkania. |
|
|
W miejscu spotkań tworzony jest plik z nagraniem konferencji. |
|
|
W miejscu spotkania zostanie wygenerowany plik transkrypcji rozmowy wideo. |
|
Dane zdarzenia
W tej sekcji omawiamy dane zdarzeń i przykładowe ładunki dla zdarzeń w salach konferencyjnych w Meet.
Gdy subskrypcja Google Workspace otrzyma zdarzenie z Meet, pole data
będzie zawierać ładunek tego zdarzenia. Zawiera on informacje o zmienionym zasobie Google Workspace. Jeśli na przykład subskrybujesz w pokoju zdarzenia dotyczące nowych transkrypcji, ładunek dla tych zdarzeń będzie zawierał informacje o zmienionym zasobie transcript
.
Dane zasobów w ładunku zdarzenia
W tabeli poniżej znajdziesz przykłady ładunków JSON w przypadku subskrypcji miejsca spotkań w Meet. W przykładach wykorzystano konferencję conferenceRecords/AAA-BBB-CCC-DDD-EEE
, która ma miejsce w pokoju. W przypadku każdego odbieranego przez subskrypcję ładunku ładunek pojawia się w polu data
zdarzenia:
Przykład | Typ zdarzenia | Ładunek JSON |
---|---|---|
Rozpoczyna się konferencja w sali konferencyjnej Meet. |
|
Nie zawiera danych zasobów
{ "conferenceRecord": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE" } } |
Uczestnik dołącza do konferencji w sali konferencyjnej w Meet. |
|
Nie zawiera danych zasobów
{ "participantSession": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/participants/FFF-GGG-HHH-III-JJJ/participantSessions/LLL-MMM-NNN-OOO-PPP" } } |
W sali konferencyjnej w Meet zostanie wygenerowane nagranie rozmowy wideo. | google.workspace.meet.recording.v2.fileGenerated |
Nie zawiera danych zasobów
{ "recording": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP" } } |
Transkrypcja rozmowy wideo jest generowana w miejscu spotkania w Meet. | google.workspace.meet.transcript.v2.fileGenerated |
Nie zawiera danych zasobów
{ "transcript": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT" } } |