Subskrybowanie wydarzeń w Google Meet

W tym dokumencie znajdziesz opis zdarzeń w 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 zdarzeń możesz też wysyłać zapytania o zdarzenia, wywołując interfejs Google Meet REST API. Wywołuj interfejs API typu REST Meet, aby okresowo pobierać zdarzenia lub nadrabiać zaległości w zdarzeniach, które mogły Ci umknąć z subskrypcji z powodu przerwy w działaniu usługi. Więcej informacji o tym, jak otrzymywać wydarzenia w Meet i na nie odpowiadać, znajdziesz w artykule Odpowiadanie na wydarzenia w Meet w dokumentacji Meet.

Więcej informacji o tworzeniu aplikacji na potrzeby Meet znajdziesz w artykule Omówienie interfejsu 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.
  • Transkrypcja rozpoczyna się, kończy lub generowany jest plik dla konferencji.

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 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ż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 spotkań, 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
Rozmowa konferencyjna rozpoczyna się 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 kończy się. 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 spotkań rozpoczyna się inteligentna notatka dotycząca konferencji. google.workspace.meet.smartNote.v2.started conferenceRecord.smartNote
Inteligentna notatka kończy się w przypadku konferencji w przestrzeni spotkań. google.workspace.meet.smartNote.v2.ended conferenceRecord.smartNote
Dla konferencji w sali konferencyjnej generowany jest plik z inteligentnymi notatkami. google.workspace.meet.smartNote.v2.fileGenerated conferenceRecord.smartNote
W pokoju spotkań 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 przypadku konferencji w przestrzeni spotkań generowany jest plik transkrypcji. 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 abonament 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 zdarzenia dotyczące nowych transkrypcji w pokoju, ł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 data zdarzenia:

Typy zdarzeń Ładunek JSON

Konferencja rozpoczyna się lub kończy w sali 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 lub ją opuszcza w przestrzeni spotkania Meet.

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

Inteligentna notatka rozpoczyna się, kończy lub generowany jest plik dotyczący konferencji w przestrzeni spotkania Meet.

  • google.workspace.meet.smartNote.v2.started
  • google.workspace.meet.smartNote.v2.ended
  • google.workspace.meet.smartNote.v2.fileGenerated

Wyklucza dane o zasobach:

{
  "smartNote":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/smartNotes/SMART_NOTE_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
  • 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.