Обзор 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 REST Meet для выполнения следующих задач:

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

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

  • После конференции : получение артефактов конференции, таких как запись и транскрипция.

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

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

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

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

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

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

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

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

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

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

Артефакт
Файл, созданный Meet в ответ на конференцию , например записи и стенограммы . Обычно артефакт готов к получению вскоре после окончания конференции.
Событие календаря
Мероприятие в Календаре 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 , наблюдающий в качестве зрителя, или устройство в комнате, подключенное к вызову. Для каждого человека имеется один ресурс conferenceRecords.participants . Когда участник присоединяется к конференции , ему присваивается уникальный идентификатор.

Участник сессии

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