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

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

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

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

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

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

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

Дополнения для редактора идеально подходят для автоматизации задач в Google Документах, Таблицах, Презентациях или Формах для личного или внутреннего использования. Если вам требуются масштабные функции, которые должны обрабатывать запросы большого количества пользователей, обеспечивать низкую задержку или полный контроль над инфраструктурой, рассмотрите возможность создания дополнений Google Workspace в другой среде выполнения для лучшего контроля над инфраструктурой, процессами развертывания и выпуска.

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

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