Package google.apps.script.type.gmail

Indice

• ComposeTrigger (messaggio)
• ComposeTrigger.DraftAccess (enum)
• ContextualTrigger (messaggio)
• GmailAddOnManifest (messaggio)
• UnconditionalTrigger (messaggio)
• UniversalAction (messaggio)

ComposeTrigger

Un trigger che si attiva quando l'utente sta scrivendo un'email.

Campi
actions[]	MenuItemExtensionPoint Definisce l'insieme di azioni per un componente aggiuntivo al momento della composizione. Si tratta di azioni che gli utenti possono attivare su un componente aggiuntivo al momento della composizione.
draftAccess	DraftAccess Definisce il livello di accesso ai dati quando viene attivato un componente aggiuntivo al momento della compilazione.

DraftAccess

Un enum che definisce il livello di accesso ai dati richiesto dall'attivatore di composizione.

Enum
UNSPECIFIED	Valore predefinito quando non è impostato nulla per draftAccess.
NONE	L'attivatore di composizione non può accedere ai dati della bozza quando viene attivato un componente aggiuntivo di composizione.
METADATA	Conferisce all'attivatore di composizione l'autorizzazione per accedere ai metadati della bozza quando viene attivato un componente aggiuntivo di composizione. Sono inclusi l'elenco del pubblico, ad esempio l'elenco A e Cc di una bozza di messaggio.

ContextualTrigger

Definisce un attivatore che si attiva quando l'email aperta soddisfa determinati criteri. Quando viene attivato, l'attivatore esegue un endpoint specifico, in genere per creare nuove schede e aggiornare l'interfaccia utente.

Campi
onTriggerFunction	string Obbligatorio. Il nome dell'endpoint da chiamare quando un messaggio corrisponde all'attivatore.
Campo unione trigger. Il tipo di attivatore determina le condizioni utilizzate da Gmail per mostrare il componente aggiuntivo. trigger può essere solo uno dei seguenti:
unconditional	UnconditionalTrigger Gli attivatori incondizionati vengono eseguiti quando viene aperto qualsiasi messaggio di posta.

GmailAddOnManifest

Proprietà che personalizza l'aspetto e l'esecuzione di un componente aggiuntivo di Gmail.

Campi
homepageTrigger	HomepageExtensionPoint Definisce un endpoint che verrà eseguito in contesti che non corrispondono a un attivatore contestuale dichiarato. Le schede generate da questa funzione saranno sempre disponibili per l'utente, ma potrebbero essere eclissate dai contenuti contestuali quando questo componente aggiuntivo dichiara attivatori più mirati. Se presente, sostituisce la configurazione di addOns.common.homepageTrigger.
contextualTriggers[]	ContextualTrigger Definisce l'insieme di condizioni che attivano il componente aggiuntivo.
universalActions[]	UniversalAction Definisce un insieme di azioni universali per il componente aggiuntivo. L'utente attiva le azioni universali dal menu della barra degli strumenti del componente aggiuntivo.
composeTrigger	ComposeTrigger Definisce l'attivatore del momento di composizione per un componente aggiuntivo del momento di composizione. Si tratta dell'attivatore che fa sì che un componente aggiuntivo intervenga quando l'utente sta scrivendo un'email. Tutti i componenti aggiuntivi al momento della composizione devono avere l'ambito gmail.addons.current.action.compose, anche se potrebbero non modificare la bozza.
authorizationCheckFunction	string Il nome di un endpoint che verifica che il componente aggiuntivo disponga di tutte le autorizzazioni di terze parti richieste, eseguendo sondaggi sulle API di terze parti. Se la verifica non va a buon fine, la funzione deve generare un'eccezione per avviare il flusso di autorizzazione. Questa funzione viene chiamata prima di ogni chiamata del componente aggiuntivo per garantire un'esperienza utente fluida.

UnconditionalTrigger

Questo tipo non contiene campi.

Un trigger che si attiva quando viene aperto un messaggio email.

UniversalAction

Un'azione sempre disponibile nel menu della barra degli strumenti del componente aggiuntivo, indipendentemente dal contesto del messaggio.

Campi
text	string Obbligatorio. Testo visibile all'utente che descrive l'azione, ad esempio "Aggiungi un nuovo contatto".
Campo unione action_type. Il tipo di azione determina il comportamento di Gmail quando l'utente la richiama. action_type può essere solo uno dei seguenti:
openLink	string Un link che viene aperto da Gmail quando l'utente attiva l'azione.
runFunction	string Un endpoint chiamato quando l'utente attiva l'azione. Per maggiori dettagli, consulta la guida alle azioni universali.