In questa documentazione vengono utilizzati i seguenti termini.
Componente aggiuntivo per le conferenze di Calendar
Un tipo speciale di componente aggiuntivo utilizzato per consentire ai fornitori di servizi di conferenza di presentare le opzioni di conferenza negli eventi di Google Calendar. Questi componenti aggiuntivi richiedono una soluzione di conferenza ben sviluppata a cui 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 saperne di più, consulta Componenti aggiuntivi per conferenze di Calendar. Vedi anche Aggiornamento 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" dell'interfaccia utente di un componente aggiuntivo. Le schede sono composte da diversi oggetti widget (pulsanti, campi di testo, intestazioni e così via).
Per maggiori informazioni, consulta la sezione Schede.
Basato su carta
Un componente aggiuntivo la cui interfaccia utente viene visualizzata come riquadro nella barra laterale (o, sui dispositivi mobili, come un'altra finestra di attività raggiungibile tramite il menu). Il componente aggiuntivo ha una barra degli strumenti superiore che identifica il componente aggiuntivo e mostra una scheda, ovvero una "pagina" dell'interfaccia utente del componente aggiuntivo.
I componenti aggiuntivi di Google Workspace sono basati su schede.
Dati della conferenza
L'insieme di informazioni necessarie a Google Calendar per consentire agli utenti di creare e partecipare a conferenze di terze parti attivate da un componente aggiuntivo Google Workspace o da un componente aggiuntivo per le conferenze di Calendar.
Per saperne di più, consulta la sezione Dati della conferenza.
Soluzione per conferenze
Rappresentazione di una conferenza di terze parti che può essere creata da Google Calendar utilizzando il componente aggiuntivo Google Workspace o il componente aggiuntivo per le conferenze di Calendar.
Per ulteriori informazioni, consulta la sezione Soluzioni per conferenze.
Contesto
Lo stato attuale dell'applicazione host. Ad esempio, il messaggio attualmente aperto in Gmail, l'evento di Calendar che stai modificando o i file di Drive che 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 di attivazione come parametro.
Attivazione contestuale
La pratica di definire trigger che si attivano quando l'utente entra in un contesto specifico, ad esempio quando apre un thread 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 del componente aggiuntivo e sono quindi un tipo di attivatore manifest.
Componenti aggiuntivi dell'editor
Il set originale di tipi di componenti aggiuntivi che consentivano solo estensioni di Documenti, Fogli, Moduli o Presentazioni Google. I componenti aggiuntivi dell'editor non sono basati su 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 maggiori dettagli, consulta Componenti aggiuntivi Editor.
Oggetto evento
L'oggetto JSON creato automaticamente quando vengono richieste le home page, quando il componente aggiuntivo entra nei 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 attivazione o di callback specificata. Lo scopo degli oggetti evento è quello di trasmettere informazioni dall'ambiente lato client dell'utente (ad esempio le informazioni che ha inserito nei widget dell'interfaccia del componente aggiuntivo) al codice lato server del componente aggiuntivo, che può quindi agire in base a queste informazioni e restituire la risposta appropriata.
Per maggiori dettagli, vedi Oggetti evento.
Componenti aggiuntivi di Gmail
Un componente aggiuntivo che estende solo Gmail. I componenti aggiuntivi di Gmail sono basati su schede. Gran parte delle funzionalità, del comportamento e dei dettagli di sviluppo utilizzati per creare i componenti aggiuntivi di Gmail è identica a quelli utilizzati per creare i componenti aggiuntivi di Google Workspace.
Per saperne di più, consulta Componenti aggiuntivi di Gmail. Vedi anche Eseguire l'upgrade dei componenti aggiuntivi pubblicati per informazioni su come convertire un componente aggiuntivo Gmail in un componente aggiuntivo 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 contenuti al di fuori di un contesto specifico (ad esempio, quando l'utente visualizza le sue conversazioni email in Gmail, ma non ne ha aperta una). Definisci l'aspetto e il comportamento della home page del componente aggiuntivo come qualsiasi altra scheda.
Per ulteriori informazioni, consulta la sezione Home page.
Host o applicazione host
L'applicazione Google Workspace a cui si estende un componente aggiuntivo 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 schede integrato di Apps Script. Solo i componenti aggiuntivi di Editor meno recenti sono basati su HTML.
Trigger dell'anteprima link
I trigger di anteprima dei link vengono attivati quando gli utenti interagiscono con un URL di terze parti o non Google all'interno di un'applicazione host Google, ad esempio Documenti Google. L'attivazione dell'anteprima dei link consente di definire i pattern degli URL da visualizzare in anteprima dal servizio o dall'API e configurare i contenuti dell'anteprima, inclusi lo smart chip e la 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 manifest.
Per saperne di più, consulta la sezione Link di anteprima con smart chip.
Manifest
Un file JSON allegato a un progetto Apps Script. Il manifest viene utilizzato per definire le informazioni sul progetto necessarie per l'esecuzione corretta dello script. Per i componenti aggiuntivi Google Workspace, il manifest viene utilizzato per specificare gli host che il componente aggiuntivo può estendere e fornire determinate impostazioni di controllo dell'interfaccia utente.
Trigger manifest
Un trigger definito nel manifest di un progetto, ad esempio un trigger della home page o un trigger contestuale. I trigger 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 entra in un contesto che richiede un aggiornamento della visualizzazione.
I trigger manifest sono diversi dagli altri trigger in Apps Script perché non sono integrati (come i trigger semplici) e non possono essere creati programmaticamente con il servizio Script di Apps Script (come i trigger installabili).
Schede non contestuali
Schede che mostrano contenuti quando l'utente si trova al di fuori di un contesto specifico, ad esempio quando visualizza le sue conversazioni email in Gmail, ma non ne ha aperta una. Le home page sono un tipo di scheda non contestuale.
Barra laterale
La sezione a destra dell'interfaccia utente host in cui viene visualizzata l'interfaccia utente di un componente aggiuntivo di Google Workspace. I componenti aggiuntivi di Gmail e Editor possono anche definire barre laterali.
Smart chip
Uno smart chip è una menzione di una persona, un file, un evento nel 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 di una presentazione Google, vedono uno screenshot di una slide, il proprietario della presentazione e se l'hanno già visualizzata in precedenza.
Puoi configurare il componente aggiuntivo in modo che utilizzi le smart chip per visualizzare l'anteprima dei link per un servizio di terze parti o non Google. Vedi Visualizzare l'anteprima dei link in Documenti Google.
Trigger
Una condizione e una risposta automatica agli eventi definite da un progetto Apps Script o da un componente aggiuntivo. Gli attivatori vengono attivati quando si verifica l'evento associato (ad esempio, quando viene aperto un componente aggiuntivo) e causano l'esecuzione automatica di una funzione Apps Script specificata (la funzione di attivazione). Per i componenti aggiuntivi 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 saperne di più, consulta Trigger dei componenti aggiuntivi.
Funzione di attivazione
Una funzione Apps Script in un progetto che viene eseguita in risposta all'attivazione di un trigger.
Widget
Un elemento UI come un pulsante, un campo di testo o una casella di controllo. Le schede sono create da una sequenza di oggetti widget, definiti dal servizio Card integrato di Apps Script.
Per saperne di più, consulta Widget.
Funzione di gestione dei widget
Una funzione che collega un determinato widget a un determinato oggetto azione. Ogni tipo di widget dispone di un insieme di funzioni di gestione dei widget definite che può utilizzare per connettersi alle azioni. Le funzioni di gestione dei widget definiscono il tipo di interazione utente che attiva l'azione risultante e sono un componente fondamentale dell'interattività dei widget.
Per saperne di più, consulta Funzioni di gestione dei widget.