Attivatori per i componenti aggiuntivi di Google Workspace

I trigger Apps Script fanno sì che una funzione di script specificata (la funzione trigger) venga eseguita ogni volta che si verifica un evento specificato. Solo determinati eventi possono attivare i trigger e ogni applicazione Google Workspace supporta un insieme diverso di eventi.

Quando viene attivato un trigger, viene creato un oggetto evento. Questa struttura JSON contiene i dettagli dell'evento verificatosi. Le informazioni nella struttura dell'oggetto evento sono organizzate in modo diverso in base al tipo di trigger.

Una volta creato l'oggetto evento, Apps Script lo trasmette come parametro alla funzione trigger. La funzione di trigger è una funzione di callback che devi implementare personalmente per intraprendere le azioni appropriate per rispondere all'evento. Ad esempio, in un componente aggiuntivo Google Workspace che estende Gmail, puoi definire un trigger che crea una nuova interfaccia a schede quando l'utente apre un thread di messaggi. In questo caso, implementa una funzione di callback contestuale per creare le schede che compongono la nuova UI utilizzando i dati passati nell'oggetto evento.

Questa pagina fornisce linee guida sull'utilizzo dei trigger nei progetti di componenti aggiuntivi di Google Workspace.

Trigger manifest

A differenza dei componenti aggiuntivi dell'editor, i componenti aggiuntivi di Google Workspace non possono utilizzare i trigger semplici di Google Apps Script. Utilizzano invece attivatori progettati specificamente per i componenti aggiuntivi di Google Workspace: attivatori manifest.

I trigger manifest vengono definiti nel manifest del componente aggiuntivo Google Workspace. Ecco alcuni esempi:

• Trigger della home page che creano e visualizzano la home page del componente aggiuntivo.
• Trigger di apertura di eventi di Google Calendar che mostrano una nuova scheda o eseguono altre azioni quando viene aperto un evento.
• Attivatori di aggiornamento degli eventi di Calendar che mostrano una nuova scheda o intraprendono altre azioni quando un utente modifica e salva un evento.
• Google Drive onItemsSelected triggers che mostrano una nuova scheda o eseguono altre azioni quando un utente seleziona file o cartelle.
• Trigger di composizione di Gmail che mostrano una scheda del componente aggiuntivo quando l'utente apre il componente aggiuntivo nella finestra di composizione.
• Trigger contestuali di Gmail che mostrano una nuova scheda o eseguono altre azioni quando l'utente apre un messaggio.
• Editor onFileScopeGranted triggers che mostrano una nuova scheda quando gli utenti concedono l'autorizzazione per l'ambito OAuth drive.file nel documento.

Nell'elenco, solo gli attivatori della home page non sono contestuali; gli altri sono contestuali. Per ulteriori informazioni sulle definizioni degli attivatori manifest, consulta la sezione Manifest.

Oltre ai trigger del manifest, i componenti aggiuntivi di Google Workspace possono utilizzare i trigger installabili di Apps Script.

Restrizioni

I trigger manifest presentano alcune limitazioni al loro utilizzo.

• Questi trigger vengono utilizzati solo nei progetti di componenti aggiuntivi di Google Workspace.
• Poiché sono definiti nel manifest del componente aggiuntivo e non nel codice, non puoi utilizzare il servizio Script di Apps Script per crearli o modificarli.
• I trigger contestuali di Gmail vengono attivati per ogni messaggio email, indipendentemente dal contenuto.
• Ogni componente aggiuntivo può avere un solo trigger di ogni tipo per utente e per documento.