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

На этой странице представлен общий обзор двух типов надстроек, которые вы можете создать: надстройки 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 Editor, например Документы, Таблицы, Слайды или Формы. Каждый тип надстройки редактора (например, надстройки Таблиц) может иметь свой собственный набор специфичных для типа возможностей, ограничений и особых требований. При создании надстроек редактора важно понимать эти детали, специфичные для редактора. Подробнее о дополнениях для конкретных Редакторов смотрите в соответствующих разделах:

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

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

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