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

Конфигурация ресурсов, используемая для определения содержимого и поведения надстройки Google Workspace . В манифестах надстройки 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 расширяет Календарь . Настройки внешнего вида и поведения дополнения Google Workspace в хост-приложении Google Календаря. Если это поле пропущено, дополнение отключено в Google Календаре.

chat

object ()

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

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

drive

object ( Drive )

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

gmail

object ( Gmail )

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

docs

object ( Docs )

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

sheets

object ( Sheets )

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

slides

object ( Slides )

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

meet

object object ( Meet )

Требуется, если дополнение Google Workspace расширяет Meet . Настройки внешнего вида и поведения дополнения Google Workspace в хост-приложении 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-адрес изображения, отображаемого на панели инструментов. URL-адрес должен быть общедоступным.

name

string

Обязательно. Имя надстройки, отображаемое на панели инструментов.

openLinkUrlPrefixes[]

string

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

Более подробную информацию см. в разделе «Разрешенные URL-адреса» .

universalActions[]

object ( UniversalAction )

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

boolean

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

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

LayoutProperties

Конфигурация, которая управляет цветами и внешним видом панели инструментов, а также кнопок надстройки 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, которая выполняется при выборе пользователем этого действия.

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