Обзор мест для встреч Google Meet

REST API Google Meet иллюстрация

В этом руководстве объясняется, как REST API Google Meet позволяет создавать и управлять встречами в Google Meet.

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

Для работы с конференц-залами см. раздел «Создание и управление конференц-залами» . Чтобы узнать, как программно настроить конференц-зал, см. раздел «Настройка конференц-залов и участников» .

Как вызвать место для проведения встречи

В таблице ниже подробно описаны роли, необходимые для использования методов организации переговорных комнат:

Метод Владельцы Участники Другие
endActiveConference х
get х х х
с настройками х
с активной конференцией х х
patch х

Как Meet определяет место для проведения встречи

REST API Google Meet генерирует ресурс spaces для каждого конференц-зала. Ресурс spaces предоставляет несколько точек входа для присоединения к конференции.

В таблице ниже показано, как найти и подключиться к конференц-залу:

Название поля Описание
name Название пространства. Строка {space} — это идентификатор ресурса для пространства, имеющий формат spaces/{space} . Это уникальный идентификатор, генерируемый сервером, и он чувствителен к регистру. Например, spaces/jQCFfuBOdN5z .
meetingCode Псевдоним для имени пространства. {meetingCode} — это уникальная строка символов, которую можно ввести, и она не чувствительна к регистру. Она имеет формат spaces/{meetingCode} . Например, spaces/abc-mnop-xyz . Максимальная длина — 128 символов. Она является частью meetingUri : https://meet.google.com/abc-mnop-xyz .
phoneAccess Методы доступа по телефону к данному конференц-залу. Объект phoneAccess содержит информацию, необходимую для подключения к конференции по телефону, включая региональные телефонные номера конференц-зала и PIN-код, специфичный для этого номера. PIN-код состоит только из десятичных цифр, и его длина может варьироваться. Например, "pin": 19707127300 .

Аналогично пользовательскому интерфейсу Meet, ресурс spaces включает ограниченный набор телефонных номеров для подключения. Дополнительные телефонные номера для места проведения совещания можно увидеть, добавив {meetingCode} к следующему URL-адресу: https://meet.google.com/tel/ . Например, https://meet.google.com/tel/abc-mnop-xyz .
gatewaySipAccess Методы доступа по протоколу SIP (Session Initiation Protocol) для этого конференц-зала. SIP-адрес указывает, как стороннее оборудование для видеоконференций может найти конференцию Meet и присоединиться к ней. Объект gatewaySipAccess содержит URI и числовой код доступа. Meet поддерживает схему URI SIP .

Для управления переговорной комнатой используйте следующие значения в поле name :

Жизненный цикл конференц-зала

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

Жизненный цикл конференц-зала.
Рисунок 1. Жизненный цикл конференц-зала.

  1. Вызовите spaces.create . Создается пространство для совещания, и возвращаемый объект spaces содержит строку meetingUri . Затем meetingUri распределяется между участниками.

  2. Опросите новое место проведения совещания . Вызовите метод spaces.get , чтобы проверить состояние конференции.

    Вместо опросов вы также можете подписаться на мероприятия Meet , чтобы получать push-уведомления.

  3. Начать конференцию . Когда первый участник щелкнет meetingUri в пространстве совещания, конференция начнется. Объект activeConference заполняется, и устанавливается строка activeConference.conferenceRecord .

  4. (Необязательно) Получение данных о конференции . Во время активной конференции вы можете получить доступ к некоторым значениям conferenceRecord . Например, вызовите метод conferenceRecords.participants.list , чтобы увидеть всех участников конференции. Вы также можете получить доступ к этой информации в течение 30 дней после конференции.

  5. (Необязательно) Завершить конференцию . Во время конференции владелец собрания может вызвать метод spaces.endActiveConference , чтобы программно завершить активную конференцию для всех участников.

  6. Конференция завершается . Когда последний участник покинет конференцию, она заканчивается.

  7. Опрос на наличие артефактов после конференции . Конференция завершилась ( STATE=ENDED ), но артефакты еще не сгенерированы. Время startTime и endTime конференции также заполнены. Необходимо опрашивать конечную точку артефактов до тех пор, пока в объекте артефакта STATE не будет отображаться FILE_GENERATED .

    Вместо опросов вы можете подписаться на события Meet, чтобы получать push-уведомления.

  8. Получение артефактов после конференции . Вы можете получить такие артефакты, как записи и стенограммы, после их создания. Например, вызовите метод conferenceRecords.recordings.get , чтобы получить запись по идентификатору записи.

    После завершения процесса заполняется URI объекта артефакта, который возвращается как часть объекта ресурса.