Процесс проверки приложения и требования для Google Workspace Marketplace

Чтобы опубликовать приложение для публичного доступа в Google Workspace Marketplace, Google проверяет ваше приложение и его список, чтобы убедиться, что они соответствуют рекомендациям Google по дизайну, содержанию и стилю.

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

  • Если ваше приложение требует дополнительной доработки : вы получаете документ проверки с конкретной информацией о том, что нуждается в улучшении. Устраните проблемы и повторно отправьте приложение на проверку.
  • Если группа проверки одобряет ваше приложение : оно автоматически публикуется, и вы получаете уведомление по электронной почте.

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

Продолжительность проверки

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

  • Сколько приложений было отправлено недавно
  • Сколько дополнительной работы требуется вашему приложению

Распространенные причины, по которым приложение не проходит проверку

Проверка OAuth:

  • Неправильно настроен экран согласия OAuth. Например, для типа пользователя установлено значение «Внутренний» или для статуса публикации установлено значение «Тестирование» .

  • Приложение не завершило проверку OAuth.

Проблемы со списком приложений:

  • Ненадлежащее использование товарных знаков Google в названии, логотипе и описаниях приложений. Инструкции можно найти в рекомендациях по брендингу Google Workspace Marketplace .

  • Ссылки не работают или указывают на неверную информацию. Например, ссылка на политику конфиденциальности ведет на страницу поддержки разработчиков.

  • Скриншоты и изображения низкого качества или неточно отражают возможности приложения.

Готовность приложения:

  • Приложение все еще тестируется и не готово для публичного использования.
  • В приложении есть ошибки или оно не полностью функционально.

Критерии обзора

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

Требования ко всем приложениям

Вы можете использовать флажки для отслеживания вашего предварительного обзора.

Категория Критерии
Название приложения
  • Других приложений с таким названием нет.
  • Имя не включает номер версии.
  • Имя соответствует имени на экране согласия OAuth.
  • Название не расплывчатое и не слишком общее.
  • Имя содержит 50 символов или меньше.
  • ( Рекомендуется ) В имени используется регистр заголовков.
  • ( Рекомендуется ) В имени нет знаков препинания, особенно круглых скобок.
  • ( Рекомендуется ) Имя соответствует имени, отображаемому в приложениях Google Workspace. Например, в надстройках Google Workspace имя в манифесте похоже на имя, указанное в списке приложения.
Информация о разработчике
  • Имя разработчика и веб-сайт разработчика точно представляют и направляют соответствующую информацию о разработчике.
  • В соответствии с законами о защите прав потребителей потребители, проживающие в Европейской экономической зоне (ЕЭЗ), должны быть проинформированы о том, является ли продавец на Google Workspace Marketplace торговцем или неторговцем :
    • Трейдер . Торговец — это человек, который действует в целях, связанных с торговлей, бизнесом, ремеслом или профессией; или от имени или по поручению трейдера.
    • Неторговец — Неторговец (потребитель) — лицо, действующее в непрофессиональных целях.

    Если он не указан, на странице списка вашего приложения в магазине появится надпись «Статус трейдера не указан».

Описание приложения
  • Все предоставленные ссылки работают и указывают на правильную информацию. Например, ссылка на политику конфиденциальности указывает на страницу с описанием политики конфиденциальности.
  • Если приложение взаимодействует со сторонней службой, в описании описывается, что делает сторонняя служба, как приложение с ней взаимодействует, а также, при необходимости, ссылка на соответствующий веб-сайт.
  • Краткое и подробное описание понятно.
  • Краткое и подробное описания не идентичны.
  • ( Рекомендуется ) Информация о ценах является полной и точной.
  • ( Рекомендуется ) Полный набор атрибутов для каждого языка (имя, краткое и подробное описание) определен правильно, без несоответствия языка.
Функциональность
  • Явных ошибок нет, все действия, включая крайние случаи, полностью работоспособны. Время загрузки контролируется с помощью индикаторов загрузки.
  • Приложение демонстрирует четкое взаимодействие с API Google.
  • Приложение предоставляет новые или расширенные функции, которые не эквивалентны тем, что уже включены в продукты Google.
  • Приложение не предназначено для рекламы или рассылки спама.
  • Приложение полностью функционально и не предназначено для тестирования — оно не находится в стадии разработки.
  • Если приложение взаимодействует с функциями, доступными пользователям или платным пользователям, тестовая учетная запись в системе разработчика предоставляется группе проверки Google.
Пользовательский опыт
  • Приложение, включая его название, не использует ресурсы бренда Google, товарные знаки или контент под брендом Google. См. рекомендации по брендингу Google Workspace Marketplace .
  • Авторизация и вход в систему требуются только один раз. Приложение использует единый вход одним щелчком мыши или, в идеале, единый вход без щелчка.
  • После того как администратор предоставляет разрешения для областей OAuth 2.0 для домена, отдельным пользователям больше не запрашиваются разрешения области.
  • Пользователям не нужно вводить учетные данные после входа в свою учетную запись Google. В лучшем случае им нужно нажать кнопку «Войти через Google», чтобы получить доступ.
  • Существуют последовательные, очевидные и понятные термины для надписей кнопок, пунктов меню, заголовков и других элементов приложения. Например, вместо «Да» или «Нет» метки относятся к именам действий, например «Удалить» и «Отмена».
  • Если требуется вход в систему, функция выхода работает правильно. Токены аннулируются, и вход в систему можно начать с самого начала.
  • Для действий всегда отображается обратная связь, например сообщения о подтверждении или ошибке.
  • Нет неработающих ссылок на изображения или нечетких изображений.
Графика
  • Иконки правильного размера, квадратные и имеют прозрачный фон. См. Графические ресурсы .
  • Значок правильно отображает название или функциональные возможности приложения.
  • Значок цветной (не серый).
  • Значок не использует товарные знаки Google.
  • Скриншоты и изображения не являются размытыми, трудно читаемыми или неуместными. Они точно представляют приложение.
  • ( Рекомендуется ) На скриншотах четко показано, как использовать приложение и что оно делает.
OAuth
  • Приложение прошло проверку OAuth, использует максимально узкие области действия OAuth, и все области правильно интегрируются с API сервисов Google.

Дополнительные требования для интеграции конкретных приложений

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

Вы можете использовать флажки для отслеживания вашего предварительного обзора.

  • Дополнение Google Workspace
  • дополнение к редактору
  • Веб-приложение
  • Приложение Диска
  • Приложение Google Чат
Интеграция приложений Категория Критерии
Веб-приложение Функциональность
  • Универсальный URL-адрес навигации указывает на веб-приложение. Простая веб-страница без функциональности не считается веб-приложением.
Дополнение Google Workspace Имя

Дополнения к календарю

  • Если надстройка использует calendar.name или common.name , имя в манифесте идентично имени, указанному в списке приложения.
  • Если надстройка использует calendar.conferenceSolution , имя решения для конференций не содержит «Календарь Google».
  • ( Рекомендуется ) Если надстройка использует calendar.conferenceSolution , имя решения конференции не превышает 30 символов.
Дополнение Google Workspace Функциональность
  • В надстройке используется правильный элемент пользовательского интерфейса (например, виджеты или пользовательский интерфейс с рамкой в ​​надстройках Meet) для обеспечения требуемой функциональности. Например, используйте переключатель, чтобы выбрать логическое значение.

Дополнения к календарю

  • Вторичные календари и делегирование поддерживаются или, если не поддерживаются, управляются корректно. Например, создание конференции не завершится ошибкой, если пользователь выберет другой календарь, к которому у него есть доступ для редактирования при создании мероприятия.
  • Повторяющиеся события работают правильно.
  • Если надстройка использует calendar.conferenceSolution , предоставляется хотя бы одно решение для конференции.
  • Если надстройка предоставляет решения для проведения конференций, используются соответствующие поля данных конференции. Например, ссылки на видеоконференции, номера телефонов, SIP-ссылки, коды доступа и другие поддерживаемые атрибуты используют поля структурированных данных и не предоставляются в поле примечаний.
  • Если надстройка предоставляет решения для конференц-связи, она редактирует только сведения о конференции и не редактирует другие поля событий.
  • Если надстройка предоставляет решения для конференц-связи, создание конференции занимает менее 5 секунд.

Дополнения Gmail

Если надстройка использует UrlFetchApp или OpenLinkUrl :

  • URL-адрес действителен.
  • URL-адрес использует HTTPS, а не HTTP.
  • Указан полный домен.
  • Путь не пустой. Например, https://altostrat/ подходит, а https://altostrat — нет.
  • Подстановочные знаки нельзя использовать в UrlFetchApp .

Встречайте дополнения

  • Дополнительный вход в систему и пути пользователя должны работать, даже если сторонние файлы cookie отключены.
  • Надстройка должна обеспечивать функциональные возможности, необходимые для проведения собрания или участия в нем.
  • Надстройка не должна делать ничего, что заставляло бы пользователей покидать собрание, например обновлять браузер.
  • При использовании многопользовательской игры надстройка должна позволять всем участникам совместно работать над контентом, даже если разрешения не установлены заранее. Настройка разрешений должна быть доступна во время сеанса совместной работы надстройки.
  • Надстройка должна обрабатывать отмену потока действий при запуске и позволять пользователю повторно инициировать запуск действия из приложения.
  • Надстройка должна предоставлять боковую панель для входа в систему и настройки активности.
  • Надстройка не должна обеспечивать возможность приглашения бота или полагаться на присутствие бота на собрании.
Дополнение Google Workspace Пользовательский опыт
  • У дополнения есть домашняя страница. Если ваша надстройка Google Workspace является преобразованной надстройкой Gmail, применяется домашняя страница по умолчанию.
  • Элемент пользовательского интерфейса (например, дополнительная карточка или пользовательский интерфейс в рамке в надстройках Meet) работает правильно. Например, нет повторяющихся элементов; Кнопки «Назад», «Обновить» и «Обновить» работают соответственно.
  • После того как пользователь авторизует надстройку, она отображает информацию (например, персонализированную карточку главной страницы или веб-страницу в надстройках Meet), приветствуя пользователя кнопкой для входа в систему (при необходимости), логотипом и кратким описанием надстройки.
    • Если кнопка входа нажата, отображается настроенная страница входа от стороннего поставщика, на которой четко указано, что за пределами Google Workspace работает сторонняя служба.
  • Пользовательский интерфейс дополнения аккуратно вписывается в отведенное место:
    • Текст и метки не обрезаются знаком "...".
    • Пользователю не нужно делать много вертикальной прокрутки.
    • Ширина контента не превышает 300p, поэтому у него нет горизонтальной полосы прокрутки.
  • Код надстройки не использует библиотеки чрезмерно, поскольку библиотеки могут привести к снижению производительности надстройки.

Дополнения к календарю

  • Если надстройка предоставляет решения для конференц-связи, созданные конференции действительны и правильно отображаются на стороннем веб-сайте конференц-связи.

Дополнения к Документам

Если дополнение просматривает ссылки со стороннего домена (умные чипы):

  • Предварительный просмотр ссылок предлагает пользователю соответствующую дополнительную информацию. Например, при предварительном просмотре ссылки на сделку купли-продажи добавляется такая информация, как счет, сумма и этап.
  • Разработчик связан с просматриваемым доменом (указанным шаблоном URL-адреса, который запускает создание смарт-чипа).

Дополнительную информацию см. в разделе Предварительный просмотр ссылок со смарт-чипами .

Дополнения для Диска

  • Если приложение хранит файлы на Диске, оно позволяет пользователям выбирать папку или создавать и повторно использовать папку для конкретного приложения. Данные конфигурации можно хранить в папке App Data. Приложение не сохраняет файлы в папку «Мой диск» пользователя.
  • Надстройка хранит на Диске только те файлы, которые связаны с документированной функциональностью надстройки.

Дополнения Gmail

  • В дополнении не упоминаются и не ссылаются на расширения браузера Chrome без обоснования.
  • Меню «Дополнительные действия» содержит универсальные действия, которые работают правильно. Например, «Выйти», «О программе», «Поддержка» и т. д.

Встречайте дополнения

  • Если для надстройки требуется лицензия или подписка: пользователю должно быть показано понятное сообщение, если у пользователя нет лицензии.
  • Если пользователь не может использовать надстройку из-за проблем с лицензией, в сообщении об ошибке должна быть четко указана причина, по которой надстройку невозможно использовать, и предложены действия пользователя по исправлению ситуации.
  • В списке надстройки на Google Workspace Marketplace должна быть указана подробная информация о требованиях к лицензии и подписке, которые могут потребоваться для использования надстройки. Если надстройка имеет платный уровень, в списке Marketplace должна быть ссылка на веб-страницу, на которой предлагается дополнительная информация о ценах или о том, как связаться с продавцом.
  • Если пользователь еще не вошел в систему, надстройка должна отображать приглашение для входа в систему в одно касание, которое можно найти на странице Display Google One Tap , и резервную опцию «Войти через Google», которую можно найти на странице Аутентификация . Помимо механизма «Войти через Google» могут быть предложены и другие варианты входа.
  • Дополнение должно иметь адаптивный дизайн, позволяющий адаптировать контент к разным размерам.
  • Дополнительные пути пользователя должны работать, даже если сторонние файлы cookie отключены.
  • Надстройка не должна иметь горизонтальную прокрутку внутри iframe.
  • Если дополнение хочет использовать основную сцену, оно должно быть разработано для многопользовательской игры и позволять нескольким участникам одновременно манипулировать контентом. Для одиночной игры разработчику следует использовать боковую панель.
  • ( Рекомендуется ) Надстройка должна отображать имя вошедшего в систему пользователя.
  • ( Рекомендуется ) Выбор локализации: язык должен основываться на местных предпочтениях, установленных браузером, если они доступны.
  • ( Рекомендуется ) Выбор контента должен осуществляться через интерфейс просмотра контента, включающий недавно доступный контент.
  • ( Рекомендуется ) Если боковая панель больше не нужна, дополнение должно закрыть боковую панель после запуска на основную сцену.
Дополнение Google Workspace Графика

Дополнения к календарю

  • Логотип решения для конференц-связи представляет собой общедоступный URL-адрес. См. раздел Предоставление логотипов решений для конференций.
  • Если надстройка использует calendar.conferenceSolution , логотип решения для конференций соответствует требованиям calendar.logoUrl . См. Ресурс манифеста календаря .
  • Если надстройка использует calendar.logoUrl или common.logoUrl , логотип идентичен значку, указанному в списке приложения.
  • Если надстройка использует calendar.logoUrl или common.logoUrl , URL-адрес логотипа начинается следующим образом: https://lh3.googleusercontent.com/

Встречайте дополнения

  • Логотип бренда дополнения должен иметь такой размер и стиль, чтобы его можно было идентифицировать на боковой панели Meet.
  • Подходящие URL-адреса логотипа темного режима должны быть указаны в манифесте надстройки.
Дополнение Google Workspace OAuth

Дополнения для Диска

  • ( Рекомендуется ) Если вы хотите получать ограниченные метаданные, надстройка включает область drive.addons.metadata.readonly .
дополнение к редактору Функциональность
  • Ожидаемые и необходимые действия включены в надстройку и предоставляют все инструменты, необходимые для завершения рабочего процесса. Например:
    • Если надстройка применяет стиль ко всему документу, она предлагает возможность применить стиль только к выделенному тексту.
    • Если надстройка загружает данные электронной таблицы в канал веб-службы, у нее есть ссылка на этот канал для упрощения навигации.
    • Если надстройка требует, чтобы у пользователя была учетная запись, она предоставляет ссылки или информацию для легкого создания учетной записи, если у пользователя ее еще нет.
  • В дополнении есть пункты меню на вкладке «Дополнения» .
  • Даже если надстройка представляет собой просто пользовательские функции, она все равно включает соответствующую документацию.
  • Надстройка правильно использует onInstall() и onOpen() для заполнения своего меню. Пункты меню заполняются при первой установке надстройки и при открытии другого файла. См. Авторизация надстройки Редактора .
  • Режимы авторизации настроены правильно. См. Режимы авторизации .
  • Надстройка должна быть реализована в среде выполнения Apps Script V8 . Дополнительные сведения см. в разделе Обзор среды выполнения V8 .
дополнение к редактору Пользовательский опыт
  • Дополнение предоставляет всю информацию, необходимую для базового понимания продукта и способов его использования.
  • Код надстройки не использует библиотеки чрезмерно, поскольку библиотеки могут привести к снижению производительности надстройки.
  • Ошибки по возможности избегаются и управляются должным образом, если нет:
    • Сообщения об ошибках отображаются в диалоговом окне, а не в предупреждении JavaScript или на красной полосе по умолчанию. Они сообщают о проблеме и простым языком описывают, что пользователь должен сделать, чтобы ее исправить.
    • Если это возможно, если пользователь делает что-то не так, отображается кнопка, которая устраняет проблему.
    • Дополнительную информацию см. в руководстве по стилю надстроек .
  • Ссылки на внешние страницы открываются в новых окнах и являются корректными.
  • Дополнение интуитивно понятно и хорошо спроектировано. Это означает:
    • Всегда понятно, что и как делать.
    • Дополнение доступно и просто для понимания. Технические термины и жаргонизмы избегаются.
    • Рабочие процессы понятны и максимально упрощены.
    • Пользователь и его контент максимально безопасны.
  • Надстройка соответствует руководству по стилю пользовательского интерфейса для надстроек редактора и использует пакет CSS для надстроек редактора.
  • Надстройка использует только одно синее основное действие для каждого дисплея.
  • Дополнение отображает по одному диалогу за раз. Он не перекрывается и не открывает несколько диалогов одновременно.
  • Пользовательский интерфейс дополнения аккуратно вписывается в отведенное место:
    • Текст и метки не обрезаются знаком "...".
    • Пользователю не нужно делать много вертикальной прокрутки.
    • Ширина контента не превышает 300p, поэтому у него нет горизонтальной полосы прокрутки.
  • Надстройка требует подтверждения или отображает предупреждения для всех деликатных действий. Например, если надстройка собирается перезаписать все содержимое электронной таблицы, пользователь получает предупреждение и подтверждает действие, прежде чем оно произойдет.

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

  • Пользователи не могут запускать действия несколько раз во время загрузки действия. Например, кнопки отключены или скрыты во время загрузки действия.
Приложение Google Диск Функциональность
  • Приложение не использует расширения браузера Chrome для обеспечения функциональности путем непосредственного управления HTML-кодом Диска.
  • Если ваше приложение использует конфиденциальные или ограниченные области действия, оно должно пройти проверку OAuth. См. Отправка приложения на проверку .
  • Если ваше приложение использует ограниченные области действия, оно также должно пройти оценку безопасности. См. Оценка безопасности .
Приложение Google Диск Пользовательский опыт
  • Если приложение хранит файлы на Диске, оно позволяет пользователям выбирать папку или создавать и повторно использовать папку для конкретного приложения. Данные конфигурации можно хранить в папке App Data. Приложение не сохраняет файлы в папку «Мой диск» пользователя.
  • Приложение хранит на Диске только файлы, связанные с задокументированной функциональностью приложения.
Приложение Google Чат Имя
  • Кнопки для связи с приложением доступны из описания.
  • Имя приложения начинается с букв A–Z (заглавные) или 0–9. Он не может начинаться с символа.
Приложение Google Чат Пользовательский опыт
  • Приложение отправляет приветственное сообщение без запроса каждый раз, когда пользователь отправляет личное сообщение или приложение добавляется в пространство. Приветственное сообщение отличается от команды «Помощь». Дополнительную информацию см. в разделе Создание домашней страницы для приложения Google Chat .
  • Приложение поддерживает команду «Справка» и помогает пользователям начать работу с приложением. Дополнительную информацию см. в разделе «Ответ на команды с косой чертой в приложении Google Chat» .
  • Приложение всегда отвечает, когда с ним разговаривают в чате или в прямом чате.
  • В сообщениях используются правильные орфография, заглавные буквы, пунктуация и грамматика. Сообщения не содержат вредоносных, оскорбительных или оскорбительных материалов.
  • В сообщениях используется четкое, лаконичное и единообразное форматирование текста или карточек в соответствии с требованиями Google.
  • Если ответ занимает более 2 секунд, приложение отправляет сообщение с объяснением задержки.
  • Приложения, отправляющие уведомления, позволяют пользователям отключать уведомления.
  • Пользователи могут добавить приложение в пространство, используя @mentioning.
  • Пользователи могут удалить приложение из пространства с помощью меню «Просмотреть участника» .
  • Приложение указывает пользователю все, что необходимо для взаимодействия с ним.
  • Формат карточек, который использует приложение, соответствует требованиям Google. См. раздел Отправка сообщения с помощью Google Chat API.
  • Приложение доступно в разделе « Найти приложения» в меню «Чат».
  • Внешние URL-адреса, с которыми взаимодействует приложение, не относятся к промежуточной среде или среде разработки.
  • @mention требуется в каждом сообщении приложению в пробелах. Это единственный способ понять, что приложение должно ответить.
  • Если приложение Chat просматривает ссылки со стороннего домена:
    • Предварительный просмотр ссылок предлагает релевантную дополнительную информацию к сообщению пользователя. Например, при предварительном просмотре ссылки на сделку купли-продажи добавляется такая информация, как счет, сумма и этап.
    • Разработчик связан с предварительно просмотренным доменом.

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

  • (Рекомендуется) Чтобы администраторы Workspace могли установить ваше приложение от имени пользователей в своей организации, ваше приложение должно иметь возможность получать и отправлять прямые сообщения.
Приложение Google Чат Графика
  • Приложение имеет узнаваемый и понятный аватар.