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

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

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

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

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

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

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

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

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

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

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

где USER — это идентификатор в поле signedinUser.user ресурса participant 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.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 которая проходит в пространстве. Для каждого события, которое получает подписка, полезные данные отображаются в поле data события:

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

Конференция начнется в конференц-зале Meet.

google.workspace.meet.conference.v2.started

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

google.workspace.meet.participant.v2.joined

Исключает данные ресурсов
{
    "participantSession":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/participants/FFF-GGG-HHH-III-JJJ/participantSessions/LLL-MMM-NNN-OOO-PPP"
    }
}
Для конференции в конференц-зале Meet создается запись. google.workspace.meet.recording.v2.fileGenerated
Исключает данные ресурсов
{
    "recording":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP"
    }
}
Стенограмма конференции создается в конференц-зале Meet. google.workspace.meet.transcript.v2.fileGenerated
Исключает данные ресурсов
{
    "transcript":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT"
    }
}