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

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

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

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

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

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

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

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

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

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

где SPACE — это идентификатор в имени ресурса spaces REST API Meet. Подробнее см. раздел «Как Meet идентифицирует пространство для совещаний» .

Пользователь //cloudidentity.googleapis.com/users/ USER

где USER — это идентификатор из поля signedinUser.user ресурса participants REST API Meet. Подробнее см. раздел «Работа с участниками» .

Подписка позволяет получать события обо всех конференц-залах, владельцем которых является пользователь. Как правило, владелец конференц-зала также является организатором события в 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 .