Subskrybowanie wydarzeń w Google Meet

W tym dokumencie opisujemy zdarzenia w Google Meet, które Twoja aplikacja może subskrybować za pomocą interfejsu Google Workspace Events API. Po określeniu, jakich typów zdarzeń potrzebujesz, utwórz subskrypcję, aby zacząć otrzymywać zdarzenia z Meet.

Oprócz subskrybowania wydarzeń możesz też wysyłać zapytania o wydarzenia, wywołując interfejs Google Meet REST API. Wywołuj interfejs API REST Meet, aby okresowo pobierać wydarzenia lub nadrabiać zaległości w zakresie wydarzeń, które mogły Ci umknąć z powodu awarii subskrypcji. Więcej informacji o tym, jak otrzymywać powiadomienia o wydarzeniach w Meet i na nie odpowiadać, znajdziesz w artykule Odpowiadanie na wydarzenia w Google Meet w dokumentacji Meet.

Więcej informacji o tworzeniu aplikacji dla Meet znajdziesz w artykule Omówienie interfejsu Google Meet REST API.

Obsługiwane wydarzenia w 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.
  • Nagrywanie rozpoczyna się lub kończy albo generowany jest plik z konferencji.
  • Transkrypcja rozpoczyna się, kończy lub generowany jest plik dla konferencji.

Zasoby, które możesz monitorować pod kątem zdarzeń

Aby odbierać zdarzenia, musisz określić zasób Meet do monitorowania, który jest nazywany zasobem docelowym subskrypcji.

Interfejs Google Workspace Events API obsługuje te zasoby docelowe w przypadku Meet:

Zasób docelowy Format Ograniczenia (w odpowiednich przypadkach)
Miejsce spotkań //meet.googleapis.com/spaces/SPACE

gdzie SPACE to identyfikator w nazwie zasobu zasobu spaces interfejsu Meet REST API. Więcej informacji znajdziesz w artykule Jak Meet identyfikuje pomieszczenie do spotkań.
Użytkownik //cloudidentity.googleapis.com/users/USER

gdzie USER to identyfikator w polu signedinUser.user zasobu participants interfejsu Meet REST API. Więcej informacji znajdziesz w artykule Praca z uczestnikami.

Subskrypcja otrzymuje zdarzenia dotyczące wszystkich miejsc spotkań, których użytkownik jest właścicielem. Zwykle właściciel miejsca spotkań jest też organizatorem wydarzenia w Kalendarzu Google powiązanego z tym miejscem.

Typy zdarzeń do tworzenia subskrypcji

Podczas tworzenia subskrypcji zasobu Meet używasz pola eventTypes[] do określania typów zdarzeń, które chcesz otrzymywać. Typy zdarzeń są sformatowane zgodnie ze specyfikacją CloudEvents, np. google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.

Jeśli na przykład chcesz otrzymywać zdarzenia dotyczące nowych uczestników konferencji w przestrzeni w Meet, określ 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 informacje o tym, które typy zdarzeń są obsługiwane w przypadku subskrypcji zasobów Meet:

Typ wydarzenia Format Dane zasobów
Rozpoczyna się konferencja w pokoju spotkań. google.workspace.meet.conference.v2.started conferenceRecord
Konferencja kończy się w przestrzeni spotkań. google.workspace.meet.conference.v2.ended conferenceRecord
Uczestnik dołącza do aktywnej konferencji w pokoju spotkań. google.workspace.meet.participant.v2.joined conferenceRecord.participantSession
Uczestnik opuści aktywne spotkanie w przestrzeni spotkania. google.workspace.meet.participant.v2.left conferenceRecord.participantSession
Nagrywanie rozpoczyna się w przypadku konferencji w pokoju spotkań. google.workspace.meet.recording.v2.started conferenceRecord.recording
Nagrywanie konferencji w przestrzeni spotkania zostanie zakończone. google.workspace.meet.recording.v2.ended conferenceRecord.recording
W przestrzeni spotkań generowany jest plik nagrania konferencji. google.workspace.meet.recording.v2.fileGenerated conferenceRecord.recording
W pokoju spotkania rozpoczyna się transkrypcja konferencji. google.workspace.meet.transcript.v2.started conferenceRecord.transcript
Transkrypcja kończy się w przypadku konferencji w przestrzeni spotkania. google.workspace.meet.transcript.v2.ended conferenceRecord.transcript
W przestrzeni spotkania generowany jest plik transkrypcji konferencji. google.workspace.meet.transcript.v2.fileGenerated conferenceRecord.transcript

Dane zdarzenia

W tej sekcji opisujemy dane zdarzeń i przykładowe ładunki zdarzeń w przestrzeniach spotkań w Meet.

Gdy subskrypcja Google Workspace otrzyma zdarzenie z Meet, pole data zawiera ładunek zdarzenia. Ten ładunek zawiera informacje o zmienionym zasobie Google Workspace. Jeśli na przykład subskrybujesz zdarzenia dotyczące nowych transkrypcji w przestrzeni, ładunek tych zdarzeń zawiera informacje o zasobie transcripts, który uległ zmianie.

Dane zasobu w ładunku zdarzenia

W tabeli poniżej znajdziesz przykłady ładunków JSON w przypadku subskrypcji miejsca spotkań w Meet. W przykładach używany jest identyfikator rekordu konferencji (np. conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) do identyfikowania miejsca spotkań. Więcej informacji znajdziesz w artykule Jak Meet identyfikuje pomieszczenie do spotkań.

W przypadku każdego zdarzenia, które otrzymuje subskrypcja, ładunek pojawia się w polu datazdarzenia:

Przykład Typ wydarzenia Ładunek JSON

Konferencja rozpoczyna się lub kończy w przestrzeni spotkań Meet.
  • google.workspace.meet.conference.v2.started
  • google.workspace.meet.conference.v2.ended

Wyklucza dane o zasobach:

{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
Uczestnik dołącza do konferencji w przestrzeni spotkania Meet lub ją opuszcza.
  • google.workspace.meet.participant.v2.joined
  • google.workspace.meet.participant.v2.left

Wyklucza dane o zasobach:

{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
Nagrywanie rozpoczyna się lub kończy albo generowany jest plik dotyczący konferencji w pokoju spotkań Meet.
  • google.workspace.meet.recording.v2.started
  • google.workspace.meet.recording.v2.ended
  • google.workspace.meet.recording.v2.fileGenerated

Wyklucza dane o zasobach:

{
    "recording":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
Transkrypcja rozpoczyna się, kończy lub generowany jest plik dla konferencji w pokoju spotkań Meet.
  • google.workspace.meet.transcript.v2.started
  • google.workspace.meet.transcript.v2.ended
  • google.workspace.meet.transcript.v2.fileGenerated

Wyklucza dane o zasobach:

{
    "transcript":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
    }
}

Ograniczenia
  • Goście zaproszeni do Kalendarza i inni uczestnicy rozmowy mogą otrzymywać tylko te zdarzenia: google.workspace.meet.conference.v2.started i google.workspace.meet.transcript.v2.fileGenerated.