Risorsa manifest di Gmail

La configurazione delle risorse utilizzata per definire i contenuti e il comportamento del componente aggiuntivo Google Workspace all'interno di Gmail. I manifest dei componenti aggiuntivi di Google Workspace devono includere 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 maggiori dettagli, vedi Estendere Gmail con i componenti aggiuntivi di 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 di autorizzazione di terze parti.

Questa funzione è deprecata. Il componente aggiuntivo deve invece generare un'eccezione dalla chiamata principale, come mostrato nell'esempio di configurazione OAuth non Google.

composeTrigger

object (ComposeTrigger)

Obbligatorio per le azioni di composizione. Definisce le UI disponibili durante la composizione di un'email.

Per maggiori dettagli, vedi 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. I trigger eseguono una funzione Apps Script specifica per aggiornare l'interfaccia utente.
homepageTrigger

object (HomepageTrigger)

La funzione di attivazione del componente aggiuntivo homepage in Gmail. Questa azione sostituisce addOns.common.homepageTrigger.

ComposeTrigger

La configurazione di un'azione di composizione. Per ulteriori dettagli, consulta Estensione della UI di composizione.

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

string

Definisce il livello di accesso ai dati per una funzione di trigger di composizione. Le opzioni valide includono:

  • NONE (impostazione predefinita): l'oggetto evento è per lo più vuoto.
  • METADATA: L'oggetto evento include gli elenchi dei destinatari. Ciò richiede lo gmail.addons.current.message.metadata scope.
selectActions[]

object (SelectAction)

Un elenco di azioni per la scrittura. L'elenco è limitato a una sola azione per componente aggiuntivo. L'azione di composizione ha un'icona nella finestra di Gmail, specificata da gmail.logoUrl.

ContextualTrigger

La configurazione di un trigger che si attiva quando un utente apre un messaggio di Gmail. Per maggiori dettagli, consulta Estensione della UI 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.
unconditional

object

Obbligatorio per ogni trigger contestuale. Specifica che il trigger si attiva per tutti i messaggi Gmail aperti. Deve sempre essere un oggetto vuoto.

SelectAction

La configurazione dell'azione di composizione che definisce la funzione da eseguire quando viene selezionata.

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

string

Obbligatorio per le azioni di composizione. Il nome della funzione Apps Script eseguita quando viene selezionata. La funzione crea l'interfaccia utente di composizione del componente aggiuntivo.
text

string

Obbligatorio per le azioni di composizione. Una breve descrizione dell'azione.