Recurso del manifiesto de Gmail

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

Gmail

La configuración del manifiesto del complemento de Google Workspace para las extensiones de Gmail Consulta Cómo ampliar Gmail con complementos de Google Workspace para obtener más información.

Representación JSON
{
  "authorizationCheckFunction": string,
  "composeTrigger": {
    object (ComposeTrigger)
  },
  "contextualTriggers": [
    {
      object (ContextualTrigger)
    }
  ],
  "homepageTrigger": {
    object (HomepageTrigger)
  }
}
Campos
authorizationCheckFunction

string

Obsoleto. Es el nombre de una función de Apps Script que realiza verificaciones de requisitos de autorización de terceros. Se llama a esta función antes de cada invocación del complemento de Google Workspace.

Esta función dejó de estar disponible para evitar latencia de ejecución innecesaria. En su lugar, el complemento debe generar una excepción de la invocación principal, como se muestra en este ejemplo.

composeTrigger

object (ComposeTrigger)

Obligatorio para las acciones de composición. Define el conjunto de IU disponibles para el usuario mientras redacta un correo electrónico.

Consulta Ampliación de la IU de Compose con más acciones para obtener más información.

contextualTriggers[]

object (ContextualTrigger)

Obligatorio. Es una lista de activadores que se activan cuando se abre un mensaje en Gmail. Cuando se activa el activador, se ejecuta una función específica de Apps Script, por lo general, para crear tarjetas nuevas y actualizar la IU.
homepageTrigger

object (HomepageTrigger)

La especificación de la función del activador para crear la página principal del complemento en el host de Gmail Esto anula addOns.common.homepageTrigger.

ComposeTrigger

Es la configuración de una acción de composición. Consulta Cómo extender la IU de Compose para obtener más información.

Representación JSON
{
  "draftAccess": string,
  "selectActions": [
    {
      object (SelectAction)
    }
  ]
}
Campos
draftAccess

string

Define el nivel de acceso a los datos disponible para una función de activador de composición. Las opciones válidas son las siguientes:

  • NONE, el parámetro de configuración predeterminado. Esto hace que el objeto del evento que se pasa a la función de activador de compose esté casi vacío.
  • METADATA, que propaga el objeto de evento que se pasa a la función del activador de composición con listas de destinatarios del mensaje. Este parámetro de configuración requiere que el complemento incluya el permiso gmail.addons.current.message.metadata.
selectActions[]

object (SelectAction)

Es una lista de acciones de Compose que crean IUs de Compose. Sin embargo, esta lista se limita a una sola acción por complemento. La acción de escribir tiene un ícono correspondiente que se presenta en la ventana de redacción de Gmail. gmail.logoUrl especifica el ícono.

ContextualTrigger

Es la configuración de un activador que se activa cuando el usuario abre un mensaje de Gmail y ese mensaje satisface ciertos criterios. Consulta Cómo extender la IU de mensajes para obtener más información.

Representación JSON
{
  "onTriggerFunction": string,
  "unconditional": {},
}
Campos
onTriggerFunction

string

Obligatorio para cada activador contextual. Es el nombre de la función de Apps Script que se ejecuta cuando se activa el activador.

Consulta Función de activador contextual para obtener detalles sobre cómo definir esta función.

unconditional

object

Obligatorio para cada activador contextual. Se usa para especificar que el activador contextual se activa para todos los mensajes de Gmail cuando se abren. Actualmente, esta es la única opción, por lo que siempre debe ser un objeto vacío.

SelectAction

La configuración de la acción de composición que define qué función se debe ejecutar cuando el usuario selecciona la acción de composición.

Representación JSON
{
  "runFunction": string,
  "text": string
}
Campos
runFunction

string

Obligatorio para las acciones de composición. Es el nombre de la función de Apps Script que se ejecuta cuando se selecciona esta acción de composición. Esta función de activador de Compose compila la IU de Compose del complemento.

Consulta Función de activador de Compose para obtener más detalles.

text

string

Obligatorio para las acciones de composición. Es una breve descripción de texto de esta acción de composición.