На этой странице описываются события Google Meet, на которые ваше приложение может подписаться с помощью API Google Workspace Events. После того, как вы определитесь, какие типы событий вам нужны, создайте подписку , чтобы начать получать события от Meet.
Дополнительную информацию о разработке приложений для Meet см. в обзоре Google Meet REST API .
Поддерживаемые мероприятия Meet
Подписки Google Workspace позволяют получать события о следующих типах изменений в Meet:
- Конференция начинается или заканчивается в конференц-зале.
- Участник присоединяется к конференции или покидает ее.
- Для конференции создается запись .
- Для конференции создается стенограмма .
Ресурсы, за которыми вы можете следить на предмет событий
Для получения событий вы указываете ресурс Meet для мониторинга, который называется целевым ресурсом подписки.
API Google Workspace Events поддерживает следующие целевые ресурсы для Meet:
| Целевой ресурс | Формат | Ограничения (если применимо) |
|---|---|---|
| Место для встреч | //meet.googleapis.com/spaces/ SPACE где SPACE — это идентификатор в имени ресурса ресурса | |
| Пользователь | //cloudidentity.googleapis.com/users/ USER где USER — это идентификатор в поле | Подписка получает события о конференц-залах, где пользователь является одним из следующих:
|
Типы событий для создания подписок
При создании подписки на ресурс 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. Например, если вы подписались на события о новых расшифровках в пространстве, полезная нагрузка для этих событий содержит информацию об измененном ресурсе transcript .
Данные о ресурсах в полезной нагрузке события
В следующей таблице приведены примеры полезных нагрузок JSON для подписки на пространство для встреч Meet. В примерах используется конференция conferenceRecords/AAA-BBB-CCC-DDD-EEE которая происходит в пространстве. Для каждого события, которое получает подписка, полезная нагрузка отображается в поле data события:
| Пример | Тип события | Полезная нагрузка JSON |
|---|---|---|
Начинается конференция в конференц-зале Meet. | | Исключает данные о ресурсах:
{
"conferenceRecord":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
}
}
|
| Участник присоединяется к конференции в конференц-зале Meet. | | Исключает данные о ресурсах:
{
"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"
}
}
|