Recurso de manifiesto de complementos

Es la configuración de recursos que se usa para definir el contenido y el comportamiento del complemento de Google Workspace. Los manifiestos de complementos de Google Workspace deben tener todos los componentes marcados como Obligatorios.

AddOns

Es la configuración del manifiesto del complemento de Google Workspace de nivel superior.

Representación 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)
  }
}
Campos
common

object (Common)

Obligatorio. Define valores para un complemento de Google Workspace que son comunes para cada aplicación host. Algunos valores definidos aquí se usan como predeterminados cuando se omiten valores específicos para un host en particular.

calendar

object (Calendar)

Se requiere si el complemento de Google Workspace extiende Calendario. Son las configuraciones para la apariencia y el comportamiento del complemento de Google Workspace en la aplicación host de Calendario de Google. Si se omite este campo, el complemento se inhabilitará en Calendario de Google.

chat

object ()

Se requiere si el complemento de Google Workspace extiende Chat. Es la configuración de una app de Google Chat. Si se omite este campo, el complemento se inhabilita en Google Chat.

El objeto addOns.chat debe estar vacío. Para configurar el comportamiento y la apariencia del complemento en Chat, consulta Cómo configurar una app de Chat.
drive

object (Drive)

Se requiere si el complemento de Google Workspace extiende Google Drive. Son las configuraciones de la apariencia y el comportamiento del complemento de Google Workspace en la aplicación host de Google Drive. Si se omite este campo, el complemento se inhabilita en Google Drive.

gmail

object (Gmail)

Se requiere si el complemento de Google Workspace extiende Gmail. Son las configuraciones de la apariencia y el comportamiento del complemento de Google Workspace en la aplicación host de Gmail. Si se omite este campo, el complemento se inhabilita en Gmail.

docs

object (Docs)

Se requiere si el complemento de Google Workspace extiende Documentos. Son las configuraciones del aspecto y el comportamiento del complemento de Google Workspace dentro de la aplicación host de Documentos. Si se omite este campo, el complemento se inhabilitará en Documentos.

sheets

object (Sheets)

Se requiere si el complemento de Google Workspace extiende Hojas de cálculo. Son las configuraciones del aspecto y el comportamiento del complemento de Google Workspace en la aplicación host de Hojas de cálculo. Si se omite este campo, el complemento se inhabilita en Hojas de cálculo.

slides

object (Slides)

Se requiere si el complemento de Google Workspace extiende Presentaciones. Son los parámetros de configuración del aspecto y el comportamiento del complemento de Google Workspace en la aplicación host de Presentaciones. Si se omite este campo, el complemento se inhabilita en Presentaciones.

Común

Es la configuración del manifiesto para los parámetros que son comunes a cada aplicación host. Algunos valores definidos aquí se usan como predeterminados cuando se omiten valores específicos para un host en particular.

Representación JSON 
{
  "homepageTrigger": {
    object (HomepageTrigger)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "logoUrl": string,
  "name": string,
  "openLinkUrlPrefixes": [
    string
  ],
  "universalActions": [
    {
      object (UniversalAction)
    }
  ],
  "useLocaleFromApp": boolean
}
Campos
homepageTrigger

object (HomepageTrigger)

Es la especificación predeterminada de la función de activación para crear la página principal del complemento. Esta especificación se usa si no se define un activador de página principal específico del host. Si también se omite, se construye una tarjeta genérica de la página principal y se usa cuando es necesario.
layoutProperties

object (LayoutProperties)

Es una configuración para los colores que se usan en la barra de herramientas y los botones del complemento.
logoUrl

string

Obligatorio. Es la URL de la imagen que se muestra en la barra de herramientas. La URL debe ser pública.
name

string

Obligatorio. Nombre del complemento que se muestra en la barra de herramientas.
openLinkUrlPrefixes[]

string

Se requiere si el complemento muestra vínculos externos, ya sea dentro de widgets con un OpenLink o un widget de texto con etiquetas de anclaje HTML. Es una lista de prefijos de URL HTTPS. Para proteger los datos del usuario, cualquier vínculo renderizado por el complemento debe coincidir con uno de los prefijos de esta lista.

Consulta URLs de la lista de entidades permitidas para obtener más detalles.

universalActions[]

object (UniversalAction)

Lista de acciones universales que siempre están disponibles en la IU del complemento.
useLocaleFromApp

boolean

Si es true, los objetos de evento del complemento que se pasan a las funciones de devolución de llamada de acción o a las funciones de activación incluyen la información de configuración regional y zona horaria del usuario. El valor predeterminado es false.

Consulta Cómo acceder a la configuración regional y a las zonas horarias del usuario para obtener más detalles.

LayoutProperties

Es una configuración que controla los colores y la apariencia de la barra de herramientas y los botones del complemento de Google Workspace.

Representación JSON 
{
  "primaryColor": string,
  "secondaryColor": string
}
Campos
primaryColor

string

Color de la barra de herramientas. El valor predeterminado es gris (#424242).
secondaryColor

string

Es el color predeterminado de los botones. El valor predeterminado es el color principal (si está configurado); de lo contrario, el valor predeterminado es el azul (código hexadecimal #2196F3).

UniversalAction

Es la configuración de una acción universal. Cuando se selecciona, una acción universal abre el vínculo de URL especificado o ejecuta la función de Apps Script especificada.

Representación 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.

}
Campos
label

string

Obligatorio para cada acción universal. Es el texto que se muestra en el menú de la IU para esta acción.
runFunction

string

Obligatorio para cada acción universal si openLink no está presente. Si se proporciona, es el nombre de la función de Apps Script que se ejecuta cuando el usuario selecciona esta acción.

Consulta la guía de acciones universales para obtener más detalles.