Обзор REST API Google Meet

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

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

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

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

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

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

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

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

  • После конференции : заберите артефакты конференции, такие как запись и транскрипцию.

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

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

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

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

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

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

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

Вы также можете интегрировать в своё приложение другие API Google Workspace, например, API чата, чтобы вывести совместную работу на новый уровень. Подробнее см. в разделе «Варианты использования чата» .

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

Ниже приведен список общих терминов, используемых в этом API:

Артефакт
Файл, создаваемый Meet в ответ на конференцию , например, recordings и transcripts . Обычно артефакт готов к загрузке вскоре после окончания конференции.
Календарь событий
Мероприятие в Google Календаре с несколькими участниками, обычно создаваемое организатором встречи , содержащее информацию о присоединении к встрече. Meet может быть решением для проведения конференций в этом случае.
Вызов
Сеанс с использованием Meet или для уведомления других о начале или ходе звонка с предоставлением им возможности немедленно присоединиться к нему.
Конференция
Конференция — это случай звонка в рамках конференц-зала . Пользователи обычно рассматривают этот сценарий как отдельную встречу.
Соведущий
Участник вызова , которому хост предоставил привилегии управления хостом, за исключением возможности удалить исходного хоста.
Хозяин
Лицо, создавшее звонок ( организатор встречи ), или лицо, управляющее звонком. Обратите внимание, что организатор встречи может организовать встречу, но не присутствовать при её проведении. Организатор также может делегировать полномочия организатора соорганизатору .
Код встречи

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

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

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

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

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

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

Место для встреч

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

URI встречи

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

Участник

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

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

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