Подпишитесь на мероприятия Google Meet

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

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

Чтобы узнать больше о разработке приложений для Meet, ознакомьтесь с обзором REST API Google Meet .

Мероприятия Supported Meet

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

• Конференция начинается или заканчивается в месте проведения собрания.
• Участник присоединяется к конференции или покидает её.
• Запись конференции начинается, заканчивается или создается файл.
• В умной заметке начинается, заканчивается запись или создается файл для конференции. science предварительная версия для разработчиков)
• В стенограмме конференции начинается, заканчивается запись или создается файл.

Ресурсы, за которыми вы можете следить на предмет событий.

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

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

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

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

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

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

данные о событии

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

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

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

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

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

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

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

Связанные темы

• Обзор API событий Google Workspace
• Структура событий Google Workspace
• Выберите области действия API событий Google Workspace.
• Обзор REST API Google Meet
• Выберите области действия REST API Google Meet.
• Учебное пособие: Отслеживание событий совещания с помощью Python и REST API Google Meet.