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

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

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

Подробнее о разработке приложений для Meet см. в обзоре API REST Google Meet .

Поддерживаемые мероприятия 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.meet.conference.v2.started conferenceRecord
Конференция заканчивается в конференц-зале. google.meet.conference.v2.ended conferenceRecord
Участник присоединяется к активной конференции в конференц-зале. google.meet.participant.v2.joined conferenceRecord.participantSession
Участник покидает активную конференцию в конференц-зале. google.meet.participant.v2.left conferenceRecord.participantSession
Для конференции в конференц-зале создается файл записи. google.meet.recording.v2.fileGenerated conferenceRecord.recording
Для конференции в конференц-зале создается файл стенограммы. google.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

Исключает данные о ресурсах 
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
Участник присоединяется к конференции в конференц-зале Meet.

google.workspace.meet.participant.v2.joined

Исключает данные о ресурсах 
{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
Запись создается для конференции в конференц-зале Meet. google.workspace.meet.recording.v2.fileGenerated
Исключает данные о ресурсах 
{
    "recording":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
Стенограмма создается для конференции в конференц-зале Meet. 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 .