Реагируйте на события из Google Meet

В этом документе объясняется, как получать и отвечать на события Google Meet из Google Cloud Pub/Sub.

Событие Meet представляет собой действие или изменение ресурса Meet, например, создание новой встречи. Вы можете использовать события, чтобы понять, что произошло, и предпринять какие-либо действия, или чтобы отреагировать на них содержательно для своих пользователей.

Вот несколько примеров того, как можно использовать события:

  • Наблюдайте и реагируйте на изменения в ходе совещания, например, когда оно начинается или заканчивается.

  • Отслеживайте, кто присутствовал на встрече в нормативных или учебных целях.

  • Прослушайте стенограмму встречи, чтобы можно было проанализировать содержимое файла и занести его в CRM или базу данных.

Как работают события

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

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

В следующем примере показано, как действие в Meet влияет на связанный ресурс API REST Meet, а также тип события, которое получает ваше приложение Meet:

Активность Знакомьтесь с ресурсом REST API Тип события
Пользователь присоединяется к месту встречи. Создан ресурс ConferenceRecord . Новый рекорд конференции

Получать данные о событиях из Google Meet

Чтобы получить данные о событиях, ваше приложение может выполнить одно из следующих действий:

В следующей таблице поясняются различия и причины подписки на события по сравнению с их запросом:

Подписаться на события Запрос данных
Варианты использования
  • Обрабатывайте события или реагируйте на них в режиме реального времени.
  • Отслеживайте изменения в ресурсах, чтобы улучшить производительность вашего приложения.
  • Извлеките данные вручную.
  • Извлечь все данные из Meet (из-за сбоя или неактивной подписки).
API API событий Google Workspace Знакомьтесь с REST API
Источник событий Запись конференции и пользователи Отчет о космосе и конференции
Поддерживаемые события Отчет конференции

Список поддерживаемых типов событий см. в разделе Типы событий для создания подписок в документации API событий Google Workspace.		 Отчет о космосе и конференции

Список поддерживаемых конечных точек см. в ресурсах Space и ConferenceRecord в документации Meet REST API.
Формат мероприятия Сообщение Google Cloud Pub/Sub, отформатированное в соответствии со спецификацией CloudEvent. Подробнее см. в разделе Структура событий Google Workspace . Ресурс API Meet REST ( Space и ConferenceRecord )
Данные о событиях Строка в кодировке Base64 с данными о ресурсах или без них. Примеры полезных нагрузок см. в разделе «Данные событий» . Полезная нагрузка JSON, содержащая данные о ресурсах. Пример полезной нагрузки см. в ресурсе ConferenceRecord в справочной документации.

Ограничения

  • Приглашенные в календаре и другие участники, приглашенные на конференцию, могут получать только следующие события: google.workspace.meet.conference.v2.started и google.workspace.meet.transcript.v2.fileGenerated .