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

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

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

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

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

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

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

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

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

Где SPACE — это идентификатор в имени ресурса space REST API Meet. Подробнее см. в статье «Как Meet определяет пространство для встречи» .

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

Где USER — это идентификатор в поле signedinUser.user ресурса participant 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.fileGenerated

 Для конференции в конференц-зале создается файл записи.

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

 Для конференции в конференц-зале создается файл стенограммы.

conferenceRecord.transcript

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

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

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

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

В следующей таблице приведены примеры полезных данных JSON для подписки на конференц-площадку Meet. В этих примерах для идентификации площадки используется идентификатор записи конференции (например, conferenceRecords/AAA-BBB-CCC-DDD-EEE ). Подробнее см. в статье «Как 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"
    }
}