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

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

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

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

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

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

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

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

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

Пример того, как новое место для встреч инициирует событие.
Рисунок 1. Пользователь создаёт пространство для встреч, что создаёт ресурс Space . Затем 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 в справочной документации.

Пример: получение событий об участниках в месте проведения встречи

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

Подписаться на события

Для получения событий в режиме реального времени приложение Meet вызывает метод subscriptions.create API Google Workspace Events, чтобы подписаться на конференц-пространство для всех типов событий. После создания подписки приложение Meet может начать получать события.

Приложение Meet, которое подписывается на мероприятия для участников, используя API Google Workspace Events.
Рисунок 2. Приложение Meet получает мероприятия для участников через подписку с использованием API Google Workspace Events.

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

Информацию о создании подписок с помощью API Google Workspace Events см. в документации по API Google Workspace Events .

Запрос последних событий

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

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

На рисунке 3 приложение Meet вызывает метод conferenceRecords.participants.participantSessions.list API Meet REST после завершения всех действий участников сеанса. API Meet REST возвращает список ресурсов ParticipantSession , представляющих каждое из изменений. Затем приложение Meet может обрабатывать данные или реагировать на них, например, создавая список участников, присоединившихся к конференции и покинувших её.

Чтобы запросить события с помощью API REST Meet, см. раздел Список всех сеансов участников .

Ограничения

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