Risorsa manifest di Gmail

La configurazione delle risorse utilizzata per definire i contenuti e il comportamento del componente aggiuntivo di Google Workspace all'interno di Gmail. I manifest dei componenti aggiuntivi di Google Workspace devono avere tutti i componenti contrassegnati come Obbligatori se estendono Gmail.

Gmail

Configurazione del file manifest del componente aggiuntivo Google Workspace per le estensioni di Gmail. Per saperne di più, consulta Estendere Gmail con i componenti aggiuntivi Google Workspace.

Rappresentazione JSON 
{
  "authorizationCheckFunction": string,
  "composeTrigger": {
    object (ComposeTrigger)
  },
  "contextualTriggers": [
    {
      object (ContextualTrigger)
    }
  ],
  "homepageTrigger": {
    object (HomepageTrigger)
  }
}
Campi
authorizationCheckFunction

string

Deprecato. Il nome di una funzione Apps Script che esegue controlli dei requisiti di autorizzazione di terze parti. Questa funzione viene chiamata prima di ogni chiamata del componente aggiuntivo Google Workspace.

Questa funzione è stata ritirata per evitare latenza di esecuzione non necessaria. L'add-on deve invece generare un'eccezione dall'invocazione principale, come mostrato in questo esempio.

composeTrigger

object (ComposeTrigger)

Obbligatorio per le azioni di composizione. Definisce l'insieme di interfacce utente disponibili per l'utente durante la composizione di un'email.

Per maggiori dettagli, consulta Estendere la UI di composizione con le azioni di composizione.

contextualTriggers[]

object (ContextualTrigger)

Obbligatorio. Un elenco di trigger che vengono attivati quando un messaggio viene aperto in Gmail. Quando viene attivato il trigger, viene eseguita una funzione Apps Script specifica, in genere per creare nuove schede e aggiornare la UI.
homepageTrigger

object (HomepageTrigger)

La specifica della funzione di attivazione per la creazione del componente aggiuntivo homepage nell'host Gmail. Questa azione sostituisce addOns.common.homepageTrigger.

ComposeTrigger

La configurazione di un'azione di composizione. Per ulteriori informazioni, consulta Estensione dell'interfaccia utente di Compose.

Rappresentazione JSON 
{
  "draftAccess": string,
  "selectActions": [
    {
      object (SelectAction)
    }
  ]
}
Campi
draftAccess

string

Definisce il livello di accesso ai dati disponibile per una funzione di trigger di composizione. Le opzioni valide sono le seguenti:

  • NONE, l'impostazione predefinita. In questo modo, l'oggetto evento passato alla funzione di attivazione di composizione è per lo più vuoto.
  • METADATA, che popola l'oggetto evento passato alla funzione di attivazione della composizione con elenchi di destinatari del messaggio. Questa impostazione richiede che il componente aggiuntivo includa gmail.addons.current.message.metadata ambito.
selectActions[]

object (SelectAction)

Un elenco di azioni di composizione che creano interfacce utente di composizione; tuttavia, questo elenco è limitato a una sola azione per componente aggiuntivo. L'azione di composizione ha un'icona corrispondente nella finestra di composizione di Gmail. L'icona è specificata da gmail.logoUrl.

ContextualTrigger

La configurazione di un trigger che si attiva quando l'utente apre un messaggio Gmail e questo messaggio soddisfa determinati criteri. Per saperne di più, consulta Estensione dell'interfaccia utente dei messaggi.

Rappresentazione JSON 
{
  "onTriggerFunction": string,
  "unconditional": {},
}
Campi
onTriggerFunction

string

Obbligatorio per ogni trigger contestuale. Il nome della funzione Apps Script eseguita quando viene attivato il trigger.

Consulta Funzione di attivazione contestuale per informazioni dettagliate su come definire questa funzione.

unconditional

object

Obbligatorio per ogni trigger contestuale. Utilizzato per specificare che il trigger contestuale si attiva per tutti i messaggi Gmail quando vengono aperti. Al momento questa è l'unica opzione, quindi deve sempre essere un oggetto vuoto.

SelectAction

La configurazione dell'azione di composizione che definisce la funzione da eseguire quando l'utente seleziona l'azione di composizione.

Rappresentazione JSON 
{
  "runFunction": string,
  "text": string
}
Campi
runFunction

string

Obbligatorio per le azioni di composizione. Il nome della funzione Apps Script che viene eseguita quando viene selezionata questa azione di composizione. Questa funzione di attivazione di composizione crea la UI di composizione del componente aggiuntivo.

Per i dettagli, consulta Funzione di attivazione di composizione.

text

string

Obbligatorio per le azioni di composizione. Una breve descrizione testuale di questa azione di composizione.