Recurso de manifiesto de complementos

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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

Complementos

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

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 Google Workspace complemento 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)

Obligatorio si el Google Workspace complemento extiende Calendario. Configuraciones para Google Workspace la apariencia y el comportamiento del complemento en la aplicación host del Calendario de Google Si omites este campo, el complemento estará inhabilitado en Calendario de Google.

drive

object (Drive)

Obligatorio si el Google Workspace complemento extiende Google Drive. Configuraciones para Google Workspace el aspecto y el comportamiento del complemento en la aplicación host de Google Drive Si omites este campo, el complemento estará inhabilitado en Google Drive.

gmail

object (Gmail)

Obligatorio si el Google Workspace complemento extiende Gmail. Configuraciones para Google Workspace la apariencia y el comportamiento del complemento en la aplicación host de Gmail. Si omites este campo, el complemento estará inhabilitado en Gmail.

docs

object (Docs)

Obligatorio si el Google Workspace complemento extiende Documentos. Configuraciones para la Google Workspace apariencia y el comportamiento del complemento en la aplicación host de Documentos Si omites este campo, el complemento estará inhabilitado en Documentos.

sheets

object (Sheets)

Obligatorio si el Google Workspace complemento extiende Hojas de cálculo. Configuraciones para la Google Workspace aparición y el comportamiento del complemento en la aplicación host de Hojas de cálculo Si omites este campo, el complemento estará inhabilitado en Hojas de cálculo.

slides

object (Slides)

Obligatorio si el Google Workspace complemento extiende Presentaciones. Configuraciones para la Google Workspace apariencia y comportamiento del complemento en la aplicación host de Presentaciones Si omites este campo, el complemento estará inhabilitado en Presentaciones.

Common

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

La especificación predeterminada de la función activadora para crear el complemento homepage. 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 construye una tarjeta genérica de la página principal y se usa cuando es necesario.
layoutProperties

object (LayoutProperties)

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

string

Obligatorio. La URL de la imagen que se muestra en la barra de herramientas.

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 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 Cómo incluir URL en la lista blanca 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 eventos de complementos que se pasan a las funciones de devolución de llamada de acción o las funciones de activación incluyen información sobre la configuración regional y la zona horaria del usuario. La configuración predeterminada es false.

Consulta Cómo acceder a la configuración regional y zona horaria del usuario para obtener más información.

Propiedades de diseño

Una configuración que controla la Google Workspacebarra de herramientas del complemento y los colores y el aspecto del botón.

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

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

Acción universal

Es una configuración para una acción universal. Cuando se selecciona, una acción universal abre el vínculo de la 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, 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.