Subskrybowanie wydarzeń w Google Meet

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

Oprócz subskrybowania zdarzeń możesz też wysyłać zapytania o zdarzenia, wywołując interfejs Google Meet REST API. wywoływać interfejs Meet REST API, aby okresowo pobierać zdarzenia lub nadrabiać zaległości w zdarzeniach, które mogły zostać pominięte w subskrypcji z powodu przerwy w działaniu usługi. Aby dowiedzieć się, jak otrzymywać zdarzenia z Meet i na nie odpowiadać, zapoznaj się z artykułem Odpowiadanie na zdarzenia z Google Meet w dokumentacji Meet.

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

Obsługiwane zdarzenia w Meet

Subskrypcje Google Workspace umożliwiają otrzymywanie zdarzeń dotyczących tych typów zmian w Meet:

• Rozmowa wideo rozpoczyna się lub kończy w pokoju spotkań.
• Uczestnik dołącza do konferencji lub ją opuszcza.
• Rozpoczyna się lub kończy nagrywanie albo zostaje wygenerowany plik konferencji.
• Inteligentna notatka rozpoczyna się lub kończy albo generowany jest plik dotyczący konferencji.
• Rozpoczyna się lub kończy transkrypcja albo generowany jest plik rozmowy wideo.

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

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

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

Typy zdarzeń do tworzenia subskrypcji

Podczas tworzenia subskrypcji zasobu Meet użyj pola eventTypes[], aby określić, jakie typy zdarzeń chcesz otrzymywać. Typy zdarzeń są sformatowane 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 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:

Dane zdarzenia

W tej sekcji opisano dane zdarzeń i przykładowe ładunki zdarzeń w pokojach spotkań w Meet.

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

Dane zasobu w ładunku zdarzenia

Tabela poniżej zawiera przykłady ładunków JSON dla subskrypcji pokoju spotkań w Meet. W przykładach użyto identyfikatora rekordu rozmowy wideo (np. conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) do zidentyfikowania miejsca spotkania. Więcej informacji znajdziesz w artykule Jak Meet identyfikuje pokój spotkań.

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

{
  "conferenceRecord":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID"
  }
}
      

{
  "participantSession":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
  }
}
      

{
  "recording":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
  }
}
      

{
  "smartNote":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/smartNotes/SMART_NOTE_ID"
  }
}
      

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

• Osoby zaproszone w Kalendarzu i inni uczestnicy zaproszeni na rozmowę wideo mogą otrzymywać tylko te zdarzenia: google.workspace.meet.conference.v2.started i google.workspace.meet.transcript.v2.fileGenerated.

Powiązane artykuły

• Omówienie interfejsu Google Workspace Events API
• Struktura zdarzeń Google Workspace
• Wybieranie zakresów interfejsu Google Workspace Events API
• Omówienie interfejsu Google Meet REST API
• Wybieranie zakresów interfejsu Meet REST API
• Samouczek: obserwowanie zdarzeń spotkań za pomocą Pythona i interfejsu Google Meet REST API