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 los complementos de Google Workspace deben tener todos los componentes marcados como Obligatorios si extienden Gmail.

Gmail

Es la configuración del manifiesto del complemento de Google Workspace para las extensiones de Gmail. Consulta Cómo extender 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. 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 se dejó de usar para evitar una latencia de ejecución innecesaria. En cambio, el complemento debe 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 Extending the compose UI with compose actions para obtener más detalles.

contextualTriggers[]

object (ContextualTrigger)

Obligatorio. Es una lista de activadores que se activan cuando se abre un mensaje en Gmail. Cuando se activa el disparador, se 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 de activación 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 activación de composición. Las opciones válidas son las siguientes:

  • NONE, el parámetro de configuración predeterminado. Esto hace que el objeto de evento que se pasa a la función de activación de Compose esté casi vacío.
  • METADATA, que completa el objeto de evento que se pasa a la función de activación de redacció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 composición que crean IU de Compose. Sin embargo, esta lista está limitada a una sola acción por complemento. La acción de redactar tiene un ícono correspondiente que se presenta en la ventana de redacción de Gmail. El ícono se especifica con gmail.logoUrl.

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 activación contextual. Nombre de la función de Apps Script que se ejecuta cuando se activa el activador.

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

unconditional

object

Obligatorio para cada activación 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

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. Nombre de la función de Apps Script que se ejecuta cuando se selecciona esta acción de redacción. Esta función de activación de Compose compila la IU de Compose del complemento.

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

text

string

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