Как подписаться на события Google Meet

В этом документе описаны события Meet, на которые ваше приложение может подписаться с помощью Google Workspace Events API. Решив, какие типы событий вам нужны, создайте подписку, чтобы начать получать события из Meet.

Помимо подписки на события, вы также можете запрашивать события, вызывая Google Meet REST API. Вызовите Meet REST API, чтобы периодически получать события или узнавать о событиях, которые вы могли пропустить из-за сбоя. Чтобы узнать, как получать события Meet и отвечать на них, ознакомьтесь со статьей Как отвечать на события из Google Meet в документации Meet.

Подробнее о разработке приложений для Meet…

Поддерживаемые события Meet

Подписки Google Workspace позволяют получать события о следующих типах изменений в Meet:

  • Конференция начинается или заканчивается в переговорной комнате.
  • Участник присоединяется к видеовстрече или покидает ее.
  • Запись начинается, заканчивается или создается файл для видеовстречи.
  • Начало или завершение умных заметок или создание файла для видеовстречи.
  • Расшифровка начинается, заканчивается или для нее создается файл.

Ресурсы, для которых можно отслеживать события

Чтобы получать события, укажите ресурс Meet, который нужно отслеживать. Он называется целевым ресурсом подписки.

Google Workspace Events API поддерживает следующие целевые ресурсы для Meet:

Целевой ресурс Формат Ограничения (если применимо)
Чат-группа встречи //meet.googleapis.com/spaces/SPACE

где SPACE – идентификатор в названии ресурса ресурса spaces Meet REST API. Подробнее о том, как Meet идентифицирует переговорную комнату…
Пользователь //cloudidentity.googleapis.com/users/USER

где USER – идентификатор в поле signedinUser.user ресурса participants Meet REST API. Подробнее о работе с участниками…

Подписка получает события обо всех переговорных комнатах, владельцем которых является пользователь. Обычно владелец переговорной комнаты также является организатором мероприятия в Google Календаре, связанного с этой комнатой.

Типы событий для создания подписок

При создании подписки на ресурс Meet используйте поле eventTypes[], чтобы указать, какие типы событий вы хотите получать. Типы событий форматируются в соответствии со спецификацией CloudEvents, например google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.

Например, чтобы получать события о новых участниках конференции в чат-группе Meet, укажите тип события google.workspace.meet.participant.v2.joined. Подробнее о том, как работают события, рассказывается в статье Структура событий Google Workspace.

В таблице ниже показано, какие типы событий поддерживаются для подписок на ресурсы Meet.

Тип события Формат Данные ресурса
В переговорной комнате начинается конференция. google.workspace.meet.conference.v2.started conferenceRecord
Встреча в переговорной комнате завершается. google.workspace.meet.conference.v2.ended conferenceRecord
Участник присоединяется к активной видеовстрече в переговорной комнате. google.workspace.meet.participant.v2.joined conferenceRecord.participantSession
Участник покидает активную видеовстречу в переговорной комнате. google.workspace.meet.participant.v2.left conferenceRecord.participantSession
В переговорной комнате начинается запись видеовстречи. google.workspace.meet.recording.v2.started conferenceRecord.recording
Запись видеовстречи в переговорной комнате завершена. google.workspace.meet.recording.v2.ended conferenceRecord.recording
Для видеовстречи в переговорной комнате создается файл записи. google.workspace.meet.recording.v2.fileGenerated conferenceRecord.recording
В чат-группе встречи создается умная заметка для видеовстречи. google.workspace.meet.smartNote.v2.started conferenceRecord.smartNote
Умная заметка завершается для конференции в переговорной комнате. google.workspace.meet.smartNote.v2.ended conferenceRecord.smartNote
Для видеовстречи в переговорной комнате создается файл умных заметок. google.workspace.meet.smartNote.v2.fileGenerated conferenceRecord.smartNote
В переговорной комнате начинается расшифровка видеовстречи. google.workspace.meet.transcript.v2.started conferenceRecord.transcript
Расшифровка видеовстречи в переговорной комнате завершена. google.workspace.meet.transcript.v2.ended conferenceRecord.transcript
Для видеовстречи в переговорной комнате создается файл расшифровки. google.workspace.meet.transcript.v2.fileGenerated conferenceRecord.transcript

Данные события

В этом разделе описываются данные о событиях и примеры полезной нагрузки для событий в переговорных комнатах Meet.

Когда ваша подписка Google Workspace получает событие от Meet, поле data содержит полезную нагрузку для события. В этих полезных данных содержится информация об измененном ресурсе Google Workspace. Например, если вы подписались на события о новых расшифровках в чат-группе, полезная нагрузка для этих событий содержит информацию об изменившемся ресурсе transcripts.

Данные ресурса в полезной нагрузке события

В таблице ниже приведены примеры полезной нагрузки JSON для подписки на встречу Meet. В примерах для идентификации чат-группы встречи используется идентификатор записи видеовстречи (например, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ). Подробнее о том, как Meet идентифицирует переговорную комнату…

Для каждого события, полученного подпиской, полезная нагрузка отображается в поле data события:

Типы событий Полезная нагрузка JSON

Встреча в Meet начинается или заканчивается.

  • google.workspace.meet.conference.v2.started
  • google.workspace.meet.conference.v2.ended

Исключает данные ресурсов:

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

Участник присоединяется к видеовстрече в переговорной комнате Meet или покидает ее.

  • google.workspace.meet.participant.v2.joined
  • google.workspace.meet.participant.v2.left

Исключает данные ресурсов:

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

Запись начинается, заканчивается или создается файл для видеовстречи в переговорной комнате Meet.

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

Исключает данные ресурсов:

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

Умная заметка начинается, заканчивается или создается файл для конференции в переговорной комнате Meet.

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

Исключает данные ресурсов:

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

Расшифровка начинается, заканчивается или создается файл для видеовстречи в Meet.

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

Исключает данные ресурсов:

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

Ограничения
  • Приглашенные в Календаре и другие участники, приглашенные на видеовстречу, могут получать только следующие события: google.workspace.meet.conference.v2.started и google.workspace.meet.transcript.v2.fileGenerated.