In questa documentazione vengono utilizzati i termini indicati di seguito.
Componente aggiuntivo per conferenze di Calendar
Un tipo speciale di componente aggiuntivo utilizzato per consentire ai fornitori di servizi di conferenza di presentare opzioni per le conferenze negli eventi di Google Calendar. Questi componenti aggiuntivi richiedono una soluzione per conferenze ben sviluppata a cui il componente aggiuntivo possa connettersi. A causa di questo requisito, la maggior parte degli sviluppatori non ha mai la necessità di creare un componente aggiuntivo per le conferenze di Calendar.
Per ulteriori informazioni, vedi Componenti aggiuntivi per le conferenze di Calendar. Consulta anche l'articolo Eseguire l'upgrade dei componenti aggiuntivi pubblicati per informazioni su come convertire un componente aggiuntivo per conferenze di Calendar in un componente aggiuntivo di Google Workspace.
Scheda
Una singola "pagina" di un componente aggiuntivo. Le schede sono composte da diversi oggetti widget (pulsanti, campi di testo, intestazioni e così via).
Per ulteriori informazioni, consulta la sezione Schede.
Basato su carta
Un componente aggiuntivo la cui interfaccia utente appare sotto forma di riquadro nella barra laterale (o, sui dispositivi mobili, come un'altra finestra di attività accessibile tramite il menu). Il componente aggiuntivo ha una barra degli strumenti in alto che identifica il componente aggiuntivo e visualizza una scheda, sostanzialmente una "pagina" dell'interfaccia utente del componente aggiuntivo.
I componenti aggiuntivi di Google Workspace si basano sulle schede.
Dati conferenza
L'insieme di informazioni di cui ha bisogno Google Calendar per consentire agli utenti di creare e partecipare a conferenze di terze parti attivate da un componente aggiuntivo di Google Workspace o da un componente aggiuntivo per le conferenze di Calendar.
Per ulteriori informazioni, consulta Dati relativi alle conferenze.
Soluzione per conferenze
Una rappresentazione di una conferenza di terze parti che può essere creata da Google Calendar utilizzando il componente aggiuntivo di Google Workspace o il componente aggiuntivo per conferenze di Calendar.
Per ulteriori informazioni, consulta Soluzioni per conferenze.
Contesto
Lo stato attuale dell'applicazione host. Ad esempio, quale messaggio attualmente aperto in Gmail, quale evento di Calendar stai modificando o quali file di Drive hai selezionato fanno parte del contesto attuale dell'applicazione host. Il contesto, insieme ad altre informazioni, viene raccolto in un oggetto evento che viene passato alla funzione trigger come parametro.
Attivazione contestuale
La pratica di definire gli attivatori che si attivano quando l'utente entra in un contesto specifico, ad esempio quando apre un thread di email in Gmail. L'attivazione contestuale consente al componente aggiuntivo di fornire un'interfaccia utente pertinente al contesto. Gli attivatori contestuali sono configurati nel manifest del progetto di script dei componenti aggiuntivi e, pertanto, sono un tipo di attivatore del manifest.
Componenti aggiuntivi di Editor
L'insieme originale di tipi di componenti aggiuntivi che consentivano solo le estensioni di Documenti, Fogli, Moduli o Presentazioni Google. I componenti aggiuntivi dell'editor non sono basati sulle schede, ma richiedono allo sviluppatore di creare un'interfaccia utente da HTML e CSS non elaborati. Ogni componente aggiuntivo dell'editor può estendere una sola applicazione host.
Per ulteriori dettagli, consulta Componenti aggiuntivi dell'Editor.
Oggetto evento
L'oggetto JSON che viene creato automaticamente quando vengono richieste le home page, quando il componente aggiuntivo inserisce i contesti a cui deve rispondere o a seguito di interazioni dell'utente con i widget nell'interfaccia del componente aggiuntivo. Una volta creati, gli oggetti evento vengono passati a una funzione di trigger o di callback specificata. Lo scopo degli oggetti evento è passare le informazioni dall'ambiente lato client dell'utente (ad esempio le informazioni inserite nei widget dell'interfaccia aggiuntiva) al codice lato server del componente aggiuntivo, che può quindi agire di conseguenza e restituire la risposta appropriata.
Consulta Oggetti evento per ulteriori dettagli.
Componenti aggiuntivi di Gmail
Un componente aggiuntivo che estende solo Gmail. I componenti aggiuntivi di Gmail si basano sulle schede. Gran parte dei dettagli relativi a funzionalità, comportamento e sviluppo utilizzati per creare componenti aggiuntivi di Gmail sono identici a quelli utilizzati per creare componenti aggiuntivi di Google Workspace.
Per ulteriori informazioni, consulta Componenti aggiuntivi di Gmail. Consulta anche Eseguire l'upgrade dei componenti aggiuntivi pubblicati per informazioni su come convertire un componente aggiuntivo di Gmail in un componente aggiuntivo di Google Workspace.
Home page
La scheda dell'interfaccia utente principale di un componente aggiuntivo. Le home page vengono visualizzate quando gli utenti aprono il componente aggiuntivo e ne consentono la visualizzazione al di fuori di un contesto specifico, ad esempio quando l'utente visualizza i propri thread di email in Gmail, ma non ne ha aperto uno. Sei tu a definire l'aspetto e il comportamento della home page del componente aggiuntivo come per qualsiasi altra scheda.
Per ulteriori informazioni, consulta la sezione Home page.
Applicazione host o host
L'applicazione Google Workspace, un componente aggiuntivo di Google Workspace, si estende come Gmail o Google Calendar.
Basato su HTML
Un componente aggiuntivo la cui interfaccia utente è definita utilizzando HTML e CSS anziché il Servizio schede integrato di Apps Script. Solo i componenti aggiuntivi dell'Editor precedenti sono basati su HTML.
Attivatore anteprima link
L'attivazione dell'anteprima link si attiva quando gli utenti interagiscono con un URL di terze parti o non Google all'interno di un'applicazione host di Google, ad esempio Documenti Google. L'attivazione dell'anteprima link consente di definire i pattern URL di cui visualizzare l'anteprima dal servizio o dall'API e configurare i contenuti dell'anteprima, inclusi smart chip e scheda di anteprima. I trigger di anteprima dei link sono configurati nel manifest del progetto di script del componente aggiuntivo e sono quindi un tipo di trigger del manifest.
Per ulteriori informazioni, consulta Link dell'anteprima in Documenti Google.
Manifest
Un file JSON allegato a un progetto Apps Script. Il manifest viene utilizzato per definire le informazioni sul progetto di cui lo script deve essere eseguito correttamente. Per i componenti aggiuntivi di Google Workspace, il file manifest viene utilizzato per specificare gli host che il componente aggiuntivo può estendere e fornire determinate impostazioni di controllo dell'interfaccia utente.
Attivatore manifest
Un attivatore definito nel manifest di un progetto, ad esempio un trigger della home page o di un attivatore contestuale. Gli attivatori manifest vengono utilizzati esclusivamente per creare e visualizzare nuove schede quando viene richiesta la home page di un componente aggiuntivo o il componente aggiuntivo inserisce un contesto che richiede un aggiornamento della visualizzazione.
I trigger manifest sono distinti da altri trigger in Apps Script perché non sono integrati (come i trigger semplici) e non possono essere creati in modo programmatico con il servizio Apps Script (ad esempio i attivabili installabili).
Schede non contestuali
Schede che mostrano i contenuti quando l'utente si trova al di fuori di un contesto specifico; ad esempio, quando visualizza i propri thread di email in Gmail, ma non ne ha aperto uno. Le home page sono una sorta di scheda non contestuale.
Barra laterale
La sezione a destra dell'interfaccia utente host in cui viene visualizzata l'UI di un componente aggiuntivo di Google Workspace. Anche i componenti aggiuntivi di Gmail e degli Editor possono definire le barre laterali.
Smart chip
Uno smart chip è una menzione di una persona, un file, un evento di calendario o un'altra entità all'interno di un'applicazione Google Workspace. Quando gli utenti passano il mouse sopra un chip, possono anche visualizzare l'anteprima di ulteriori contenuti relativi al file o al link. Ad esempio, quando gli utenti passano il mouse sopra un chip su una presentazione Google, vedono lo screenshot di una diapositiva, il proprietario della presentazione e se l'hanno già visualizzata in precedenza.
Puoi configurare il componente aggiuntivo in modo che utilizzi gli smart chip per visualizzare l'anteprima dei link per un servizio di terze parti o non Google. Vedi Link dell'anteprima in Documenti Google.
Trigger
Una condizione e una risposta automatica agli eventi definiti da un progetto o un componente aggiuntivo di Apps Script. Gli attivatori si attivano quando si verifica l'evento associato (ad esempio quando viene aperto un componente aggiuntivo) e determinano l'esecuzione automatica di una funzione Apps Script specificata (la funzione di attivazione). Per i componenti aggiuntivi di Google Workspace, le funzioni di attivazione spesso creano nuove schede per controllare quale parte dell'UI del componente aggiuntivo viene visualizzata. Solo alcuni tipi di eventi possono avere attivatori.
Per ulteriori informazioni, consulta Trigger dei componenti aggiuntivi.
Attiva la funzione
Una funzione Apps Script in un progetto che viene eseguita in risposta all'attivazione di un trigger.
Widget
Un elemento dell'interfaccia utente, ad esempio un pulsante, un campo di testo o una casella di controllo. Le schede vengono create da una sequenza di oggetti widget, definiti dal Servizio Card integrato di Apps Script.
Per ulteriori informazioni, consulta la sezione Widget.
Funzione gestore widget
Una funzione che collega un determinato widget a un determinato oggetto azione. Ogni tipo di widget ha un insieme di funzioni definite per il gestore di widget che può utilizzare per connettersi alle azioni. Le funzioni di hander dei widget definiscono il tipo di interazione dell'utente che attiva l'azione risultante e sono una componente fondamentale dell'interattività dei widget.
Per ulteriori informazioni, consulta Funzioni di gestore dei widget.