Gli oggetti Action ti consentono di creare comportamenti interattivi nei componenti aggiuntivi di Google Workspace. Definiscono che cosa succede quando un utente interagisce con un widget (ad esempio un pulsante) nell'interfaccia utente del componente aggiuntivo.
Un'azione viene collegata a un determinato widget utilizzando una funzione di gestore del widget, che definisce anche la condizione che attiva l'azione. Quando viene attivata, l'azione esegue una funzione di callback designata. Alla funzione di callback viene passato un oggetto evento che contiene informazioni sulle interazioni lato client dell'utente. Devi implementare la funzione di callback e impostarla in modo che restituisca un oggetto di risposta specifico.
Ad esempio, supponiamo che tu voglia un pulsante che crei e mostri una nuova scheda quando viene selezionato. Per farlo, devi creare un nuovo widget pulsante e utilizzare la funzione di gestore del widget pulsante
setOnClickAction(action)
per impostare un Action per la creazione di schede. Il valore Action che definisci specifica una funzione di callback di Apps Script che viene eseguita quando viene fatto clic sul pulsante. In questo caso, implementa la funzione di callback per creare la scheda che ti interessa e restituire un oggetto ActionResponse. L'oggetto response indica al componente aggiuntivo di visualizzare la scheda creata dalla funzione di callback.
Questa pagina descrive le azioni dei widget specifiche di Gmail che puoi includere nel tuo plug-in.
Interazioni con Gmail
I componenti aggiuntivi di Google Workspace che estendono Gmail possono includere un'azione aggiuntiva del widget specifica per Gmail per scrivere le bozze dei messaggi. Questa azione richiede che la funzione di callback dell'azione associata restituisca un oggetto di risposta specializzato:
| Azione tentata | La funzione di callback deve restituire |
|---|---|
| Scrivere bozze di messaggi | ComposeActionResponse |
Per utilizzare queste azioni e questi oggetti di risposta dei widget, il componente aggiuntivo deve includere lo scopo https://www.googleapis.com/auth/gmail.addons.current.action.compose nel file manifest.
Scrivi un messaggio
Un componente aggiuntivo di Google Workspace che espande Gmail può
definire un widget che, quando viene interagito, genera bozze di messaggi in Gmail
(nuovi messaggi o risposte). Per farlo, devi associare il widget di attivazione a una funzione di callback che restituisce un oggetto ComposeActionResponse. Al termine dell'esecuzione della funzione di callback, Gmail utilizza questo oggetto risposta per aprire e compilare una finestra di composizione della bozza.
Per maggiori dettagli e un esempio, consulta Creare bozze di messaggi.