Trigger per i componenti aggiuntivi di Google Workspace

I attivatori di Apps Script causano l'esecuzione di una funzione script specificata (la funzione trigger) ogni volta che si verifica un evento specificato. Solo alcuni eventi possono causare l'attivazione degli attivatori e ogni applicazione di Google Workspace supporta un insieme diverso di eventi.

Quando si attiva un attivatore, 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 in base al tipo di attivatore.

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 autonomamente per eseguire le azioni appropriate per rispondere all'evento. Ad esempio, in un componente aggiuntivo di Google Workspace che estende Gmail, puoi definire un trigger che crei una nuova interfaccia della scheda quando l'utente apre un thread di messaggi. In questo caso, implementi una funzione di callback contestuale per creare le schede che costituiscono la nuova UI utilizzando i dati trasmessi nell'oggetto evento.

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

Trigger del manifest

A differenza dei componenti aggiuntivi di Google Workspace, al momento i componenti aggiuntivi di Google Workspace non possono utilizzare attivatori semplici di Apps Script, ma utilizzano trigger progettati appositamente per i componenti aggiuntivi di Google Workspace: attivatori manifest.

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

• Attivatori della home page che creano e visualizzano la home page dei componenti aggiuntivi.
• Attivatori di eventOpen di Calendar che mostrano una nuova scheda o eseguono altre azioni quando viene aperto un evento di Calendar.
• Attivatori di Calendar eventUpdate 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.
• Attivatori di scrittura di Gmail che mostrano una scheda di un componente aggiuntivo quando l'utente apre il componente aggiuntivo nella finestra di composizione di Gmail.
• Attivatori contestuali di Gmail che mostrano una nuova scheda o eseguono altre azioni quando l'utente apre un messaggio Gmail.
• Trigger di Editor onFileScopeGranted che mostrano una nuova scheda quando gli utenti concedono l'autorizzazione per l'ambito OAuth drive.file nel documento di Editor corrente.

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

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

Restrizioni

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

• Questi trigger vengono utilizzati solo nei progetti dei componenti aggiuntivi di Google Workspace e non hanno scopi in altre applicazioni.
• Poiché sono definiti nel file manifest del componente aggiuntivo e non nel codice, non puoi utilizzare il servizio Apps Script Script per creare o modificare questi attivatori.
• Al momento, gli attivatori contestuali di Gmail possono avere solo un criterio unconditional. Ciò significa che gli attivatori contestuali vengono attivati per ogni messaggio email, indipendentemente dai contenuti.
• Ogni componente aggiuntivo può avere un solo attivatore di ogni tipo, per utente e per documento.