На этой странице объясняется, как использовать 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.
Выберите, кто может просматривать и устанавливать ваше приложение
При настройке приложения вы указываете пользователей, которые могут получить доступ к вашему приложению, используя следующие настройки:
- Видимость приложения . Если вы публикуете приложение в организации Google Workspace, независимо от того, находится ли ваше приложение в списке, оно видно всем пользователям в вашей организации или всем, кто использует Google Workspace.
- Настройки установки . Могут ли приложение устанавливать только администраторы Google Workspace.
Независимо от настроек, которые вы указываете в списке своего приложения, пользователи, принадлежащие к организации Google Workspace, могут не иметь возможности находить, устанавливать или использовать ваше приложение из-за настроек, установленных их администраторами. Администраторы могут влиять на доступность вашего приложения следующими способами:
- Контролируйте, могут ли их пользователи просматривать приложения в Marketplace и устанавливать приложения от имени своих пользователей.
- Используйте белый список для управления и курирования приложений для своей организации. Если вы разрабатываете приложение для организации, которая использует белые списки, посоветуйтесь с администратором о добавлении приложения в белый список.
- Отключите определенные приложения Google Workspace, например запрет доступа к Google Chat, приложениям Google Chat или к тому и другому. В этих случаях пользователи не смогут установить ваше приложение из Marketplace.
Чтобы узнать, как администраторы управляют доступом к Marketplace, см. справочную документацию администратора Marketplace.
Настройки видимости приложения
Вы видите опцию «Видимость приложения» , если используете учетную запись Google Workspace (учетную запись, созданную вашей рабочей или учебной организацией). Если вы используете потребительскую учетную запись (учетную запись, оканчивающуюся на «@gmail.com»), вы можете публиковать только публично.
- Общедоступно : приложение могут найти и установить люди за пределами вашего домена. Если вы выберете общедоступный доступ, Google просматривает и одобряет список вашего приложения перед его публикацией.
- Частное : только люди в вашем домене могут найти и установить ваше приложение.
Если вы решите опубликовать приложение как «Не в списке» , список приложений не будет отображаться в результатах просмотра или поиска. Пользователи могут получить доступ к странице приложения в магазине только по прямому URL-адресу.
Если вы хотите ограничить список стран и регионов, в которых будет доступно ваше приложение, это можно настроить в разделе «Распространение» при создании страницы приложения в магазине .
Настройки установки приложения
Настройки установки определяют, смогут ли пользователи или администраторы Workspace устанавливать ваше приложение со страницы вашего приложения в Google Workspace Marketplace.
- Индивидуальная + администраторская установка (по умолчанию) . Приложение может быть установлено отдельными пользователями или администраторами своего домена, организационного подразделения или группы пользователей. Политики домена пользователя могут помешать ему установить приложение, даже если включены отдельные установки.
- Установка только администратором : приложение могут установить только администраторы своего домена, организационного подразделения или группы пользователей. Ваше приложение отображается в результатах поиска Google Workspace Marketplace только для администраторов и людей, которые не вошли в свою учетную запись Google. Выберите этот вариант, если ваше приложение требует установки домена.
Общие настройки установки и видимости
В следующей таблице приведены некоторые распространенные параметры конфигурации приложений для установки и видимости:
Предполагаемые пользователи приложения | Настройка видимости приложения | Настройка установки приложения | Кто может установить мое приложение? | Кто может использовать мое приложение? | |
---|---|---|---|---|---|
Для приложений, созданных для организации Google Workspace | |||||
Конкретные пользователи в вашей организации | Частный и незарегистрированный | Индивидуальная + административная установка | Если разрешено, любой в вашей организации, у которого есть URL-адрес списка приложений. | Если разрешено, любой в вашей организации, у которого есть URL-адрес списка приложений. | |
Ваша организация | Частный | Индивидуальная + административная установка | Если разрешено, любой из вашей организации. | Если разрешено, любой из вашей организации. | |
Ваша организация | Частный | Только администратор | Администраторы | Пользователи, у которых приложение установлено администратором. | |
Для приложений, доступных пользователям за пределами конкретной организации Google Workspace. | |||||
Пользователи в организациях Google Workspace | Общественный | Только администратор | Администраторы | Пользователи, у которых приложение установлено администратором. | |
Все пользователи Google Workspace | Общественный | Индивидуальная + административная установка |
|
|
Определите, как ваше приложение интегрируется с приложениями Google Workspace.
Выберите сервисы 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-адрес веб-сайта приложения | Необязательный. Веб-сайт, на котором дополнительно описывается ваше приложение. |
Сохраните настройки конфигурации приложения в SDK Google Workspace Marketplace.
Используя информацию из предыдущего раздела , сохраните конфигурацию приложения в SDK Google Workspace Marketplace:
- Откройте SDK Google Workspace Marketplace .
- Перейдите на вкладку «Конфигурация приложения» .
- Заполните каждый раздел на основе того, что вы определили в предыдущем разделе .
- Нажмите Сохранить .
- (Необязательно) Вы можете получить аналитику об использовании приложений в Google Analytics . Для этого добавьте идентификатор Google Analytics в SDK Google Workspace Marketplace.
- Перейдите на вкладку Аналитика .
- Введите свой идентификатор Google Analytics.
- Нажмите Сохранить .