Gli oggetti Action ti consentono di integrare un comportamento interattivo nei componenti aggiuntivi di Google Workspace. Definiscono
cosa succede quando un utente interagisce con un widget (ad esempio un pulsante) nell'UI
del componente aggiuntivo.
Un'azione viene collegata a un determinato widget utilizzando una funzione di gestione dei 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 farle restituire un oggetto di risposta specifico.
Ad esempio, supponiamo che tu voglia un pulsante che crei e visualizzi una nuova scheda quando
viene fatto clic. A questo scopo, devi creare un nuovo widget pulsante e utilizzare la funzione di gestione del widget pulsante
setOnClickAction(action)
per impostare un Action per la creazione di schede. Il
Action che definisci specifica una funzione di callback Apps Script che viene eseguita quando viene fatto clic sul pulsante. In questo caso, implementi la funzione di callback per creare la scheda che vuoi e restituire un oggetto ActionResponse. L'oggetto risposta 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 componente aggiuntivo.
Interazioni con Gmail
I componenti aggiuntivi di Google Workspace che estendono Gmail possono includere un'azione widget specifica di Gmail per comporre bozze di messaggi. Questa azione richiede che la funzione di callback associata restituisca un oggetto 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 Google Workspace deve includere
https://www.googleapis.com/auth/gmail.addons.current.action.compose
ambito nel
manifest.
Scrivere un messaggio
I componenti aggiuntivi che estendono Gmail possono definire un widget che, quando viene utilizzato, genera bozze di messaggi in Gmail (nuovi messaggi o risposte). A questo scopo,associa 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 compilare una finestra di composizione.
Per maggiori dettagli ed esempi, vedi Comporre bozze di messaggi.