Subskrybowanie wydarzeń w Google Meet

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

google.workspace.meet.conference.v2.started

Rozmowa rozpoczyna się w sali konferencyjnej.

conferenceRecord

google.workspace.meet.conference.v2.ended

Rozmowa wideo kończy się w sali konferencyjnej.

conferenceRecord

google.workspace.meet.participant.v2.joined

Uczestnik dołącza do aktywnej konferencji w miejscu spotkania.

conferenceRecord.participantSession

google.workspace.meet.participant.v2.left

Uczestnik opuszcza aktywną konferencję w miejscu spotkania.

conferenceRecord.participantSession

google.workspace.meet.recording.v2.fileGenerated

W miejscu spotkań tworzony jest plik z nagraniem konferencji.

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

W miejscu spotkania zostanie wygenerowany plik transkrypcji rozmowy wideo.

conferenceRecord.transcript

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.

google.workspace.meet.conference.v2.started

Nie zawiera danych zasobów
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
    }
}
Uczestnik dołącza do konferencji w sali konferencyjnej w Meet.

google.workspace.meet.participant.v2.joined

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"
    }
}