Recurso del manifiesto de Gmail

La configuración de recursos que se utiliza para definir el contenido y el comportamiento del complemento de Google Workspace en Gmail Los manifiestos del complemento de Google Workspace deben tener todos los componentes marcados como Obligatorio si extienden Gmail.

Gmail

La configuración del manifiesto del complemento de Google Workspace para las extensiones de Gmail Consulta Amplía Gmail con los 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 una latencia de ejecución innecesaria. En su lugar, el complemento debería arrojar una excepción desde la invocación principal, como se muestra en este ejemplo.

composeTrigger

object (ComposeTrigger)

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

Consulta Cómo ampliar la IU de Compose con acciones de redacción para obtener más detalles.

contextualTriggers[]

object (ContextualTrigger)

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

object (HomepageTrigger)

Es 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

La configuración de una acción de redacció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 es el parámetro de configuración predeterminado. Esto hace que el objeto de evento que se pasa a la función del activador de Compose esté casi vacío.
  • METADATA, que propaga el objeto del evento que se pasó a la función del activador de redacción con listas de destinatarios del mensaje. Esta configuración requiere que el complemento incluya el permiso gmail.addons.current.message.metadata.
selectActions[]

object (SelectAction)

Una lista de acciones de Compose que crean IU de Compose. Sin embargo, esta lista está limitada a una sola acción por complemento. La acción de redacción tiene el ícono correspondiente que se presenta en la ventana de redacción de Gmail. El ícono se especifica mediante gmail.logoUrl.

ContextualTrigger

Es la configuración de un activador que se activa cuando el usuario abre un mensaje de Gmail y ese mensaje cumple con ciertos criterios. Consulta Cómo extender la IU del mensaje 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 active para todos los mensajes de Gmail cuando se abran. Por el momento, esta es la única opción, por lo que siempre debe ser un objeto vacío.

SelectAction

Es la configuración de la acción de redacción que define qué función ejecutar cuando el usuario selecciona la acción de redacción.

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

string

Obligatorio para las acciones de redacción. Es el nombre de la función de Apps Script que se ejecuta cuando se selecciona esta acción de redacció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 redacción. Es una descripción textual breve de esta acción de redacción.