Attivatori per i componenti aggiuntivi di Google Workspace

Gli attivatori di Apps Script causano uno script specificato (la funzione trigger) da eseguire ogni volta che un evento specificato . Solo alcuni eventi possono attivare gli attivatori e ogni L'applicazione Google Workspace supporta un insieme di eventi diverso.

Quando si attiva un attivatore, viene creato un oggetto evento. Questa struttura JSON contiene i dettagli dell'evento che si è verificato. Le informazioni presenti nell'evento struttura degli oggetti è organizzata in modo diverso in base al tipo di trigger.

Una volta creato l'oggetto evento, Apps Script lo passa come parametro al di trigger. La funzione trigger è una funzione di callback che devi mettere in atto personalmente le azioni necessarie per rispondere alle . Ad esempio, in una il componente aggiuntivo di Google Workspace che estende Gmail, definisci un attivatore che crei una nuova interfaccia della scheda quando l'utente apre un messaggio . In questo caso, implementi una funzione di callback contestuale per creare le schede che compongono la nuova UI utilizzando i dati trasmessi oggetto evento.

Questa pagina fornisce le linee guida sull'utilizzo dei trigger in Google Workspace per i progetti aggiuntivi.

Trigger dei manifest

A differenza dei componenti aggiuntivi Editor, i componenti aggiuntivi di Google Workspace attualmente non è possibile utilizzare semplici attivatori di Apps Script Utilizzano invece trigger progettati specificamente per Componenti aggiuntivi di Google Workspace: attivatori del manifest.

Gli attivatori dei file manifest sono definiti completamente Componenti aggiuntivi di Google Workspace manifest. Esempi di trigger del file manifest includono seguenti:

• Attivatori della home page che creano e mostrano la home page del componente aggiuntivo.
• Trigger eventOpen di calendario che mostrano una nuova scheda o una nuova e altre azioni quando si apre un evento nel calendario.
• Trigger eventUpdate di calendario che mostrano una nuova scheda o richiesta Altre azioni quando un utente modifica e salva un evento nel calendario.
• Trigger onItemsSelected di Drive che mostrano una nuova scheda o 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 carta o utilizzano altri azioni eseguite quando l'utente apre un messaggio di Gmail.
• Trigger onFileScopeGranted dell'Editor che mostrano una nuova scheda quando gli utenti concedi l'autorizzazione per l'ambito OAuth drive.file nell'editor corrente documento.

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

Oltre agli attivatori di manifest, Google Workspace i componenti aggiuntivi possono usare anche Apps Script Trigger installabili.

Restrizioni

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

• Questi trigger vengono utilizzati solo nei progetti del componente aggiuntivo di Google Workspace. non hanno alcuno scopo in altre applicazioni.
• Poiché sono definite nel manifest del componente aggiuntivo e non nel suo codice, Utilizzare Apps Script Script per creare o modificare questi trigger.
• Al momento, i trigger contestuali di Gmail possono avere solo un criterio unconditional. Ciò significa che gli attivatori contestuali si attivano per ogni messaggio email, indipendentemente da contenuti.
• Ogni componente aggiuntivo può avere un solo attivatore di ogni tipo, per utente e per documento.