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

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

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

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

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

Для разработки дополнений Meet требуются Google Workspace 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": {         "sidePanelUri": "SIDE_PANEL_URI",         "addOnOrigins": ["ADD_ON_ORIGINS"],         "darkModeLogoUrl": "DARK_MODE_LOGO_URL",         "logoUrl": "MEET_WEB_LOGO_URL",         "supportsScreenSharing": SUPPORTS_SCREENSHARING       }     }   } } 

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

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

    Дополнительную информацию о развертываниях см. в разделе Создание ресурса развертывания .

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

Скрипт Google Apps

  1. Откройте вкладку «Конфигурация приложения» .

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

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

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

    В отличие от других дополнений Google Workspace, дополнения Meet нельзя полностью реализовать с помощью Apps Script. Вместо этого необходимо создать полноценное веб-приложение, создав боковую панель и главную сцену . URL-адрес боковой панели вашего веб-приложения необходимо указать в параметре SIDE_PANEL_URI файла манифеста appsscript.json.

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

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

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

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

Скрипт Google Apps

  1. Инструкции по установке неопубликованного дополнения см. в документации по дополнению Google Workspace.

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

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

,

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

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

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

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

Для разработки дополнений Meet требуются Google Workspace 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": {         "sidePanelUri": "SIDE_PANEL_URI",         "addOnOrigins": ["ADD_ON_ORIGINS"],         "darkModeLogoUrl": "DARK_MODE_LOGO_URL",         "logoUrl": "MEET_WEB_LOGO_URL",         "supportsScreenSharing": SUPPORTS_SCREENSHARING       }     }   } } 

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

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

    Дополнительную информацию о развертываниях см. в разделе Создание ресурса развертывания .

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

Скрипт Google Apps

  1. Откройте вкладку «Конфигурация приложения» .

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

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

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

    В отличие от других дополнений Google Workspace, дополнения Meet нельзя полностью реализовать с помощью Apps Script. Вместо этого необходимо создать полноценное веб-приложение, создав боковую панель и главную сцену . URL-адрес боковой панели вашего веб-приложения необходимо указать в параметре SIDE_PANEL_URI файла манифеста appsscript.json.

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

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

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

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

Скрипт Google Apps

  1. Инструкции по установке неопубликованного дополнения см. в документации по дополнению Google Workspace.

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

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