Обзор REST API Google Meet

REST API Google Meet позволяет создавать и управлять встречами в Google Meet, а также предоставляет пользователям возможность прямого доступа к вашим встречам из вашего приложения.

С помощью REST API Meet вы можете делать следующее:

  • Создавайте и настраивайте переговорные комнаты для связи пользователей по видеосвязи.
  • Предварительно настройте уровни доступа к пространству, параметры модерации и автоматическую запись или расшифровку.
  • Управляйте участниками совещания и распределяйте роли между соорганизаторами.
  • Завершите активную конференцию программным способом в пределах переговорной комнаты.
  • Получите записи о конференции, сведения о посещаемости и метаданные об участниках сессий.
  • Получите доступ к материалам совещания (записям, стенограммам и записям в стенограммах).

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

Варианты использования

Приложения могут интегрироваться с REST API Meet для выполнения следующих задач:

  • Перед конференцией : создайте конференц-залы по запросу, предварительно настройте ограничения доступа (открытый, доверенный или ограниченный), примените средства модерации (демонстрация экрана, чат, реакции, микрофон и камера), настройте автоматическую запись или автоматическую транскрипцию и назначьте участникам конференц-зала роли соорганизаторов.

  • Во время конференции : получайте метаданные активной конференции и информацию о сессиях участников, динамически управляйте участниками, отслеживайте события жизненного цикла в режиме реального времени с помощью API событий Google Workspace или программно завершайте активную конференцию.

  • После конференции : получите доступ к записям конференции и журналам посещаемости, загрузите записи и стенограммы Google Docs из Google Drive, а также получите доступ к подробным стенограммам выступлений для обучения, обеспечения соответствия требованиям или анализа с помощью ИИ.

Вот несколько примеров того, для чего вам может понадобиться использовать Meet REST API:

  • Продажи и управление клиентскими счетами

    • Получение информации о встрече и участниках для целей учета.
    • Получить материалы совещания и внести их в учетные записи.
    • Обрабатывайте расшифровки и аудиозаписи с помощью моделей искусственного интеллекта для создания аналитических данных об эффективности коучинга и продаж.

  • Обучение и развитие

    • Создавайте и предварительно настраивайте встречи для обучения.
    • Распределите роли соведущих между тренерами и руководителями сессий.
    • Предоставьте студентам доступ к записям, позволяющим повторно просмотреть материалы после окончания курса.

  • Поддержка клиентов и консультации

    • Создавайте защищенные, закрытые переговорные комнаты непосредственно из заявок в службу поддержки или клиентских порталов.
    • Настройте управление хостом таким образом, чтобы только агенты службы поддержки могли представлять информацию или управлять посещаемостью.
    • Включите автоматическую запись или транскрипцию для обеспечения качества и соответствия требованиям.
    • Программно завершать активные конференции по завершении встреч или сеансов поддержки.

  • операции разработчиков

    • Создавайте совещания для мгновенного объединения коллег по команде.
    • Предоставьте другим заинтересованным сторонам возможность присоединиться к текущим совещаниям, обмениваясь информацией о совещаниях и участниках в режиме реального времени.
    • Обработайте данные транскрипции с помощью моделей искусственного интеллекта, чтобы определить правильные дальнейшие шаги.
Создавайте и участвуйте в динамичных встречах с коллегами в чате.
Рисунок 1. Создайте и присоединитесь к динамической встрече с коллегами в чате.

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

Общие термины

Ниже приведён список часто используемых терминов в этом API:

Активная конференция
Текущая конференция, проходящая в конференц-зале . В конференц-зале одновременно может проводиться только одна активная конференция. После завершения она становится записью из истории конференции .
Артефакт
Файл, созданный Meet в ответ на конференцию , например, recordings или transcripts . Артефакты сохраняются на Google Диск организатора встречи . Обычно они готовы к загрузке вскоре после окончания конференции.
Событие в календаре
Событие в Google Календаре с несколькими участниками, обычно созданное организатором встречи , содержащее информацию для подключения к встрече. Для проведения такого мероприятия может использоваться Meet.
Вызов
Использование Meet для проведения сессии или для уведомления других участников о начале или ходе звонка и предоставления им возможности немедленно присоединиться.
Соведущий
Участник звонка , которому хост предоставил права управления хостом, за исключением возможности удалить исходного хоста.
Конференция
Конференция — это звонок , совершаемый в рамках переговорного пространства . Пользователи обычно рассматривают этот сценарий как отдельную встречу.
Результаты конференции
Для каждого экземпляра конференции используется уникальный идентификатор. Он создается автоматически при начале конференции. Ресурс conferenceRecords использует формат conferenceRecords/{conferenceRecord} . Например, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ .
Наберите номер
Использовать телефон для участия в телефонном разговоре или для прослушивания транслируемого разговора.
Хозяин
Человек, создавший звонок ( организатор встречи ), или человек, управляющий звонком. Следует отметить, что организатор встречи может организовывать встречу, но не присутствовать на ней. Организатор также может делегировать права организатора соорганизатору .
код встречи

Уникальная 10-символьная строка, которую можно ввести для обозначения места проведения совещания, используемая в URI этого места. Регистр не имеет значения. Например, abc-mnop-xyz . Максимальная длина — 128 символов.

Коды для совещаний не следует хранить длительное время, так как они могут отсоединиться от места проведения совещания и быть использованы повторно для других мест проведения совещаний в будущем. Как правило, срок действия кодов для совещаний истекает через 365 дней после последнего использования. Для получения дополнительной информации см. раздел «Узнайте больше о кодах для совещаний в Google Meet» .

Название встречи

Уникальный идентификатор, сгенерированный сервером, используется для идентификации переговорной комнаты . Он чувствителен к регистру. Например, jQCFfuBOdN5z . Идентификатор встречи возвращается в поле name ресурса spaces . Для получения дополнительной информации см. раздел «Как Meet идентифицирует переговорную комнату» .

Организатор встречи

Пользователь, создавший пространство для совещания . Этот пользователь также может считаться владельцем совещания. Он может не присутствовать во время звонка или не быть организатором совещания. Организатором совещания может быть только один человек.

Место для проведения встреч

Виртуальное пространство или постоянно существующий объект (например, переговорная комната), где проводится конференция . В одном пространстве одновременно может проводиться только одна активная конференция. Пространство для встреч также помогает пользователям встречаться и находить общие ресурсы.

URI встречи

Кликабельная ссылка, которая запускает или присоединяет пользователя к звонку . Каждый звонок имеет уникальный URL-адрес, состоящий из https://meet.google.com/ , за которым следует код встречи . Например, https://meet.google.com/abc-mnop-xyz .

Член

Пользователь, явно добавленный в пространство для совещаний с назначенной ролью (например, COHOST ). В отличие от участника , который присутствует только во время прямой трансляции конференции , участник связан с постоянным пространством для совещаний и сохраняет свои привилегии в нескольких конференциях в этом пространстве.

Участник

Участник, подключившийся к звонку или использующий режим «Сопровождение» , наблюдающий за происходящим в качестве зрителя, или устройство, подключенное к звонку, — для каждого participants предусмотрен отдельный ресурс. При подключении участника к конференции ему присваивается уникальный идентификатор.

Сессия участников

Для каждой пары участник-устройство, присоединяющегося к вызову , создается уникальный идентификатор сессии. Для каждой сессии существует один ресурс participantSessions . Если участник присоединяется к одному и тому же вызову несколько раз с одной и той же пары участник-устройство, каждому из них присваивается уникальный идентификатор сессии.

Запись

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

SIP-адрес

Адрес протокола SIP (Session Initiation Protocol ) описывает, как стороннее оборудование для видеоконференций может найти конференцию Meet и присоединиться к ней. Meet поддерживает схему URI SIP .

Стенограмма

Текстовый документ, содержащий запись устного разговора с конференции , экспортированный в Google Диск организатора встречи в виде файла Docs.

Запись в транскрипте

Отдельный фрагмент расшифрованной речи участника конференции . Каждая запись содержит идентификационные данные участника, временную метку, текст речи и языковой код, и доступна в течение 30 дней после окончания конференции.