Gli oggetti Action
consentono di creare modelli
il comportamento dei componenti aggiuntivi di Google Workspace. Definiscono
cosa succede quando un utente interagisce con un widget (ad esempio un pulsante) in
l'interfaccia utente del componente aggiuntivo.
Viene collegata un'azione a un widget specifico utilizzando un funzione di gestore widget, che definisce anche la condizione che attiva l'azione. Quando viene attivato, esegue un'azione funzione di callback. La funzione di callback viene passata oggetto evento che trasporta informazioni sulle interazioni lato client dell'utente. Devi implementare le funzione callback e fare in modo che restituisca un oggetto di risposta specifico.
Ad esempio, supponi di voler creare un pulsante che crei e mostri una nuova scheda quando
selezionato. Per farlo, devi creare un nuovo widget del pulsante e usare quello del pulsante
funzione gestore
setOnClickAction(action)
per impostare la creazione di carte Action
. La
Action
che definisci specifica uno script di Google Apps
funzione di callback che viene eseguita quando l'utente fa clic sul pulsante. In questo caso,
di implementare la funzione di callback per creare la scheda desiderata e restituire un
ActionResponse
. L'oggetto response indica al componente aggiuntivo di visualizzare la scheda il callback
funzione creata.
In questa pagina vengono descritte le azioni dei widget specifiche per Gmail che puoi includere nel tuo come componente aggiuntivo.
Interazioni Gmail
I componenti aggiuntivi di Google Workspace che estendono Gmail possono includere un'altra azione widget specifica di Gmail per comporre bozze di messaggi. Questo richiede l'azione associata funzione di callback per restituire un oggetto risposta specializzato:
Azione tentata | La funzione di callback deve restituire |
---|---|
Scrivere bozze di messaggi | ComposeActionResponse |
Per utilizzare queste azioni del widget e gli oggetti di risposta, il componente aggiuntivo deve
includi il
https://www.googleapis.com/auth/gmail.addons.current.action.compose
scope nel file manifest.
Scrivere un messaggio
Un componente aggiuntivo di Google Workspace che estende Gmail può
definisci un widget che, durante l'interazione, genera bozze di messaggi in Gmail
(nuovi messaggi o risposte). Per farlo, devi associare l'attivatore
con una funzione di callback che restituisce un
ComposeActionResponse
. Al termine dell'esecuzione della funzione di callback, Gmail utilizza questo
risposta per aprire e completare una finestra di composizione della bozza.
Per ulteriori dettagli e un esempio, vedi Scrivere bozze di messaggi.