Ресурс манифеста дополнений

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

Дополнения

Верхний уровень конфигурации манифеста надстройки Google Workspace .

JSON-представление
{
  "common": {
    object (Common)
  },
  "calendar": {
    object (Calendar)
  },
  "drive": {
    object (Drive)
  },
  "gmail": {
    object (Gmail)
  },
  "docs": {
    object (Docs)
  },
  "sheets": {
    object (Sheets)
  },
  "slides": {
    object (Slides)
  }
}
Поля
common

object ( Common )

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

calendar

object ( Calendar )

Требуется, если надстройка Google Workspace расширяет Calendar . Конфигурации внешнего вида и поведения надстройки Google Workspace в хост-приложении Календаря Google. Если это поле опущено, надстройка отключена в Календаре Google.

drive

object ( Drive )

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

gmail

object ( Gmail )

Требуется, если надстройка Google Workspace расширяет возможности Gmail . Конфигурации внешнего вида и поведения надстройки Google Workspace в хост-приложении Gmail. Если это поле опущено, надстройка отключена в Gmail.

docs

object ( Docs )

Требуется, если надстройка Google Workspace расширяет Docs . Конфигурации внешнего вида и поведения надстройки Google Workspace в ведущем приложении Документов. Если это поле опущено, надстройка отключена в Документах.

sheets

object ( Sheets )

Требуется, если надстройка Google Workspace расширяет Sheets . Конфигурации внешнего вида и поведения надстройки Google Workspace в ведущем приложении Таблиц. Если это поле опущено, надстройка отключена в Таблицах.

slides

object ( Slides )

Требуется, если надстройка Google Workspace расширяет Slides . Конфигурации внешнего вида и поведения надстройки Google Workspace в главном приложении Slides. Если это поле опущено, надстройка отключена в Slides.

Общий

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

Представление JSON
{
  "homepageTrigger": {
    object (HomepageTrigger)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "logoUrl": string,
  "name": string,
  "openLinkUrlPrefixes": [
    string
  ],
  "universalActions": [
    {
      object (UniversalAction)
    }
  ],
  "useLocaleFromApp": boolean
}
Поля
homepageTrigger

object ( HomepageTrigger )

Спецификация триггерной функции по умолчанию для создания домашней страницы надстройки . Эта спецификация используется, если триггер домашней страницы для хоста не определен. Если это также опущено, создается общая карточка домашней страницы, которая используется при необходимости.
layoutProperties

object ( LayoutProperties )

Конфигурация цветов, используемых на панели инструментов и кнопках надстройки.
logoUrl

string

Необходимый. URL-адрес изображения, отображаемого на панели инструментов.

name

string

Необходимый. Название надстройки, отображаемое на панели инструментов.

openLinkUrlPrefixes[]

string

Требуется, если надстройка отображает какие-либо исходящие ссылки, будь то в виджетах с использованием OpenLink или текстовых виджетах с использованием тегов привязки HTML. Список префиксов URL-адресов HTTPS. Для защиты пользовательских данных любая ссылка, отображаемая надстройкой, должна соответствовать одному из префиксов в этом списке.

Дополнительные сведения см. в разделе Добавление URL-адресов в белый список.

universalActions[]

object ( UniversalAction )

Список универсальных действий , которые всегда доступны в пользовательском интерфейсе дополнения.
useLocaleFromApp

boolean

Если значение true , дополнительные объекты событий, передаваемые функциям обратного вызова действия или триггерным функциям, включают информацию о локали и часовом поясе пользователя. По умолчанию false .

Подробнее см. в разделе Доступ к языковым настройкам и часовым поясам пользователя .

Свойства макета

Конфигурация, которая управляет дополнительной панелью инструментов Google Workspace, цветами и внешним видом кнопок.

JSON-представление
{
  "primaryColor": string,
  "secondaryColor": string
}
Поля
primaryColor

string

Цвет панели инструментов. По умолчанию серый (#424242).
secondaryColor

string

Цвет кнопок по умолчанию. По умолчанию используется основной цвет (если он установлен); в противном случае по умолчанию используется синий цвет (# 2196F3).

Универсальное действие

Конфигурация универсального действия . При выборе универсальное действие либо открывает указанную URL-ссылку, либо запускает указанную функцию Apps Script.

JSON-представление
{
  "label": string,

  // Union field rule can be only one of the following:
  "openLink": string,
  "runFunction": string,
  // End of list of possible types for union field rule.

}
Поля
label

string

Требуется для каждого универсального действия. Текст, отображаемый в меню пользовательского интерфейса для этого действия.
runFunction

string

Требуется для каждого универсального действия, если openLink отсутствует. Если предоставлено, имя функции скрипта приложений, которая выполняется, когда пользователь выбирает это действие.

Подробнее см. в руководстве по универсальным действиям .