Gli oggetti Action consentono di creare un comportamento
interattivo nei componenti aggiuntivi di Google Workspace. Definiscono cosa accade quando un utente interagisce con un widget (ad esempio, un pulsante) nell'interfaccia utente del componente aggiuntivo.
Un'azione viene associata a un determinato widget utilizzando una funzione gestore 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 trasmesso un oggetto evento che trasporta informazioni sulle interazioni lato client dell'utente. Devi implementare la funzione di callback e fare in modo che restituisca un oggetto di risposta specifico.
Ad esempio, supponiamo che tu voglia un pulsante che crei e visualizzi una nuova scheda quando viene fatto clic. Per farlo, devi creare un nuovo widget dei pulsanti e utilizzare la funzione di gestione del widget setOnClickAction(action) per impostare una creazione di schede Action. 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, implementerai la funzione di callback per creare la scheda che ti interessa e restituire un oggetto ActionResponse. L'oggetto risposta indica al componente aggiuntivo di visualizzare la scheda creata dalla funzione di callback.
In questa pagina vengono descritte le azioni dei widget specifiche per Gmail che puoi includere nel componente aggiuntivo.
Interazioni con Gmail
I componenti aggiuntivi di Google Workspace che estendono Gmail possono includere un'azione widget aggiuntiva specifica di Gmail per scrivere bozze di messaggi. Questa azione richiede la funzione di callback dell'azione associata per restituire un oggetto di risposta specializzato:
| Azione tentata | La funzione di callback deve restituire |
|---|---|
| Scrivere bozze di messaggi | ComposeActionResponse |
Per utilizzare queste azioni widget e questi oggetti risposta, il componente aggiuntivo deve includere l'https://www.googleapis.com/auth/gmail.addons.current.action.compose
ambito nel file manifest.
Scrivere un messaggio
Un componente aggiuntivo di Google Workspace che estende Gmail può
definire un widget che, quando si interagisce con questo, genera bozze di messaggi in Gmail
(nuovi messaggi o risposte). A tal fine, 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 di risposta per aprire e completare una finestra di scrittura di bozza.
Per ulteriori dettagli e un esempio, vedi Scrivere bozze di messaggi.