Ресурс манифеста надстроек

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

Дополнения

Конфигурация манифеста дополнения Google Workspace верхнего уровня.

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

object ( Common )

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

calendar

object ( Calendar )

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

chat

object ()

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

Объект addOns.chat должен быть пустым. Чтобы настроить поведение и внешний вид дополнения в чате, см. раздел «Настройка приложения Google Chat».

drive

object ( Drive )

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

gmail

object ( Gmail )

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

docs

object ( Docs )

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

sheets

object ( Sheets )

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

slides

object ( Slides )

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

meet

object ( Meet )

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

Общий

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

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).

UniversalAction

Настройка универсального действия . При выборе этого параметра универсальное действие открывает 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 . Имя функции Apps Script, которая выполняется при выборе.

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