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

• Кнопки для связи с приложением доступны из описания.
• Имя приложения начинается с букв A–Z (заглавные) или 0–9. Он не может начинаться с символа.

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

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

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

• Приложение имеет узнаваемый и понятный аватар.

• Приложение не использует расширения браузера Chrome для обеспечения функциональности путем прямого управления HTML-кодом Диска.
• Если ваше приложение использует конфиденциальные или ограниченные области действия, оно должно пройти проверку OAuth. См. раздел «Как отправить заявку на проверку» .
• Если ваше приложение использует ограниченные области действия, оно также должно пройти оценку безопасности. См. Зачем нужна оценка безопасности .

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

• Ожидаемые и необходимые действия включены в надстройку и предоставляют все инструменты, необходимые для завершения рабочего процесса. Например:
  • Если надстройка применяет стиль ко всему документу, она предлагает возможность применить стиль только к выделенному тексту.
  • Если надстройка загружает данные электронной таблицы в канал веб-службы, у нее есть ссылка на этот канал для упрощения навигации.
  • Если надстройка требует, чтобы у пользователя была учетная запись, она предоставляет ссылки или информацию для легкого создания учетной записи, если у пользователя ее еще нет.
• В дополнении есть пункты меню на вкладке «Дополнения» .
• Даже если надстройка представляет собой просто пользовательские функции, она все равно включает соответствующую документацию.
• Надстройка правильно использует onInstall() и onOpen() для заполнения своего меню. Пункты меню заполняются при первой установке надстройки и при открытии другого файла. См . Авторизация надстройки редактора .
• Режимы авторизации настроены правильно. См. Режимы авторизации .
• Надстройка должна быть реализована в среде выполнения Apps Script V8 . Дополнительные сведения см. в разделе Обзор среды выполнения V8 .

• Дополнение предоставляет всю информацию, необходимую для базового понимания продукта и способов его использования.
• Код надстройки не использует библиотеки чрезмерно, поскольку библиотеки могут привести к снижению производительности надстройки.
• Ошибки по возможности избегаются и управляются должным образом, если нет:
  • Сообщения об ошибках отображаются в диалоговом окне, а не в предупреждении JavaScript или на красной полосе по умолчанию. Они сообщают о проблеме и простым языком описывают, что пользователь должен сделать для ее устранения.
  • Если это возможно, если пользователь делает что-то не так, отображается кнопка, которая устраняет проблему.
  • Дополнительную информацию см. в руководстве по стилю надстроек .
• Ссылки на внешние страницы открываются в новых окнах и являются корректными.
• Дополнение интуитивно понятно и хорошо спроектировано. Это означает:
  • Всегда понятно, что и как делать.
  • Дополнение доступно и просто для понимания. Технические термины и жаргонизмы избегаются.
  • Рабочие процессы понятны и максимально упрощены.
  • Пользователь и его контент максимально безопасны.
• Надстройка соответствует руководству по стилю пользовательского интерфейса для надстроек редактора и использует пакет CSS для надстроек редактора.
• Надстройка использует только одно синее основное действие для каждого дисплея.
• Дополнение отображает по одному диалогу за раз. Он не перекрывается и не открывает несколько диалогов одновременно.
• Пользовательский интерфейс дополнения аккуратно вписывается в отведенное место:
  • Текст и метки не обрезаются знаком "...".
  • Пользователю не нужно делать много вертикальной прокрутки.
  • Ширина контента не превышает 300p, поэтому у него нет горизонтальной полосы прокрутки.
• Надстройка требует подтверждения или отображает предупреждения для всех деликатных действий. Например, если надстройка собирается перезаписать все содержимое электронной таблицы, пользователь получает предупреждение и подтверждает действие, прежде чем оно произойдет.

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

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

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

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

• В надстройке используются правильные виджеты (или пользовательский интерфейс с рамкой в ​​надстройках Meet) для обеспечения желаемой функциональности. Например, используйте переключатель, чтобы выбрать логическое значение.

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

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

Дополнения Gmail

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

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

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

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

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

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

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

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

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

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

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

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

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

Дополнения Gmail

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

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

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

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

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

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

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

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

• ( Рекомендуется ) Если вы хотите получать ограниченные метаданные, надстройка включает область drive.addons.metadata.readonly .

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