Развертывание дополнения Meet

Дополнения для Google Meet создаются и настраиваются в рамках проекта Google Cloud.

Создайте проект в Google Cloud.

Чтобы создать проект Google Cloud, см. раздел «Создание проекта Google Cloud» .

Включите SDK Google Workspace Marketplace и API дополнений Google Workspace.

Для разработки дополнений для Meet необходимы Marketplace SDK и API дополнений Google Workspace. Чтобы их включить:

  1. Откройте консоль Google Cloud .
  2. Вверху, если уже открыт другой проект, выберите название проекта вашего приложения, чтобы переключиться между проектами.
  3. В верхней части страницы в строке поиска введите Google Workspace Marketplace SDK и нажмите Enter.
  4. Откройте страницу Google Workspace Marketplace SDK и нажмите «Включить» .

  5. Повторите эти шаги, чтобы найти и включить Google Workspace add-ons API .

Создайте развертывание

Для использования дополнения в Meet вам потребуется развертывание и файл манифеста дополнения .

  1. Откройте консоль Google Cloud .
  2. Вверху, если уже открыт другой проект, выберите название проекта вашего приложения, чтобы переключиться между проектами.
  3. Нажмите «API и сервисы» .
  4. Выберите Google Workspace Marketplace SDK , чтобы просмотреть страницу с подробной информацией.

Создайте развертывание.

Вы можете создать развертывание непосредственно в консоли Google Cloud, создав HTTP-развертывание (рекомендуется), или используя Google Apps Script.

HTTP-развертывание

  1. Перейдите на вкладку «Развертывания HTTP» .
  2. Нажмите «Создать новое развертывание» и введите идентификатор развертывания дополнения.

    Идентификатор развертывания — это произвольная строка, которая помогает разработчику дополнения идентифицировать развертывание, содержащее манифест дополнения. Идентификаторы развертывания являются обязательными и могут содержать не более 100 символов.

  3. Нажмите «Далее» .

    Открывается боковая панель, в которой вы можете отправить спецификацию манифеста дополнения в формате JSON. Этот файл также называется DEPLOYMENT.JSON.

    Файл манифеста дополнения является центральным элементом конфигурации дополнения Google Meet. В следующем примере кода показаны доступные поля Meet для веб-версии в файле манифеста дополнения.

    {
      "addOns": {
        "common": {
          "name": "NAME",
          "logoUrl": "LOGO_URL"
        },
        "meet": {
          "web": {
            "sidePanelUrl": "SIDE_PANEL_URL",
            "supportsScreenSharing": SUPPORTS_SCREENSHARING,
            "addOnOrigins": ["ADD_ON_ORIGINS"],
            "logoUrl": "MEET_WEB_LOGO_URL",
            "darkModeLogoUrl": "DARK_MODE_LOGO_URL"
          }
        }
      }
    }
    

    Замените следующее:

    • NAME : Строка. Название вашего дополнения для Google Meet.
    • LOGO_URL : Строка. URL-адрес логотипа для дополнения Google Workspace. Используется для этого дополнения во всех продуктах Google Workspace.
    • SIDE_PANEL_URL : Строка. URL-адрес точки входа вашего дополнительного приложения. Он отображается в iframe внутри боковой панели . Источник этого URL-адреса должен входить в число источников, указанных в поле ADD_ON_ORIGINS .
    • SUPPORTS_SCREENSHARING : Необязательный параметр. Логическое значение. Если установлено значение false, пользователи должны использовать дополнение, чтобы видеть, что происходит в сеансе совместной работы с дополнением. Если установлено значение true, инициатор сеанса совместной работы с дополнением может демонстрировать свой экран, отображая содержимое дополнения.
    • ADD_ON_ORIGINS : Список строк. Список источников , где размещено ваше дополнение. Два URL-адреса имеют один и тот же источник, если они используют одну и ту же схему, хост и порт. Допускаются также подисточники, а также поддомены с подстановочными знаками. Для получения дополнительной информации см. раздел «Безопасность дополнений» .
    • MEET_WEB_LOGO_URL : Необязательный параметр. Строка. URL-адрес логотипа для дополнения, специфичный для Meet. Этот логотип используется во всем Meet. Если он отсутствует, используется logoUrl из общего раздела. Рекомендации по разработке логотипов см. в разделе «Рекомендации» .
    • DARK_MODE_LOGO_URL : Строка. URL-адрес логотипа дополнения, специфичный для темного режима. Предоставление логотипа для темного режима гарантирует, что ваше дополнение будет наилучшим образом выглядеть в любой теме Meet. Рекомендации по дизайну логотипов см. в разделе «Рекомендации» .
  4. Нажмите «Отправить» .

    Для получения дополнительной информации о развертывании см. раздел «Создание ресурса развертывания» .

  5. На вкладке «Конфигурация приложения» в разделе «Интеграция приложения» выберите надстройку Google Workspace . Выберите «Развернуть с использованием ресурса облачного развертывания» , а затем выберите правильный HTTP-метод развертывания.

Google Apps Script

  1. Перейдите на вкладку «Настройки приложения» .

  2. В разделе «Интеграция приложений» выберите надстройку Google Workspace . Выберите «Развернуть с помощью идентификатора развертывания Google Apps Script» и введите идентификатор развертывания вашего скрипта.

  3. Нажмите « Сохранить ».

    Подробную информацию о создании проекта Apps Script см. в документации Apps Script . Дополнение Meet использует исключительно файл манифеста appsscript.json, также называемый манифестом проекта Apps Script . Убедитесь, что файл манифеста в вашем проекте Apps Script содержит разделы addOns и meet .

    Приведённый ниже пример кода демонстрирует доступные поля Meet в файле манифеста дополнения.

    {
      "addOns": {
        "common": {
          "name": "NAME",
          "logoUrl": "LOGO_URL"
        },
        "meet": {
          "web": {
            "sidePanelUrl": "SIDE_PANEL_URL",
            "supportsScreenSharing": SUPPORTS_SCREENSHARING,
            "addOnOrigins": ["ADD_ON_ORIGINS"],
            "logoUrl": "MEET_WEB_LOGO_URL",
            "darkModeLogoUrl": "DARK_MODE_LOGO_URL"
          }
        }
      }
    }
    

    Замените следующее:

    • NAME : Строка. Название вашего дополнения для Google Meet.
    • LOGO_URL : Строка. URL-адрес логотипа для дополнения Google Workspace. Используется для этого дополнения во всех продуктах Google Workspace.
    • SIDE_PANEL_URL : Строка. URL-адрес точки входа вашего дополнительного приложения. Он отображается в iframe внутри боковой панели . Источник этого URL-адреса должен входить в число источников, указанных в поле ADD_ON_ORIGINS .
    • SUPPORTS_SCREENSHARING : Необязательный параметр. Логическое значение. Если установлено значение false, пользователи должны использовать дополнение, чтобы видеть, что происходит в сеансе совместной работы с дополнением. Если установлено значение true, инициатор сеанса совместной работы с дополнением может демонстрировать свой экран, отображая содержимое дополнения.
    • ADD_ON_ORIGINS : Список строк. Список источников , где размещено ваше дополнение. Два URL-адреса имеют один и тот же источник, если они используют одну и ту же схему, хост и порт. Допускаются также подисточники, а также поддомены с подстановочными знаками. Для получения дополнительной информации см. раздел «Безопасность дополнений» .
    • MEET_WEB_LOGO_URL : Необязательный параметр. Строка. URL-адрес логотипа для дополнения, специфичный для Meet. Этот логотип используется во всем Meet. Если он отсутствует, используется logoUrl из общего раздела. Рекомендации по разработке логотипов см. в разделе «Рекомендации» .
    • DARK_MODE_LOGO_URL : Строка. URL-адрес логотипа дополнения, специфичный для темного режима. Предоставление логотипа для темного режима гарантирует, что ваше дополнение будет наилучшим образом выглядеть в любой теме Meet. Рекомендации по дизайну логотипов см. в разделе «Рекомендации» .

Установите и протестируйте дополнение в Meet.

Чтобы протестировать дополнение в Meet, необходимо сначала установить его для вошедшего в систему пользователя:

HTTP-развертывание

  1. Перейдите в консоль Google Cloud, чтобы найти SDK Google Workspace Marketplace для вашего проекта .
  2. Перейдите на вкладку «Развертывания HTTP» .
  3. В столбце «Действия» нажмите «Установить» .

Google Apps Script

  1. Чтобы установить неопубликованное дополнение, следуйте инструкциям в документации по надстройке Google Workspace.

Теперь вы сможете использовать свой надстройку в совещании. Чтобы попробовать, начните совещание на meet.google.com . Установленная надстройка теперь отображается на панели «Действия».

Помимо установки дополнения для отдельного вошедшего в систему пользователя, вы также можете его опубликовать . Публикуя дополнение для Google Workspace, вы делаете его доступным для поиска, установки и использования другими пользователями.