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 un attivatore si attiva, 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 passa 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, implementerai 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 attualmente non possono utilizzare i trigger semplici di Apps Script. Utilizzano invece trigger progettati specificamente per i componenti aggiuntivi di Google Workspace: i trigger manifest.

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

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

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

Oltre ai trigger del file manifest, i componenti aggiuntivi di Google Workspace possono utilizzare anche 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 e non hanno alcuno scopo in altre applicazioni.
  • Poiché sono definiti nel manifest del componente aggiuntivo e non nel relativo codice, non puoi utilizzare il servizio Script di Apps Script per creare o modificare questi trigger.
  • Attualmente, i trigger contestuali di Gmail possono avere solo un criterio unconditional. Ciò significa che i trigger contestuali 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.