Обзор процесса

В этом руководстве описан процесс проверки дополнений для Classroom. Внимательно прочтите его, так как некоторые действия, требующие немедленного выполнения, являются срочными.

Key Point: Thoroughly review the items in this guide before publishing your add-on .

Ваше дополнение должно пройти проверку OAuth командой Trust & Safety и быть одобрено командой Google Workspace Marketplace. Общую информацию о проверке OAuth см. в разделе часто задаваемых вопросов о проверке OAuth . Общую информацию о процессе проверки приложений в Google Workspace Marketplace см. в разделе «О проверке приложений» .

Завершить разработку дополнения.

Проверьте требования к дополнительным модулям.

Убедитесь, что поведение вашего дополнения соответствует требованиям .

Протестируйте свой аддон

Ваше дополнение проверяется в соответствии с процедурами, описанными в нашем плане тестирования дополнений . Перед отправкой на публикацию следуйте этим процедурам тестирования вашего общедоступного дополнения. Неудачи в этих тестах могут значительно увеличить время, необходимое для утверждения вашего дополнения.

Важный момент: План тестирования дополнений содержит те же тесты, которые использует команда проверки Google Workspace Marketplace. Вам следует заранее проверить, что ваше дополнение демонстрирует ожидаемое поведение во всех применимых тестах.

Запишите демонстрационное видео

Создайте запись экрана, демонстрирующую, как ваше приложение использует каждый запрошенный диапазон OAuth. Для целей разработки дополнения мы рекомендуем показать процесс установки дополнения и создания вложения к нему.

После записи загрузите видео с экрана на YouTube как видео, не включенное в общий доступ . Доступ к такому видео возможен только по ссылке. Вам будет предложено ввести ссылку на видео при начале процесса проверки OAuth. Затем команда OAuth просмотрит видео при проверке вашего приложения.

Подготовка к публикации

Проверьте конфигурацию вашего облачного проекта.

Review each of the following configuration settings in your Google Cloud project .

Внимание: При проверке этих параметров конфигурации убедитесь, что в верхней части консоли Google Cloud выбран правильный проект Cloud.

• На странице «Аутентификация аудитории» вашего облачного проекта:
  • Статус публикации: В процессе производства .
  • Тип пользователя — Внешний .
• На странице «Брендирование аутентификации» вашего облачного проекта:
  • Все обязательные поля заполнены.
  • Убедитесь, что главная страница вашего приложения не содержит ссылку на само приложение, а ведет к информации о вашем продукте (продуктах).
• На странице «Доступ к данным аутентификации» вашего облачного проекта:
  • Указана как минимум одна из неконфиденциальных областей действия .../auth/userinfo.email или .../auth/userinfo.profile .
  • Все остальные области действия, необходимые для вашего дополнения, указаны. Для дополнений Classroom это должно включать конфиденциальные области действия .../auth/classroom.addons.teacher и .../auth/classroom.addons.student .
  • В поле «Демонстрационное видео» необходимо указать ссылку на видео на YouTube, демонстрирующее использование данных из запрошенных областей видимости. Предоставьте ссылку на видеозапись экрана, сделанную ранее.
• Включены следующие библиотеки API :
  • API Google Classroom
  • Google Workspace Marketplace SDK

Проверьте настройки вашего Marketplace SDK.

Внимание: При проверке этих параметров конфигурации убедитесь, что в верхней части страницы консоли Google Cloud выбран правильный проект Cloud.

На странице конфигурации приложения Google Workspace Marketplace SDK :

• Дополнение «Классная комната» отмечено в разделе «Интеграция приложений».
• URI для перехода на вашу дополнительную страницу указывается в поле "URI настройки вложения" .
• Предоставлены все допустимые префиксы URI для вложений .
• Список областей действия OAuth точно соответствует областям действия, указанным на экране согласия OAuth и в коде вашего приложения.
• Адрес электронной почты разработчика, указанный в разделе «Ссылки для разработчиков», регулярно проверяется . Команда Marketplace использует этот адрес для связи с вами.
• Для приложения установлен параметр «Видимость приложения» на «Общедоступное» , и отмечен флажок «Не указано» .

Убедитесь, что страница вашего проекта в магазине Google Workspace Marketplace соответствует требованиям к размещению информации .

Предоставить доступ рецензенту

Предоставьте доступ к вашему приложению следующим учетным записям пользователей из команды проверки Marketplace. Также добавьте двух пользователей-преподавателей в качестве тестировщиков черновиков для вашего дополнительного приложения.

• [e-mail]
• [e-mail]
• [e-mail]
• [e-mail]

Вы получите электронное письмо от команды Marketplace, когда они начнут проверку. Если для использования этих учетных записей с вашим продуктом проверяющим потребуется выполнить какие-либо действия по настройке, ответьте на письмо с подробными инструкциями.

Важно: Рецензенты могут подключаться к вашему приложению из Аргентины, Канады и США. Убедитесь, что эти регионы не заблокированы в вашей реализации и разрешены в разделе «Распространение» на странице « Список SDK в магазине Marketplace». Вы можете изменить конфигурацию распространения после одобрения вашего дополнения.

Завершите проверку OAuth.

Отправить на проверку

Команда Trust & Safety должна убедиться, что ваше дополнение корректно использует области действия OAuth, запрашиваемые вашим приложением. Инициируйте проверку из Центра проверки аутентификации вашего проекта Google Cloud. Нажмите «Подготовить к проверке» .

В диалоговом окне подтверждения отображаются настроенные значения со страниц «Аутентификация», «Аудитория» и «Доступ к данным». Убедитесь в правильности информации, затем нажмите «Подтвердить» , чтобы продолжить.

Свяжитесь с группой проверки.

Команда проверки OAuth обрабатывает ваш запрос на проверку. Специалисты свяжутся с вами по адресам электронной почты, указанным на экране согласия OAuth. Они сообщат вам о любых проблемах и о завершении проверки.

Этот процесс обычно занимает 3-5 рабочих дней, если вы используете только конфиденциальные области аутентификации OAuth . Если вы используете какие-либо ограниченные области аутентификации OAuth , может потребоваться дополнительное время и действия.

Полный обзор Google Workspace Marketplace

Отправить на рассмотрение

Совет: Вы можете одновременно подать заявку на проверку на торговой площадке и на верификацию OAuth. Однако ваша заявка должна пройти верификацию OAuth, прежде чем она получит окончательное одобрение на торговой площадке.

Нажмите кнопку «ОПУБЛИКОВАТЬ» внизу страницы вашего проекта Google Cloud в магазине Google Workspace Marketplace . Команда проверки Marketplace протестирует дополнение на соответствие требованиям к дополнениям Google Workspace и Classroom.

Свяжитесь с группой рецензентов.

Команда проверки Marketplace связывается напрямую с адресом электронной почты разработчика, указанным на странице конфигурации приложения Google Workspace Marketplace SDK. Вы будете уведомлены о любых проблемах с вашим дополнением или о том, что оно одобрено для публикации. Мы рекомендуем заложить на этот процесс 2-3 недели.

После получения разрешения на публикацию

После одобрения на Marketplace ваше дополнение станет доступно во всех доменах Google Workspace for Education в выбранных вами регионах. Снимите флажок «Не указано» в настройках приложения Marketplace SDK, чтобы ваше дополнение отображалось в результатах поиска и при просмотре.