Есть 5 минут? Помогите нам улучшить документацию Google Workspace Marketplace, приняв участие в быстром онлайн-опросе .

О проверке приложения

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

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

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

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

Распространенные причины, по которым ваше приложение не готово

Проверка OAuth

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

Список приложений

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

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

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

Области обзора

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

Интеграция приложений Категория Критерии
Все Имя приложения
  • Других приложений с таким названием нет.
  • Имя не включает номер версии.
  • Имя совпадает с именем на экране согласия OAuth.
  • Название не является расплывчатым или слишком общим.
  • Имя не должно превышать 50 символов.
  • ( Рекомендуется ) В названии используется заглавный регистр.
  • ( Рекомендуется ) В имени нет знаков препинания, особенно скобок.
Все Имя разработчика
  • Имя разработчика и веб-сайт разработчика точно представляют актуальную информацию о разработчике и указывают на нее.
Все Описание приложения
  • Все предоставленные ссылки работают и указывают на правильную информацию. Например, ссылка на политику конфиденциальности указывает на страницу с описанием политики конфиденциальности.
  • Если приложение взаимодействует со сторонней службой, описание описывает, что делает сторонняя служба, как приложение взаимодействует с ней, а также, при необходимости, ссылки на соответствующий веб-сайт.
  • Краткое и подробное описание легко понять.
  • Краткое и подробное описания не идентичны.
  • ( Рекомендуется ) Информация о ценах является полной и точной.
  • ( Рекомендуется ) Полный набор атрибутов для каждого языка (название, краткое описание и подробное описание) определены правильно без языковых несоответствий.
Все Функциональность
  • Явных багов нет, и все действия, включая крайние случаи, полностью функциональны. Время загрузки управляется с помощью индикаторов загрузки.
  • Приложение демонстрирует четкое взаимодействие с 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.
  • Пользователи могут удалить приложение из пространства с помощью меню View Member.
  • Приложение указывает пользователю все, что необходимо для взаимодействия с ним.
  • Формат карт, который использует приложение, соответствует требованиям Google. См. Создание интерактивных карточек.
  • Приложение доступно в разделе « Найти приложения » в меню «Чат».
  • Внешние URL-адреса, с которыми взаимодействует приложение, не относятся к промежуточной среде или среде разработки.
  • @mention требуется в каждом сообщении приложению в пробелах. Это единственный способ, которым приложение знает, что оно должно ответить.
Приложение Google Чат Графика
  • Приложение имеет узнаваемый и понятный аватар.
Приложение Google Чат Превью ссылок
  • Предварительный просмотр ссылок предлагает релевантную дополнительную информацию к сообщению пользователя. Например, при предварительном просмотре ссылки на сделку по продаже добавляется такая информация, как счет, сумма и этап.
  • Разработчик связан с доменом предварительного просмотра.

Дополнительные сведения о настройке предварительного просмотра ссылок см. в разделе Предварительный просмотр ссылок .

Приложение Google Диск Функциональность
  • Приложение не использует расширения Google Chrome для обеспечения функциональности путем непосредственного управления HTML-кодом Диска.
  • Если ваше приложение использует конфиденциальные или ограниченные области, оно должно пройти проверку OAuth. См. Как отправить на проверку .
  • Если ваше приложение использует ограниченные области, оно также должно пройти оценку безопасности. См. Зачем нужна оценка безопасности .
Приложение Google Диск Пользовательский опыт
  • Если приложение хранит файлы на Диске, оно позволяет пользователям выбирать папку или создает и повторно использует папку для конкретного приложения. Данные конфигурации могут храниться в папке App Data. Приложение не сбрасывает файлы в папку «Мой диск» пользователя.
  • Приложение хранит на Диске только те файлы, которые связаны с задокументированными функциями приложения.
Надстройка редактора Функциональность
  • Ожидаемые и требуемые действия включены в надстройку и предоставляют все инструменты, необходимые для завершения рабочего процесса. Например:
    • Если надстройка применяет стиль ко всему документу, она предлагает возможность применить стиль только к выделенному тексту.
    • Если надстройка загружает данные электронной таблицы в фид веб-службы, у нее есть ссылка на этот фид для удобной навигации.
    • Если надстройка требует, чтобы у пользователя была учетная запись, она предоставляет ссылки или информацию для простого создания учетной записи, если у пользователя ее еще нет.
  • Надстройка имеет пункты меню на вкладке « Дополнения ».
  • Даже если надстройка представляет собой просто пользовательские функции, она по-прежнему включает в себя соответствующую документацию.
  • Надстройка правильно использует onInstall() и onOpen() для заполнения своего меню. Пункты меню заполняются при первой установке надстройки и при открытии другого файла. См. авторизацию надстройки Editor .
  • Режимы авторизации настроены корректно. См. Режимы авторизации .
Надстройка редактора Пользовательский опыт
  • Надстройка предоставляет всю информацию, необходимую для базового понимания продукта и способов его использования.
  • Код надстройки не использует чрезмерно библиотеки, поскольку библиотеки могут привести к снижению производительности надстройки.
  • Ошибки избегаются, если это возможно, и управляются должным образом, если нет:
    • Сообщения об ошибках отображаются в диалоговом окне, а не в предупреждении 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-адрес навигации указывает на веб-приложение. Простая веб-страница без функциональности не считается веб-приложением.