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

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

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

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

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

    • Гмайл
    • Календарь Google
    • Google Чат
    • Google Документы
    • Google Диск
    • Google Meet
    • 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, таких как Docs, Sheets, Slides или Forms. Каждый тип дополнений для редакторов (например, дополнения для Sheets) может иметь свой собственный набор специфических возможностей, ограничений и особых условий. При создании дополнений для редакторов важно понимать эти специфические особенности. Более подробную информацию о дополнениях для конкретных редакторов см. в соответствующих разделах:

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

Дополнения для редакторов идеально подходят для автоматизации задач в Google Docs, Sheets, Slides или Forms для индивидуального или внутреннего использования. Для дополнений, требующих масштабных возможностей, обработки большого количества пользователей, низкой задержки или полного контроля над инфраструктурой, рассмотрите возможность создания дополнений для Google Workspace в другой среде выполнения для лучшего контроля над инфраструктурой, развертыванием и процессами выпуска.

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

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