Дополнения Google Workspace должны соответствовать стилю и структуре основного приложения, которое они расширяют. Они должны естественным образом расширять пользовательский интерфейс, используя привычные элементы управления и функции. Представленные здесь рекомендации описывают способы обработки текста, изображений, элементов управления и фирменной символики, которые способствуют обеспечению высокого качества пользовательского опыта.
Если ваше дополнение открывает отдельные веб-страницы, являющиеся неотъемлемой частью его работы (например, страницу настроек дополнения), убедитесь, что эти веб-страницы также соответствуют данным рекомендациям по стилю.
Текст и изображения
В этом разделе рассказывается, как использовать текст и изображения в вашем дополнении.
Название дополнения
Необходимо указать имя дополнения в манифесте проекта, а также при настройке дополнения для публикации . Имя отображается во многих местах, например, в списке Google Workspace Marketplace и в меню. При выборе имени:
- Используйте регистр букв в заголовке.
- Избегайте знаков препинания, особенно скобок, если они не являются частью вашего бренда.
- Заполняйте текст кратко — лучше всего не более 15 символов. Длинные имена могут быть автоматически усечены в описании на Google Workspace Marketplace и в других местах.
- Не включайте в название вашего дополнения слова "Google", "Gmail" или другие названия продуктов Google.
- Не включайте слово "add-on" в название вашего дополнения.
- Не указывайте информацию о версии.
Стиль письма
Вам не нужно много писать. Большинство действий следует четко описывать с помощью иконок, макета и кратких описаний. Если вы обнаружите, что какая-либо часть вашего дополнения требует более подробного объяснения, чем могут дать краткие описания, рекомендуется создать отдельную веб-страницу с описанием дополнения и ссылкой на нее.
При написании текста для пользовательского интерфейса:
- Используйте регистр предложений (особенно для кнопок, подписей и действий на карточках).
- Предпочтительнее использовать короткие, понятные тексты без профессионального жаргона и аббревиатур.
Универсальные и карточные действия
Если в вашем дополнении используются универсальные действия или действия на карточках , они отображаются в виде пунктов меню в определенных вами карточках . Вы можете выбрать текст, который будет использоваться в этих меню для данных действий. При выборе текста для использования:
- Избегайте повторения названия вашего дополнения в тексте меню.
- Каждый пункт меню начинается со слова, обозначающего действие, например, «Запустить», «Настроить» или «Создать».
- Опишите задачу, а не компонент пользовательского интерфейса, который отображает это действие.
- Если ваше действие запускает рабочий процесс, и нет единого глагола, описывающего его действие, назовите его «Начать».
- Ограничьте количество пунктов меню, чтобы пользователю не приходилось прокручивать большой список. Если вам нужно реализовать больше действий, рассмотрите возможность использования нескольких карточек с различными действиями на каждой.
Сообщения об ошибках
Когда что-то идёт не так, важно использовать простой язык. Объясните проблему с точки зрения пользователя и предложите способ её решения.
- Не позволяйте пользователю видеть исключения, которые генерирует ваш код. Вместо этого используйте конструкции
try...catchдля перехвата исключений, а затем отобразите понятное пользователю сообщение об ошибке. - Перед публикацией убедитесь, что ваше дополнение не отображает отладочную информацию в пользовательском интерфейсе.
Справочное содержимое
Возможно, вам потребуется разработать карточки, отображающие справочную информацию или объясняющие пользователю принцип работы дополнения. Если вы создаёте справочный контент для своего дополнения, помните:
- По возможности, отображайте инструкции в виде маркированного или нумерованного списка. Пошагово объясняйте пользователям, как достичь конечного результата, с четкими ссылками на именованные элементы пользовательского интерфейса.
- Убедитесь, что в инструкциях четко указаны все требования, например, как правильно настроить электронную таблицу.
- Вы можете свободно размещать ссылки на внешние справочные материалы, например, на вспомогательные веб-страницы.
Изображения
Изображения, используемые в вашем дополнении, представляют собой либо один из встроенных типов значков , либо общедоступное изображение, указанное в URL-адресе. При использовании общедоступных изображений убедитесь, что они доступны всем, кто может использовать ваше дополнение.
Элементы управления
В этом разделе представлены рекомендации по улучшению пользовательского опыта для интерактивных виджетов .
Кнопки
Для управления основными действиями пользовательского интерфейса используйте кнопки, а не другие виджеты.
- Большинство текстовых надписей на кнопках должны начинаться с глагола.
- В большинстве случаев количество кнопок в ряду должно быть ограничено тремя или менее кнопками.
Декорированный текст
Виджеты DecoratedText позволяют отображать текстовое содержимое с помощью значков, кнопок или переключателей.
- Используйте регистр предложений для текста.
- Текст виджета DecoratedText обрезается, если он не помещается в доступное пространство. Поэтому всегда старайтесь делать текст как можно короче.
Входные данные для выбора
В вашем дополнении можно использовать различные виджеты для выбора элементов : выпадающие списки, флажки и переключатели.
- Используйте флажки, когда пользователь может выбрать несколько вариантов или не выбирать ни одного варианта. Используйте переключатели (или выпадающее меню), когда необходимо выбрать ровно один вариант. Используйте выпадающие списки, когда нужно предоставить короткий список альтернатив, чтобы сэкономить место в пользовательском интерфейсе.
- Для текста, присвоенного каждому варианту, используйте регистр предложений.
- Избегайте использования изменений в выделении для запуска важных, трудноотменяемых действий, поскольку люди часто ошибаются при выборе элементов. Вместо этого рассмотрите возможность добавления кнопки, которая считывает текущие значения выделения и затем запускает действие.
- Для выпадающих списков отсортируйте варианты в алфавитном порядке или по логической схеме, понятной всем пользователям (например, представьте дни недели по порядку, начиная с воскресенья или понедельника).
- Ограничьте количество вариантов в выбранном поле ввода разумным числом. Если вариантов слишком много, пользователям может быть сложно пользоваться виджетом. В таких случаях рассмотрите возможность разделения вариантов на разные категории и создание нескольких виджетов.
Текстовые поля ввода
Текстовые поля позволяют пользователям вводить строковые данные.
- Не используйте текстовое поле ввода, чтобы заставить пользователя ввести один из определенного набора возможных вариантов. Вместо этого используйте выпадающий список.
- Используйте подсказки и предложения, чтобы помочь пользователю ввести текст в правильном формате и с правильным содержанием.
- Если вводимый текст состоит из нескольких слов, используйте многострочные текстовые поля.
Брендинг
В этом разделе представлены рекомендации по улучшению пользовательского опыта при добавлении элементов фирменной символики в интерфейс вашего дополнения.
В вашем дополнении
Если вы хотите включить элементы фирменного стиля в пользовательский интерфейс вашего дополнения, сделайте его кратким и лаконичным. Это поможет пользователям сосредоточиться на функциональности вашего дополнения.
- Все аспекты вашего дополнения должны соответствовать фирменным стандартам .
- Не используйте слова «Google», «Gmail» или другие названия продуктов Google.
- Не используйте значки продуктов Google, даже если они изменены.
- Не включайте слово "дополнительная услуга" в текст, используемый в вашем фирменном стиле.
- Текст, рекламирующий бренд, не должен превышать нескольких слов.
В Google Workspace Marketplace
При настройке дополнения для публикации вы предоставляете ряд графических и текстовых элементов для создания объявления в Google Workspace Marketplace.
Все аспекты описания вашего магазина и представленные материалы должны соответствовать фирменным стандартам .