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