Recurso de manifiesto de complementos

La configuración de recursos que se utiliza 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 Obligatorio.

Complementos

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 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 complemento de Google Workspace extiende el Calendario. Configuraciones de apariencia y comportamiento del complemento de Google Workspace en la aplicación host de Calendario de Google. Si se omite este campo, el complemento estará inhabilitado 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 en la aplicación host de Google Drive. Si se omite este campo, el complemento estará inhabilitado en Google Drive.

gmail

object (Gmail)

Obligatorio si el complemento de Google Workspace extiende Gmail. Configuraciones del aspecto y el comportamiento de los complementos de Google Workspace en la aplicación host de Gmail Si se omite este campo, el complemento estará inhabilitado en Gmail.

docs

object (Docs)

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

sheets

object (Sheets)

Obligatorio si el complemento de Google Workspace extiende Hojas de cálculo. Configuraciones para 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 estará inhabilitado en Hojas de cálculo.

slides

object (Slides)

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

Common

La configuración del manifiesto para parámetros que son comunes a todas las aplicaciones de 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 de activación para crear el complemento en la página principal. Esta especificación se usa si no se define un activador de página principal específico para el 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 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. La URL debe ser pública.

name

string

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

openLinkUrlPrefixes[]

string

Obligatorio si el complemento muestra algún vínculo saliente, 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 renderice el complemento debe coincidir con uno de los prefijos de esta lista.

Consulta Cómo incluir URL 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 eventos del complemento que se pasan a las funciones de devolución de llamada de acción o a 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 a las zonas horarias de los usuarios para obtener más detalles.

Propiedades de la función de diseño

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

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, el valor es azul (#2196F3).

Acción universal

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. El texto que se muestra en el menú de la IU para esta acción.
runFunction

string

Obligatorio para cada acción universal si no hay openLink 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 detalles.