Na tej stronie opisaliśmy zdarzenia w Google Meet, które Twoja aplikacja może subskrybować za pomocą interfejsu Google Workspace Events API. Po wybraniu odpowiednich typów zdarzeń, utwórz subskrypcji, aby zacząć otrzymywać wydarzeń z Google Meet.
Aby dowiedzieć się więcej o tworzeniu aplikacji do Google Meet, przeczytaj artykuł Interfejs Google Meet API typu REST .
Obsługiwane zdarzenia Meet
Subskrypcje Google Workspace umożliwiają otrzymywanie zdarzeń dotyczących: tych typów zmian w Meet:
- O konferencja rozpoczyna się lub kończy w sali konferencyjnej.
- O uczestnik dołącza do konferencji lub ją opuszcza.
- O nagranie dla konferencji.
- O transkrypcja dla konferencji.
Zasoby, które możesz monitorować pod kątem zdarzeń
Aby odbierać zdarzenia, określ zasób Meet, który ma być monitorowany, który jest nazywany docelowym zasobem subskrypcji.
Interfejs Google Workspace Events API obsługuje te zasoby docelowe w Meet:
| Zasób docelowy | Format | Ograniczenia (jeśli mają zastosowanie) |
|---|---|---|
| Miejsce spotkań | //meet.googleapis.com/spaces/SPACE
gdzie SPACE jest identyfikatorem w
nazwa zasobu interfejsu Meet REST API |
|
| Użytkownik | //cloudidentity.googleapis.com/users/USER
gdzie USER jest identyfikatorem w
|
Subskrypcja otrzymuje zdarzenia dotyczące sal konferencyjnych, w których użytkownik jest jednym z tych:
|
Typy zdarzeń związane z tworzeniem subskrypcji
Gdy tworzysz subskrypcję zasobu Meet, używasz tagu
eventTypes[]
aby określić, jakiego typu zdarzenia chcesz otrzymywać. Typy zdarzeń:
sformatowane 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 dla danej
jako typ wydarzenia w Meet.
google.workspace.meet.participant.v2.joined Więcej informacji o działaniu zdarzeń
pracy: Struktura Google Workspace
wydarzenia.
W tabeli poniżej znajdziesz obsługiwane typy zdarzeń, ich opis i zmieniono zasób Meet reprezentowany w danych zdarzenia:
| Typ zdarzenia | Opis | Materiały dotyczące Meet |
|---|---|---|
|
W sali konferencyjnej rozpocznie się konferencja. |
|
|
Rozmowa wideo zakończy się w sali konferencyjnej. |
|
|
Uczestnik dołącza do aktywnej rozmowy wideo w miejscu spotkań. |
|
|
Uczestnik opuszcza aktywną konferencję w miejscu spotkań. |
|
|
W przypadku rozmowy wideo w sali konferencyjnej zostanie wygenerowany plik z nagraniem. |
|
|
W przypadku rozmowy wideo w miejscu spotkań generowany jest plik transkrypcji. |
|
Dane zdarzenia
W tej sekcji znajdziesz opis danych zdarzeń i przykładowe ładunki zdarzeń w Sale konferencyjne.
Gdy Twój abonament Google Workspace otrzyma zdarzenie z
Oto
data
zawiera ładunek zdarzenia. Ten ładunek zawiera informacje o
Zmieniony zasób Google Workspace. Jeśli na przykład subskrybujesz
zdarzeń dotyczących nowych transkrypcji w pokoju, ładunek dla tych zdarzeń będzie zawierać
informacje na temat
transcript
które uległy zmianie.
Dane zasobu w ładunku zdarzenia
W tabeli poniżej znajdziesz przykłady ładunków JSON dla subskrypcji
na spotkaniach w Meet. W przykładach użyto konferencji
conferenceRecords/AAA-BBB-CCC-DDD-EEE, które odbywają się w pokoju. Dla każdego wydarzenia
ładunek pojawi się w polu data sekcji
zdarzenie:
| Przykład | Typ zdarzenia | Ładunek JSON |
|---|---|---|
Rozpocznie się konferencja w miejscu spotkań w Meet. |
|
Nie uwzględnia danych zasobów
{
"conferenceRecord":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
}
}
|
| Uczestnik dołącza do rozmowy w sali konferencyjnej w Meet. |
|
Nie uwzględnia 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 uwzględnia danych zasobów
{
"recording":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP"
}
}
|
| W przypadku rozmowy wideo w sali konferencyjnej w Meet zostanie wygenerowana transkrypcja. | google.workspace.meet.transcript.v2.fileGenerated |
Nie uwzględnia danych zasobów
{
"transcript":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT"
}
}
|