Recurso de 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 extensiones de Gmail. Consulta Cómo extender 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. 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 cambio, el complemento debería generar 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 se redacta un correo electrónico.

Consulta Cómo extender 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 un mensaje se abre 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)

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

ComposeTrigger

La configuración para 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, la configuración predeterminada. Esto hace que el objeto de evento que se pasa a la función de activador de composición esté casi vacío.
  • METADATA, que propaga el objeto de evento pasado a la función activadora de composición con listas de destinatarios del mensaje. Esta configuración requiere que el complemento incluya el permiso de gmail.addons.current.message.metadata.
selectActions[]

object (SelectAction)

Una lista de acciones de composición 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 un ícono correspondiente presentado en la ventana de redacción de Gmail. gmail.logoUrl especifica el ícono.

ContextualTrigger

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 del mensaje para obtener más información.

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

string

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

Consulta la 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 en todos los mensajes de Gmail cuando se abran. Esta es la única opción, por lo que siempre debe ser un objeto vacío.

SeleccionarAcción

La configuración de 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.

Para obtener más detalles, consulta Función activador de Compose.

text

string

Obligatorio para las acciones de redacción. Una descripción breve en texto de esta acción de redacción.