Обзор REST API Google Meet

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

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

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

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

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

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

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

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

  • После конференции : получите материалы конференции, такие как запись и стенограмма.

Вот несколько примеров того, для чего вам может понадобиться использовать 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 .

Участник

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

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

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

SIP-адрес

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