Процесс проверки приложения и требования для 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 .
  • Авторизация и вход в систему требуются только один раз. Приложение использует систему единого входа (SSO) в один клик, а в идеале — без кликов.
  • После того как администратор предоставит разрешения на области действия OAuth 2.0 для домена, отдельным пользователям больше не будут предлагаться разрешения на области действия.
  • Пользователям не нужно вводить учётные данные после входа в учётную запись Google. Для получения доступа достаточно нажать кнопку «Войти через Google».
  • Для надписей кнопок, пунктов меню, заголовков и других элементов приложения используются единые, очевидные и понятные термины. Например, вместо «Да» или «Нет» надписи обозначают названия действий, например, «Удалить» и «Отмена».
  • Если требуется вход, функция выхода работает корректно. Токены аннулируются, и вход можно начать сначала.
  • Для действий всегда отображается обратная связь, например, подтверждение или сообщение об ошибке.
  • Нет неработающих ссылок на изображения или размытых изображений.
Графика
  • Значки имеют правильный размер, квадратную форму и прозрачный фон. См. раздел «Графические ресурсы» .
  • Значок правильно отображает название или функциональность приложения.
  • Значок цветной (не в оттенках серого).
  • Значок не использует товарные знаки Google.
  • Скриншоты и изображения не должны быть размытыми, трудночитаемыми или неуместными. Они должны точно отображать приложение.
  • ( Рекомендуется ) Скриншоты наглядно показывают, как использовать приложение и что оно делает.
OAuth
  • Приложение прошло проверку OAuth, использует максимально узкие области действия OAuth, и все области действия корректно интегрируются с API сервисов Google.

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

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

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

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

    Чтобы узнать о предварительном просмотре ссылок, просмотрите документацию .

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

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

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

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

  • Если дополнение использует calendar.name или common.name , имя в манифесте идентично имени, указанному в листинге приложения.
  • Если дополнение использует calendar.conferenceSolution , имя решения для конференции не содержит «Google Calendar».
  • ( Рекомендуется ) Если дополнение использует 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 должна быть ссылка на веб-страницу с дополнительной информацией о ценах или о том, как связаться с продавцом.
  • Если пользователь ещё не вошёл в систему, дополнение должно отображать запрос на вход одним касанием, как описано в разделе «Отображение 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 указывает на веб-приложение. Простая веб-страница без функциональности не считается веб-приложением.