The resource configuration that is used to define Google Workspace add-on content and behavior. Google Workspace add-on manifests must have all the components marked as Required.
AddOns
The top-level of the Google Workspace add-on manifest configuration.
JSON representation |
---|
{ "common": { object (Common) }, "calendar": { object (Calendar) }, "chat": { object (Chat) }, "drive": { object (Drive) }, "gmail": { object (Gmail) }, "docs": { object (Docs) }, "sheets": { object (Sheets) }, "slides": { object (Slides) } } |
Fields | |
---|---|
common |
Required. Defines values for a Google Workspace add-on that are common for every host application. Some values defined here are used as a default when specific values for a particular host are omitted. |
calendar |
Required if the Google Workspace add-on extends Calendar. Configurations for Google Workspace add-on appearance and behavior within the Google Calendar host application. If this field is omitted, the add-on is disabled in Google Calendar. |
chat |
Required if the Google Workspace add-on extends Chat. Configuration of a Google Chat app. If this field is omitted, the add-on is disabled in Google Chat. The |
drive |
Required if the Google Workspace add-on extends Google Drive. Configurations for Google Workspace add-on appearance and behavior within the Google Drive host application. If this field is omitted, the add-on is disabled in Google Drive. |
gmail |
Required if the Google Workspace add-on extends Gmail. Configurations for Google Workspace add-on appearance and behavior within the Gmail host application. If this field is omitted, the add-on is disabled in Gmail. |
docs |
Required if the Google Workspace add-on extends Docs. Configurations for the Google Workspace add-on's appearance and behavior within the Docs host application. If this field is omitted, the add-on is disabled in Docs. |
sheets |
Required if the Google Workspace add-on extends Sheets. Configurations for the Google Workspace add-on's appearance and behavior within the Sheets host application. If this field is omitted, the add-on is disabled in Sheets. |
slides |
Required if the Google Workspace add-on extends Slides. Configurations for the Google Workspace add-on's appearance and behavior within the Slides host application. If this field is omitted, the add-on is disabled in Slides. |
Common
The manifest configuration for parameters that are common for every host application. Some values defined here are used as a default when specific values for a particular host are omitted.
JSON representation |
---|
{ "homepageTrigger": { object (HomepageTrigger) }, "layoutProperties": { object (LayoutProperties) }, "logoUrl": string, "name": string, "openLinkUrlPrefixes": [ string ], "universalActions": [ { object (UniversalAction) } ], "useLocaleFromApp": boolean } |
Fields | |
---|---|
homepageTrigger |
|
layoutProperties |
|
logoUrl |
Required. The URL of the image shown in the toolbar. The URL must be public. |
name |
Required. The name of the add-on shown in the toolbar. |
openLinkUrlPrefixes[] |
Required if the add-on displays any outbound links, whether within
widgets using an
See Allowlist URLs for more details. |
universalActions[] |
|
useLocaleFromApp |
If See Accessing user locale and timezones for more details. |
LayoutProperties
A configuration that controls the Google Workspace add-on toolbar and button colors and appearance.
JSON representation |
---|
{ "primaryColor": string, "secondaryColor": string } |
Fields | |
---|---|
primaryColor |
|
secondaryColor |
|
UniversalAction
A configuration for a universal action. When selected, a universal action either opens the specified URL link, or runs the specified Apps Script function.
JSON representation |
---|
{ "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. } |
Fields | |
---|---|
label |
|
openLink |
runFunction is
not present. If provided, the URL that is opened in a tab
when the user selects this action.
|
runFunction |
openLink is
not present. If provided, the name of the Apps
Script function that executes when the user selects this action.
See the Universal actions guide for details. |