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

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

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

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

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

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

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

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

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

Проверка OAuth:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • (Рекомендуется) Чтобы администраторы Workspace могли установить ваше приложение от имени пользователей в своей организации, ваше приложение должно иметь возможность получать и отправлять прямые сообщения.
Приложение Google Чат Графика
  • Приложение имеет узнаваемый и понятный аватар.
Приложение Google Диск Функциональность
  • Приложение не использует расширения браузера Chrome для обеспечения функциональности путем непосредственного управления HTML-кодом Диска.
  • Если ваше приложение использует конфиденциальные или ограниченные области действия, оно должно пройти проверку OAuth. См. раздел «Как отправить заявку на проверку» .
  • Если ваше приложение использует ограниченные области действия, оно также должно пройти оценку безопасности. См. Зачем нужна оценка безопасности .
Приложение Google Диск Пользовательский опыт
  • Если приложение хранит файлы на Диске, оно позволяет пользователям выбирать папку или создавать и повторно использовать папку для конкретного приложения. Данные конфигурации можно хранить в папке App Data. Приложение не сохраняет файлы в папку «Мой диск» пользователя.
  • Приложение хранит на Диске только файлы, связанные с задокументированной функциональностью приложения.
Дополнение к редактору Функциональность
  • Ожидаемые и необходимые действия включены в надстройку и предоставляют все инструменты, необходимые для завершения рабочего процесса. Например:
    • Если надстройка применяет стиль ко всему документу, она предлагает возможность применить стиль только к выделенному тексту.
    • Если надстройка загружает данные электронной таблицы в канал веб-службы, у нее есть ссылка на этот канал для упрощения навигации.
    • Если надстройка требует, чтобы у пользователя была учетная запись, она предоставляет ссылки или информацию для легкого создания учетной записи, если у пользователя ее еще нет.
  • В дополнении есть пункты меню на вкладке «Дополнения» .
  • Даже если надстройка представляет собой просто пользовательские функции, она все равно включает соответствующую документацию.
  • Надстройка правильно использует onInstall() и onOpen() для заполнения своего меню. Пункты меню заполняются при первой установке надстройки и при открытии другого файла. См. Авторизация надстройки редактора .
  • Режимы авторизации настроены правильно. См. Режимы авторизации .
Дополнение к редактору Пользовательский опыт
  • Дополнение предоставляет всю информацию, необходимую для базового понимания продукта и способов его использования.
  • Код надстройки не использует библиотеки чрезмерно, поскольку библиотеки могут привести к снижению производительности надстройки.
  • Ошибки по возможности избегаются и управляются должным образом, если нет:
    • Сообщения об ошибках отображаются в диалоговом окне, а не в предупреждении JavaScript или на красной полосе по умолчанию. Они сообщают о проблеме и простым языком описывают, что пользователь должен сделать, чтобы ее исправить.
    • Если это возможно, если пользователь делает что-то не так, отображается кнопка, которая устраняет проблему.
    • Дополнительную информацию см. в руководстве по стилю надстроек .
  • Ссылки на внешние страницы открываются в новых окнах и являются корректными.
  • Дополнение интуитивно понятно и хорошо спроектировано. Это означает:
    • Всегда понятно, что и как делать.
    • Дополнение доступно и просто для понимания. Технические термины и жаргонизмы избегаются.
    • Рабочие процессы понятны и максимально упрощены.
    • Пользователь и его контент максимально безопасны.
  • Надстройка соответствует руководству по стилю пользовательского интерфейса для надстроек редактора и использует пакет CSS для надстроек редактора.
  • Надстройка использует только одно синее основное действие для каждого дисплея.
  • Дополнение отображает по одному диалогу за раз. Он не перекрывается и не открывает несколько диалогов одновременно.
  • Пользовательский интерфейс дополнения аккуратно вписывается в отведенное место:
    • Текст и метки не обрезаются знаком "...".
    • Пользователю не нужно делать много вертикальной прокрутки.
    • Ширина контента не превышает 300p, поэтому у него нет горизонтальной полосы прокрутки.
  • Надстройка требует подтверждения или отображает предупреждения для всех деликатных действий. Например, если надстройка собирается перезаписать все содержимое электронной таблицы, пользователь получает предупреждение и подтверждает действие, прежде чем оно произойдет.

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

  • Пользователи не могут запускать действия несколько раз во время загрузки действия. Например, кнопки отключены или скрыты во время загрузки действия.
Дополнение Google Workspace Имя

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

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

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

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

Дополнения Gmail

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

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

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

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

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

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

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

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

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

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

Дополнения Gmail

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

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

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

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

  • ( Рекомендуется ) Если вы хотите получать ограниченные метаданные, надстройка включает область drive.addons.metadata.readonly .
Веб-приложение Функциональность
  • Универсальный URL-адрес навигации указывает на веб-приложение. Простая веб-страница без функциональности не считается веб-приложением.