Recurso de manifiesto de complementos

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

AddOns

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

Representación JSON
{
  "common": {
    object (Common)
  },
  "calendar": {
    object (Calendar)
  },
  "drive": {
    object (Drive)
  },
  "gmail": {
    object (Gmail)
  },
  "docs": {
    object (Docs)
  },
  "sheets": {
    object (Sheets)
  },
  "slides": {
    object (Slides)
  }
}
Campos
common

object (Common)

Obligatorio. Define los valores de un complemento de Google Workspace que son comunes para todas las aplicaciones host. Algunos valores que se definen aquí se usan como predeterminados cuando se omiten valores específicos para un host en particular.

calendar

object (Calendar)

Obligatorio si el complemento de Google Workspace extiende Calendario. Parámetros de configuración de la apariencia y el comportamiento del complemento de Google Workspace en la aplicación host del Calendario de Google. Si se omite este campo, el complemento se inhabilita en el Calendario de Google.

drive

object (Drive)

Obligatorio si el complemento de Google Workspace extiende Google Drive. Parámetros de configuración 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)

Obligatorio si el complemento de Google Workspace extiende Gmail. Parámetros de configuración de la apariencia y el comportamiento del complemento de Google Workspace dentro de la aplicación host de Gmail. Si se omite este campo, el complemento se inhabilita en Gmail.

docs

object (Docs)

Obligatorio si el complemento de Google Workspace extiende Documentos. Parámetros de configuración de la apariencia y el comportamiento del complemento de Google Workspace en la aplicación host de Documentos. Si se omite este campo, el complemento se inhabilita en Documentos.

sheets

object (Sheets)

Obligatorio si el complemento de Google Workspace extiende Hojas de cálculo. Parámetros de configuración de la apariencia 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)

Es obligatorio si el complemento de Google Workspace extiende Presentaciones. Parámetros de configuración de la apariencia 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.

Nombre

La configuración del manifiesto para los parámetros comunes en cada aplicación host. Algunos valores que se definen 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)

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

object (LayoutProperties)

Una configuración de los colores utilizados en los botones y la barra de herramientas del complemento.
logoUrl

string

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

name

string

Obligatorio. El nombre del complemento que se muestra en la barra de herramientas.

openLinkUrlPrefixes[]

string

Es obligatorio si el complemento muestra vínculos de salida, ya sea dentro de widgets que usan un OpenLink o un widget de texto con etiquetas de anclaje HTML. Una lista de prefijos de URL HTTPS. Para proteger los datos del usuario, cualquier vínculo que renderice el complemento debe coincidir con uno de los prefijos de esta lista.

Consulta URLs incluidas en la lista de entidades permitidas para obtener más información.

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 de los complementos que se pasan a las funciones de devolución de llamada de acción o las funciones de activación incluyen la información de la configuración regional y la zona horaria del usuario. La configuración predeterminada es false.

Consulta Acceso a la configuración regional y las zonas horarias del usuario para obtener más información.

LayoutProperties

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

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

string

El color de la barra de herramientas. La configuración predeterminada es gris (#424242).
secondaryColor

string

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

UniversalAction

Es una configuración para 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 todas las acciones universales. 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 información.