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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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