Типы дополнений

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

Дополнения Google Workspace

Надстройки Google Workspace — это надстройки последнего поколения, которые предоставляют множество возможностей, в том числе:

  • Создайте только одно дополнение для нескольких приложений Google Workspace . Вместо отдельных дополнений для Gmail, Календаря, Диска и редакторов вы можете создать и управлять одним дополнением Google Workspace для расширения нескольких приложений Google Workspace.

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

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

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

  • Используйте стандартизированные интерфейсы . Создавайте пользовательские интерфейсы из встроенных элементов виджета, предоставляемых службой Apps Script Card . Вам не нужны какие-либо знания HTML или CSS, чтобы определить эти интерфейсы.

  • Расширение клиентов для настольных компьютеров и мобильных устройств для Gmail . Если надстройка Google Workspace расширяет возможности Gmail, вы можете использовать ее как в настольной, так и в мобильной версиях Gmail. Если вы создаете надстройку Google Workspace, расширяющую возможности Gmail, вам не нужно разрабатывать отдельную мобильную версию надстройки. Везде используется один и тот же интерфейс.

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

Надстройки редактора

Надстройки редактора расширяют возможности одного из приложений редактора Google, например Документов, Таблиц, Слайдов или Форм. Каждый тип надстройки редактора (например, надстройки для таблиц) может иметь собственный набор возможностей, ограничений и особых соображений для конкретного типа. При создании надстроек редактора важно понимать эти специфичные для редактора детали. Подробнее о надстройках для конкретных Редакторов смотрите в соответствующих разделах:

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

Надстройки редактора ведут себя иначе, чем надстройки Google Workspace, в следующих отношениях:

  • Надстройки редактора могут создавать интерфейсы, состоящие из пунктов меню, диалоговых окон и боковых панелей. Дополнительные диалоговые окна и боковые панели определяются с использованием стандартных HTML и CSS .
  • Надстройки редактора имеют специальные правила авторизации, поскольку они создают, изменяют или иным образом взаимодействуют с файлами на Google Диске. Важно понимать жизненный цикл авторизации надстройки редактора при разработке надстройки редактора.
  • Файлы, создаваемые и обновляемые в каждом редакторе, имеют определенную структуру. Например, презентации Google Slides состоят из страниц, которые могут быть слайдами, образцами или макетами. Вы должны понимать эти файловые структуры, так как надстройки часто взаимодействуют с ними при чтении или редактировании файлов.
  • Надстройки редактора работают только в клиентах для настольных ПК, но не в Android или iOS.
  • Надстройки редактора должны быть встроены в Apps Script.