Реагируйте на события из 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 влияет на связанный ресурс REST API Meet, а также на тип события, которое получает ваше приложение Meet:

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

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

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

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

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

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

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

Пример: Получение информации об участниках совещания.

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

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

Для получения событий в режиме реального времени приложение 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, см. документацию по API событий Google Workspace .

Запрос информации о последних событиях

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

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

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

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

Ограничения

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