На этой странице объясняется, как использовать SDK Google Workspace Marketplace для настройки и управления вашим приложением в Google Workspace Marketplace.
Чтобы сделать ваше приложение доступным для использования, вам необходимо настроить его в SDK Google Workspace Marketplace. SDK Google Workspace Marketplace – это набор инструментов, который позволяет создавать и контролировать свое приложение в Google Workspace Marketplace. Вы используете SDK Google Workspace Marketplace для управления такими настройками Marketplace, как:
- Доступно ли ваше приложение для конкретной организации Google Workspace ( частное приложение) или для всех пользователей Marketplace ( публичное приложение).
- Типы пользователей Marketplace, которые могут установить ваше приложение
- С какими приложениями Google Workspace интегрируется ваше приложение?
- Области OAuth, необходимые вашему приложению
- Информация о том, кто создал и поддерживает приложение.
Независимо от того, публикуете ли вы свое приложение публично или конфиденциально, вы должны использовать SDK Google Workspace Marketplace для управления своим приложением в Marketplace.
Включите SDK Google Workspace Marketplace.
Если вы еще этого не сделали, в своем проекте Google Cloud включите SDK Google Workspace Marketplace :
- Откройте консоль Google Cloud .
- Вверху нажмите «Выбрать проект» . Если другой проект Google Cloud уже открыт, щелкните имя проекта Cloud, чтобы переключиться на проекты Cloud.
- Выберите облачный проект вашего приложения и нажмите «Открыть» .
- Вверху в строке поиска введите
Google Workspace Marketplace SDKи нажмите Enter. Откройте страницу SDK Google Workspace Marketplace.
Если SDK Google Workspace Marketplace еще не включен, нажмите «Включить» .
Введите настройки приложения в SDK Google Workspace Marketplace.
- Откройте SDK Google Workspace Marketplace .
- Перейдите на вкладку «Конфигурация приложения» .
- Заполните каждый раздел информацией о вашем приложении. Дополнительные сведения о каждом параметре см. в следующем разделе «Параметры конфигурации приложения ».
- Нажмите Сохранить .
- (Необязательно) Вы можете получить аналитику об использовании приложений в Google Analytics . Для этого добавьте идентификатор Google Analytics в SDK Google Workspace Marketplace.
- Перейдите на вкладку Аналитика .
- Введите свой идентификатор Google Analytics.
- Нажмите Сохранить .
Параметры конфигурации приложения
В следующей ссылке описаны настройки, доступные на странице «Конфигурация приложения» SDK Google Workspace Marketplace.
Видимость приложения
Вы видите опцию «Видимость приложения» , если используете учетную запись Google Workspace (учетную запись, созданную вашей рабочей или учебной организацией). Если вы используете потребительскую учетную запись (учетную запись, оканчивающуюся на «@gmail.com»), вы можете публиковать только публично.
- Общедоступно : приложение могут найти и установить люди за пределами вашего домена. Если вы выберете общедоступный доступ, Google просматривает и одобряет список вашего приложения перед его публикацией.
- Частное : только люди в вашем домене могут найти и установить ваше приложение.
Если вы решите опубликовать как «Не в списке» , список приложений не будет отображаться в результатах просмотра или поиска. Пользователи могут получить доступ к странице приложения в магазине только по прямому URL-адресу.
Если вы хотите ограничить список стран и регионов, в которых будет доступно ваше приложение, это можно настроить в разделе «Распространение» при создании страницы приложения в магазине .
Настройки установки
Настройки установки определяют, смогут ли пользователи или администраторы Workspace устанавливать ваше приложение со страницы вашего приложения в Google Workspace Marketplace.
- Индивидуальная + администраторская установка (по умолчанию) . Приложение может быть установлено отдельными пользователями или администраторами своего домена, организационного подразделения или группы пользователей. Политики домена пользователя могут помешать ему установить приложение, даже если включены отдельные установки.
- Установка только администратором : приложение могут установить только администраторы своего домена, организационного подразделения или группы пользователей. Ваше приложение отображается в результатах поиска Google Workspace Marketplace только для администраторов и людей, которые не вошли в свою учетную запись Google. Выберите этот вариант, если ваше приложение требует установки домена.
Интеграция приложений
Выберите сервисы Google Workspace, для работы с которыми предназначено ваше приложение или надстройка, например надстройку Google Workspace или приложение Google Chat. Вы должны выбрать хотя бы один вариант. В некоторых случаях вы можете включить в список приложений несколько интеграций приложений. См. раздел Список интеграций приложений вместе .
В зависимости от того, какую интеграцию приложений вы выберете, вам может потребоваться предоставить дополнительную информацию и включить соответствующие API в вашем проекте Google Cloud. В следующей таблице описаны дополнительные настройки, необходимые для каждого из них:
Дополнение Google Workspace (скрипт приложений)
Чтобы опубликовать надстройку Google Workspace, вам необходимо предоставить идентификатор развертывания надстройки. Чтобы найти идентификатор развертывания, выполните следующие действия:
- Откройте надстройку Google Workspace в редакторе скриптов Apps.
- Нажмите «Развертывание» > «Управление развертываниями» .
- Под идентификатором развертывания нажмите «Копировать» .
Дополнение Google Workspace (альтернативная среда выполнения)
Если вы создали надстройку Google Workspace на языке программирования, отличном от Google Apps Script, выполните следующие действия, чтобы получить идентификатор развертывания из ресурса развертывания Google Cloud.
- На странице конфигурации приложения в разделе «Дополнение Google Workspace» нажмите «Развернуть с использованием ресурса облачного развертывания» > «Выбрать развертывание» .
- Выберите развертывание, которое хотите опубликовать.
- Нажмите «Выбрать» .
Надстройка редактора (документы, таблицы, слайды, формы)
Чтобы опубликовать надстройку редактора, вы должны предоставить идентификатор сценария проекта и версию, которую вы хотите опубликовать.
Чтобы найти идентификатор сценария проекта, выполните следующие действия:
- Откройте дополнение в редакторе Apps Script.
- Слева нажмите параметров проекта .
- В разделе «Идентификаторы» скопируйте идентификатор сценария.
Чтобы найти версию, выполните следующие действия:
- Откройте дополнение в редакторе Apps Script.
- В правом верхнем углу нажмите «Развертывание» > «Управление развертываниями» .
- Номер версии находится в разделе «Конфигурация».
Приложение Google Чат
Чтобы опубликовать приложение Google Chat, необходимо настроить API Google Chat. См. Публикация приложений .
Приложение Диска
Чтобы опубликовать приложение Диска, необходимо включить и настроить Drive API .
Веб-приложение
Чтобы опубликовать веб-приложение, необходимо предоставить его универсальный URL-адрес навигации — URL-адрес, который указывает на веб-приложение из меню Google. Ваше веб-приложение должно быть запущено и полностью функционально.
При заполнении страницы со списком магазинов вы должны предоставить дополнительные значки размером 96x96 и 48x48 пикселей.
Если вы создали свое веб-приложение с помощью Apps Script, чтобы получить универсальный URL-адрес навигации, выполните следующие действия:
- Откройте надстройку Google Workspace в редакторе скриптов Apps.
- Нажмите «Развертывание» > «Новое развертывание» .
- В разделе «Выберите тип» нажмите Веб-приложение .
- Заполните параметры и нажмите «Развернуть» .
- Нажмите «Копировать» .
Области действия OAuth
Предоставьте полный список областей действия OAuth, которые требуются вашему приложению. Введенные здесь области действия OAuth должны соответствовать тому, что отображается на экране согласия OAuth и, если применимо, в манифесте Apps Script.
Если вы включаете несколько интеграций приложений, обязательно добавьте области действия каждого из них на страницу конфигурации приложения SDK Google Workspace Marketplace и экран согласия OAuth.
Всегда используйте максимально узкую область действия (например, не включайте полную область действия Диска, если вам нужна область только для чтения).
Дополнительные сведения о проектах Apps Script см. в разделе Области действия .
Информация о разработчике
Эти поля появятся на странице списка вашего приложения в магазине .
| Поля | |
|---|---|
| Статус трейдера | В соответствии с законами о защите прав потребителей потребители, проживающие в Европейской экономической зоне (ЕЭЗ), должны быть проинформированы о том, является ли продавец на Google Workspace Marketplace торговцем или неторговцем :
Если он не указан, на странице списка вашего приложения в магазине появится надпись «Статус трейдера не указан». |
| Почтовый адрес разработчика | Требуется для трейдеров. Не собираются для неторговцев. Местоположение вашего бизнеса. Введите действительный почтовый адрес, по которому с вами можно связаться. |
| Имя разработчика | Имя, которое будет отображаться как автор приложения. Если вы трейдер, укажите свое торговое или юридическое название. |
| URL-адрес веб-сайта разработчика | Веб-сайт, на котором вы (или ваша организация) описаны как разработчик. |
| Электронная почта разработчика | Адрес электронной почты, который будет использоваться в качестве контактного лица. Его нет в списке вашего приложения. Убедитесь, что этот адрес электронной почты постоянно обновляется — он используется:
|
| URL-адрес веб-сайта приложения | Необязательный. Веб-сайт, на котором дополнительно описывается ваше приложение. |