Nella documentazione vengono utilizzati i termini che seguono.
Componente aggiuntivo per conferenze di Calendar
Un tipo speciale di componente aggiuntivo utilizzato per consentire ai fornitori di servizi di videoconferenza di presentare opzioni per le conferenze negli eventi di Google Calendar. Per connettersi a questi componenti aggiuntivi è necessaria una soluzione di conferenza ben sviluppata. Per questo, la maggior parte degli sviluppatori non ha mai la necessità di creare un componente aggiuntivo
Per ulteriori informazioni, vedi Componenti aggiuntivi per videoconferenze di Calendar. Consulta anche Upgrade dei componenti aggiuntivi pubblicati per informazioni su come convertire un componente aggiuntivo per videoconferenze di Calendar in un componente aggiuntivo di Google Workspace.
Scheda
Una singola "pagina" di un'interfaccia utente 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.
Basata su carta
Un componente aggiuntivo la cui interfaccia utente viene visualizzata come un 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 mostra una scheda, essenzialmente una "pagina" dell'interfaccia utente del componente aggiuntivo.
I componenti aggiuntivi di Google Workspace si basano su carte.
Dati della conferenza
Il set di informazioni di cui Google Calendar ha bisogno per consentire agli utenti di creare e partecipare a conferenze di terze parti abilitate da un componente aggiuntivo di Google Workspace o di Calendar.
Per ulteriori informazioni, consulta Dati della conferenza.
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 videoconferenze di Calendar.
Per ulteriori informazioni, vedi Soluzioni per conferenze.
Contesto
Stato attuale dell'applicazione host. Ad esempio, i messaggi attualmente aperti in Gmail, gli eventi di Calendar che stai modificando o i file di Drive che hai selezionato fanno parte del contesto corrente 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 prassi di definire gli attivatori che si attivano quando l'utente inserisce un contesto specifico, ad esempio quando apre un thread di email in Gmail. L'attivazione contestuale consente al componente aggiuntivo di fornire una UI pertinente a quel contesto. Gli attivatori contestuali sono configurati nel manifest del progetto di script dei componenti aggiuntivi, pertanto sono un tipo di trigger manifest.
Componenti aggiuntivi dell'editor
L'insieme originale dei tipi di componenti aggiuntivi che consentivano solo le estensioni di Documenti, Fogli, Moduli o Presentazioni Google. I componenti aggiuntivi di Editor non sono basati su schede, ma richiedevano allo sviluppatore di creare una UI da HTML e CSS non elaborati. Ogni componente aggiuntivo dell'editor può estendere una sola applicazione host.
Per ulteriori dettagli, consulta Componenti aggiuntivi di Editor.
Oggetto evento
Oggetto JSON creato automaticamente quando vengono richieste le home page, quando il componente aggiuntivo inserisce contesti a cui deve rispondere o come risultato delle interazioni dell'utente con i widget nell'interfaccia del componente aggiuntivo. Una volta creati, gli oggetti evento vengono passati a una funzione trigger o a una funzione 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 del componente aggiuntivo) al codice lato server del componente aggiuntivo, che a sua volta può agire su queste informazioni e restituire la risposta appropriata.
Per ulteriori dettagli, consulta Oggetti evento.
Componenti aggiuntivi di Gmail
Un componente aggiuntivo che estende solo Gmail. I componenti aggiuntivi di Gmail si basano su schede. Molti dei dettagli relativi a funzionalità, comportamento e sviluppo utilizzati per creare componenti aggiuntivi di Gmail sono identici agli stessi dettagli utilizzati per creare i componenti aggiuntivi di Google Workspace.
Per ulteriori informazioni, vedi Componenti aggiuntivi di Gmail. Consulta anche 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 consentono al componente aggiuntivo di mostrare i contenuti al di fuori di un contesto specifico, ad esempio quando l'utente sta visualizzando i 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 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, è un componente aggiuntivo di Google Workspace, come Gmail o Google Calendar.
Basato su HTML
Un componente aggiuntivo la cui interfaccia utente è definita utilizzando HTML e CSS anziché il servizio scheda integrato di Apps Script. Solo i componenti aggiuntivi dell'Editor meno recenti sono basati su HTML.
Attivatore anteprima link
L'anteprima del link viene attivata 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 dei link consente di definire pattern URL di cui visualizzare l'anteprima dal servizio o dall'API e di 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 dei componenti aggiuntivi e pertanto sono un tipo di trigger di manifest.
Per ulteriori informazioni, consulta Visualizzare l'anteprima dei link con smart chip.
Manifest
Un file JSON allegato a un progetto Apps Script. Il manifest viene utilizzato per definire le informazioni sul progetto che lo script deve essere eseguito correttamente. Per i componenti aggiuntivi di Google Workspace, il file manifest viene utilizzato per specificare quali host possono essere estesi e fornire determinate impostazioni di controllo dell'interfaccia utente.
Trigger del manifest
Un trigger definito nel manifest di un progetto, ad esempio un attivatore della home page o un trigger contestuale. Gli attivatori dei file manifest vengono utilizzati esclusivamente per creare e visualizzare nuove schede quando viene richiesta la home page di un componente aggiuntivo o quando il componente aggiuntivo inserisce un contesto che richiede un aggiornamento della visualizzazione.
I trigger manifest sono diversi dagli altri trigger in Apps Script perché non sono integrati (ad esempio i trigger semplici) e non possono essere creati in modo programmatico con il servizio Script di Apps Script (ad esempio, i trigger installabili).
Schede non contestuali
Schede che mostrano i contenuti quando l'utente si trova all'esterno di un contesto specifico, ad esempio quando visualizza i 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 dell'host in cui viene visualizzata l'UI di un componente aggiuntivo di Google Workspace. Anche i componenti aggiuntivi di Gmail ed 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 contenuti aggiuntivi sul file o sul link. Ad esempio, quando gli utenti passano il mouse sopra un chip su una presentazione di Presentazioni Google, visualizzano lo screenshot di una slide, il proprietario della presentazione e se l'hanno già visualizzata.
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. Consulta Visualizzare l'anteprima dei link in Documenti Google.
Trigger
Una condizione e una risposta automatica agli eventi definite da un progetto o componente aggiuntivo Apps Script. I trigger si attivano quando si verifica l'evento associato (ad esempio, quando viene aperto un componente aggiuntivo) e causano l'esecuzione automatica di una specifica funzione Apps Script (la funzione di trigger). Per i componenti aggiuntivi di Google Workspace, le funzioni di attivazione spesso creano nuove schede per controllare quale parte dell'interfaccia utente del componente aggiuntivo viene visualizzata. Solo alcuni tipi di eventi possono avere attivatori.
Per ulteriori informazioni, consulta gli attivatori dei componenti aggiuntivi.
Attiva funzione
Una funzione Apps Script in un progetto che viene eseguita in risposta all'attivazione di un trigger.
Widget
Un elemento dell'interfaccia utente come un pulsante, un campo di testo o una casella di controllo. Le schede vengono create da una sequenza di oggetti widget, definita dal servizio Card integrato di Apps Script.
Per ulteriori informazioni, vedi Widget.
Funzione gestore widget
Una funzione che collega un particolare widget a un determinato oggetto azione. Ogni tipo di widget ha un insieme di funzioni di gestore di widget definite che può utilizzare per connettersi alle azioni. Le funzioni di widget hander definiscono il tipo di interazione dell'utente che attiva l'azione risultante e sono un componente fondamentale dell'interattività del widget.
Per maggiori informazioni, consulta Funzioni dei gestori di widget.