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

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

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

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

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

    • Gmail
    • Google Календарь
    • Google Документы
    • Гугл Диск
    • Google Таблицы
    • Google Презентации
  • Повысьте узнаваемость своего бренда : значки надстроек по умолчанию отображаются на правой панели хост-приложений надстройки.

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

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

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

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

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

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

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

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

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

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