Azioni di Gmail

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.