Процесс проверки приложения и требования для 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 Chat .
  • Приложение поддерживает команду «Справка» и помогает пользователям начать работу с приложением. Дополнительную информацию см. в разделе «Реагирование на команды с косой чертой» .
  • Приложение всегда отвечает, когда с ним разговаривают в чате или в прямом чате.
  • В сообщениях используются правильные орфография, заглавные буквы, пунктуация и грамматика. Сообщения не содержат вредоносных, оскорбительных или оскорбительных материалов.
  • В сообщениях используется четкое, лаконичное и единообразное форматирование текста или карточек в соответствии с требованиями Google.
  • Если ответ занимает более 2 секунд, приложение отправляет сообщение с объяснением задержки.
  • Приложения, отправляющие уведомления, позволяют пользователям отключать уведомления.
  • Пользователи могут добавить приложение в пространство, используя @mentioning.
  • Пользователи могут удалить приложение из пространства с помощью меню «Просмотреть участника» .
  • Приложение указывает пользователю все, что необходимо для взаимодействия с ним.
  • Формат карточек, который использует приложение, соответствует требованиям Google. См. раздел Создание интерактивных карточек.
  • Приложение доступно в разделе «Найти приложения» в меню «Чат».
  • Внешние URL-адреса, с которыми взаимодействует приложение, не относятся к промежуточной среде или среде разработки.
  • @mention требуется в каждом сообщении приложению в пробелах. Это единственный способ понять, что приложение должно ответить.
  • Если приложение Chat просматривает ссылки со стороннего домена:
    • Предварительный просмотр ссылок предлагает релевантную дополнительную информацию к сообщению пользователя. Например, при предварительном просмотре ссылки на сделку купли-продажи добавляется такая информация, как счет, сумма и этап.
    • Разработчик связан с предварительно просмотренным доменом.

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

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

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

  • Пользователи не могут запускать действия несколько раз во время загрузки действия. Например, кнопки отключены или скрыты во время загрузки действия.
Дополнение 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, поэтому у него нет горизонтальной полосы прокрутки.
  • Код надстройки не использует библиотеки чрезмерно, поскольку библиотеки могут привести к снижению производительности надстройки.

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

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

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

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

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

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

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

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

Дополнения Gmail

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

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

  • Если для надстройки требуется лицензия или подписка: пользователю должно быть показано понятное сообщение, если у пользователя нет лицензии.
  • Если пользователь не может использовать надстройку из-за проблем с лицензией, в сообщении об ошибке должна быть четко указана причина, по которой надстройка не может быть использована, и предложены действия пользователя по исправлению ситуации.
  • В списке надстройки на Google Workspace Marketplace должна быть указана подробная информация о требованиях к лицензии и подписке, которые могут потребоваться для использования надстройки. Если надстройка имеет платный уровень, в списке Marketplace должна быть ссылка на веб-страницу, на которой предлагается дополнительная информация о ценах или о том, как связаться с продавцом.
  • Если пользователь еще не вошел в систему, надстройка должна отображать приглашение для входа в систему в одно касание, доступное в разделе «Показать 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 .
Веб-приложение Функциональность
  • Универсальный URL-адрес навигации указывает на веб-приложение. Простая веб-страница без функциональности не считается веб-приложением.