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 typów zdarzeń, których 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 wydarzeniach, które mogły Ci umknąć w ramach subskrypcji z powodu awarii. 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 dla konferencji.
• Inteligentna notatka rozpoczyna się, kończy lub generowany jest plik dla konferencji. science Wersja przedpremierowa dla programistów
• 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:

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.

Aby na przykład 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:

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 będzie zawierać ładunek zdarzenia. Ten ładunek zawiera informacje o zmienionym zasobie Google Workspace. Jeśli na przykład subskrybujesz wydarzenia dotyczące nowych transkrypcji w pokoju, ładunek tych wydarzeń 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 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 do Kalendarza i inni uczestnicy rozmowy mogą otrzymywać tylko te wydarzenia: 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 wydarzeń Google Workspace
• Wybieranie zakresów interfejsu Google Workspace Events API
• Omówienie interfejsu Google Meet REST API
• Wybieranie zakresów interfejsu Google Meet REST API
• Samouczek: obserwowanie zdarzeń związanych ze spotkaniami za pomocą Pythona i interfejsu Google Meet REST API