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 del complemento de Google Workspace deben tener todos los componentes marcados como Obligatorios.

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 definidos aquí se usan como predeterminados cuando se omiten valores específicos para un host en particular.

calendar

object (Calendar)

Es obligatoria si el complemento de Google Workspace extiende el Calendario. Parámetros de configuración del aspecto y el comportamiento del complemento de Google Workspace dentro de 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. Configuraciones del aspecto y el comportamiento del complemento de Google Workspace dentro de la aplicación host de Google Drive. Si se omite, el complemento se inhabilita en Google Drive.

gmail

object (Gmail)

Obligatorio si el complemento de Google Workspace extiende Gmail. Configuraciones 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. Configuraciones de la apariencia y el comportamiento del complemento de Google Workspace dentro de la aplicación host de Documentos. Si se omite, el complemento se inhabilita en Documentos.

sheets

object (Sheets)

Obligatorio si el complemento de Google Workspace extiende Hojas de cálculo. Configuraciones de la apariencia y el comportamiento del complemento de Google Workspace dentro de 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)

Obligatorio si el complemento de Google Workspace extiende Presentaciones. Configuraciones de la apariencia y el comportamiento del complemento de Google Workspace dentro de la aplicación host de Presentaciones. Si se omite, el complemento se inhabilita en Presentaciones.

Common

La configuración del manifiesto para parámetros 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.

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

object (HomepageTrigger)

Especificación de la función del activador predeterminada para crear la página principal del complemento. Esta especificación se utiliza si no se define un activador de la 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 de los colores que se usan en los botones y la barra de herramientas del complemento.
logoUrl

string

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

name

string

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

openLinkUrlPrefixes[]

string

Obligatorio si el complemento muestra vínculos de salida, ya sea dentro de los 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 genere el complemento debe coincidir con uno de los prefijos de esta lista.

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

universalActions[]

object (UniversalAction)

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

boolean

Si es true, los objetos de eventos del complemento que se pasan a las funciones de devolución de llamada de acción o las funciones del activador incluyen la información de la configuración regional y la zona horaria del usuario. La configuración predeterminada es false.

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

LayoutProperties

Es una configuración que controla la barra de herramientas del complemento Google Workspacey los colores y el aspecto de los botones.

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

string

El color de la barra de herramientas El color 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, 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 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, 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.