Na tej stronie znajdziesz opis zdarzeń Google Meet, które Twoja aplikacja może subskrybować za pomocą interfejsu Events API w Google Workspace. Gdy zdecydujesz, których typów zdarzeń potrzebujesz, utwórz subskrypcję, aby zacząć otrzymywać zdarzenia z Google Meet.
Więcej informacji o tworzeniu aplikacji na potrzeby Google Meet znajdziesz w artykule Omówienie interfejsu Google Meet REST API.
Obsługiwane zdarzenia Meet
Subskrypcje Google Workspace umożliwiają otrzymywanie zdarzeń dotyczących tych typów zmian w Meet:
- Konferencja rozpoczyna się lub kończy w pokoju spotkań.
- Uczestnik dołącza do konferencji lub z niej wychodzi.
- Nagranie jest generowane na potrzeby konferencji.
- Transkrypcja jest generowana na potrzeby konferencji.
Zasoby, które możesz monitorować pod kątem zdarzeń
Aby otrzymywać zdarzenia, musisz określić zasób Meet do monitorowania, który jest nazywany zasobem docelowym subskrypcji.
Interfejs Events API w Google Workspace obsługuje te zasoby docelowe w Meet:
| Zasób docelowy | Format | Ograniczenia (jeśli dotyczy) |
|---|---|---|
| Miejsce spotkań | //meet.googleapis.com/spaces/SPACE
gdzie SPACE to identyfikator w
nazwie zasobu zasobu |
|
| Użytkownik | //cloudidentity.googleapis.com/users/USER
gdzie USER to identyfikator w polu
|
Subskrypcja otrzymuje zdarzenia dotyczące pomieszczeń spotkań, w których użytkownik:
|
Typy zdarzeń do tworzenia subskrypcji
Podczas tworzenia subskrypcji zasobu Meet możesz użyć pola eventTypes[], aby określić, które typy zdarzeń chcesz otrzymywać. Typy zdarzeń są formatowane zgodnie ze specyfikacją CloudEvents, np. google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.
Aby na przykład otrzymywać zdarzenia dotyczące nowych uczestników konferencji w pokoju w Meet, musisz określić typ zdarzenia jako google.workspace.meet.participant.v2.joined. Więcej informacji o tym, jak działają zdarzenia, znajdziesz w artykule Struktura zdarzeń Google Workspace.
W tabeli poniżej znajdziesz obsługiwane typy zdarzeń, ich opisy oraz zmienione zasoby Meet reprezentowane w danych zdarzenia:
| Typ zdarzenia | Opis | Zasoby Meet |
|---|---|---|
|
Konferencja rozpoczyna się w pokoju konferencyjnym. |
|
|
Konferencja kończy się w sali konferencyjnej. |
|
|
Uczestnik dołącza do aktywnej konferencji w pokoju spotkań. |
|
|
Uczestnik opuszcza aktywną konferencję w pokoju spotkań. |
|
|
Plik z nagraniem jest generowany dla konferencji w sali konferencyjnej. |
|
|
Podczas konferencji w sali konferencyjnej jest generowany plik transkrypcji. |
|
Dane zdarzenia
W tej sekcji opisano dane zdarzeń i przykładowe ładunki danych zdarzeń w pokojach spotkań w Meet.
Gdy subskrypcja Google Workspace otrzyma zdarzenie z Meet, pole data będzie zawierać ładunek zdarzeń. Ten ładunek zawiera informacje o zmienionym zasobie Google Workspace. Jeśli na przykład subskrybujesz zdarzenia dotyczące nowych transkrypcji w pokoju, ładunek tych zdarzeń zawiera informacje o zasobach, które uległy zmianie (transcript).
Dane zasobu w ładunku zdarzenia
Poniższa tabela zawiera przykłady ładunków JSON dla subskrypcji sali konferencyjnej Meet. Przykłady wykorzystują konferencję conferenceRecords/AAA-BBB-CCC-DDD-EEE, która odbywa się w pokoju. W przypadku każdego zdarzenia, które subskrypcja odbiera, ładunek znajduje się w polu data zdarzenia:
| Przykład | Typ zdarzenia | Ładunek JSON |
|---|---|---|
Rozpoczyna się konferencja w sali konferencyjnej Meet. |
|
Nie zawiera danych o zasobach
{
"conferenceRecord":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
}
}
|
| Uczestnik dołącza do konferencji w pokoju spotkania Meet. |
|
Nie zawiera danych o zasobach
{
"participantSession":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/participants/FFF-GGG-HHH-III-JJJ/participantSessions/LLL-MMM-NNN-OOO-PPP"
}
}
|
| Nagranie jest generowane dla konferencji w przestrzeni spotkania Meet. | google.workspace.meet.recording.v2.fileGenerated |
Nie zawiera danych o zasobach
{
"recording":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP"
}
}
|
| Transkrypcja jest generowana dla konferencji w przestrzeni spotkania Meet. | google.workspace.meet.transcript.v2.fileGenerated |
Nie zawiera danych o zasobach
{
"transcript":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT"
}
}
|