Attivatori per i componenti aggiuntivi di Google Workspace

I trigger di 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 un trigger viene attivato, viene creato un oggetto evento. Questa struttura JSON contiene dettagli sull'evento che si è verificato. Le informazioni nella struttura dell'oggetto evento sono organizzate in modo diverso a seconda del tipo di trigger.

Una volta creato l'oggetto evento, Apps Script lo passa come parametro alla funzione trigger. La funzione trigger è una funzione di callback che devi implementare tu stesso per intraprendere le azioni appropriate per rispondere all'evento. Ad esempio, in un componente aggiuntivo di Google Workspace che estende Gmail, puoi definire un trigger che crea una nuova interfaccia di schede quando l'utente apre un thread di messaggi. In questo caso, implementi 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 trigger progettati specificamente per i componenti aggiuntivi di Google Workspace: i trigger manifest.

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

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

Nell'elenco, solo i trigger della home page non sono contestuali; gli altri sono contestuali. Per ulteriori informazioni sulle definizioni dei trigger manifest, consulta Manifest per.

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

Restrizioni

L'utilizzo dei trigger manifest è soggetto a determinate restrizioni.

  • 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, per documento.