Обзор 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 символов для пространства собрания, используемая в URL-адресе присоединения к пространству собрания. Например, abc-mnop-xyz . Коды встреч не следует хранить в течение длительного времени, так как они могут оторваться от места встречи и в будущем могут быть повторно использованы для разных мест встреч. Как правило, срок действия кодов встреч истекает через 365 дней после последнего использования. Дополнительную информацию см. в статье «Информация о кодах встреч в Google Meet» .
Название встречи
Уникальный идентификатор, сгенерированный сервером, используемый для идентификации места встречи . Идентификатор собрания возвращается в поле name ресурса spaces .
Организатор встречи
Пользователь, создавший пространство встречи . Этот пользователь также может считаться владельцем собрания. Он может отсутствовать во время разговора или быть организатором собрания. Организатор встречи может быть только один.
Место для встреч
Виртуальное место или постоянный объект (например, конференц-зал), где проводится конференция . В одном пространстве одновременно можно проводить только одну активную конференцию. Пространство для встреч также помогает пользователям встречаться и находить общие ресурсы.
Участник
Человек, присоединившийся к вызову или использующий режим Companion , наблюдающий в качестве зрителя, или устройство в комнате, подключенное к вызову. Для каждого человека имеется один ресурс conferenceRecords.participants . Когда участник присоединяется к конференции , ему присваивается уникальный идентификатор.
Участник сессии
Уникальный идентификатор сеанса, созданный для каждой пары участник-устройство, которая присоединяется к вызову . Для каждого сеанса существует один ресурс conferenceRecords.participants.participantSessions . Если участник присоединяется к одному и тому же вызову несколько раз с одной и той же пары участник-устройство, каждому из них присваиваются уникальные идентификаторы сеанса.

Информация об авторизации и аутентификации, специфичная для API

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

API REST Meet поддерживает следующие области действия OAuth 2.0:

Код области действия Описание Применение
https://www.googleapis.com/auth/meetings.space.readonly Разрешите приложениям считывать метаданные о любом пространстве для встреч, к которому у пользователя есть доступ. Чувствительный
https://www.googleapis.com/auth/meetings.space.created Разрешите приложениям создавать, изменять и читать метаданные о пространствах для встреч, созданных вашим приложением. Чувствительный
https://www.googleapis.com/auth/drive.readonly Разрешить приложениям загружать файлы записей и расшифровок из Google Drive API. Ограниченный

Дополнительную информацию о конкретных областях действия OAuth 2.0 см. в разделе «Области действия OAuth 2.0 для API Google» .