Subskrybowanie wydarzeń w Google Meet

Ta strona zawiera opis zdarzeń Google Meet, które Twoja aplikacja może subskrybować za pomocą interfejsu Events API w Google Workspace. Gdy zdecydujesz, jakie typy zdarzeń Ci odpowiadają, utwórz subskrypcję, aby zacząć otrzymywać zdarzenia z Meet.

Więcej informacji o tworzeniu aplikacji dla 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 ją opuszcza.
  • Nagranie jest generowane na potrzeby konferencji.
  • Transkrypcja jest generowana dla 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 nazwa zasobu zasobu space interfejsu API REST Meet. Więcej informacji znajdziesz w artykule Jak Meet rozpoznaje pomieszczenie na spotkanie.
Użytkownik //cloudidentity.googleapis.com/users/USER

gdzie USER to identyfikator w polu signedinUser.user zasobu interfejsu Meet REST API participant. Szczegółowe informacje znajdziesz w artykule Praca z uczestnikami.

Subskrypcja otrzymuje zdarzenia dotyczące pomieszczeń spotkań, w których użytkownik:

  • Właściciel zaplecza konferencyjnego.
  • Uczestnik w pokoju spotkania.
  • Organizator wydarzenia w Kalendarzu Google powiązanego z salą konferencyjną.

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, na przykład 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 zmieniony zasób Meet reprezentowany w danych zdarzenia:

Typ zdarzenia Opis Zasoby Meet

google.workspace.meet.conference.v2.started

Konferencja rozpoczyna się w pokoju spotkań.

conferenceRecord

google.workspace.meet.conference.v2.ended

Konferencja kończy się w sali konferencyjnej.

conferenceRecord

google.workspace.meet.participant.v2.joined

Uczestnik dołącza do aktywnej konferencji w pokoju spotkań.

conferenceRecord.participantSession

google.workspace.meet.participant.v2.left

Uczestnik opuszcza aktywną konferencję w pokoju spotkań.

conferenceRecord.participantSession

google.workspace.meet.recording.v2.fileGenerated

Plik z nagraniem jest generowany dla konferencji w sali konferencyjnej.

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

Podczas konferencji w sali konferencyjnej jest generowany plik transkrypcji.

conferenceRecord.transcript

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 zmienionym zasobie transcript.

Dane zasobu w ładunku zdarzenia

Poniższa tabela zawiera przykłady ładunków JSON na potrzeby subskrypcji pokoju spotkań w 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 otrzymuje, ładunek znajduje 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 o zasobach
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
    }
}
Uczestnik dołącza do konferencji w pokoju spotkania Meet.

google.workspace.meet.participant.v2.joined

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