I seguenti termini vengono utilizzati in tutta la documentazione.
Componente aggiuntivo per le conferenze di Calendar
Un tipo speciale di componente aggiuntivo utilizzato per consentire ai fornitori di videoconferenze di presentare opzioni di videoconferenza negli eventi di Google Calendar. Questi componenti aggiuntivi richiedono una soluzione per le conferenze ben sviluppata a cui connettersi. A causa di questo requisito, la maggior parte degli sviluppatori non ha mai bisogno di creare un componente aggiuntivo per le conferenze di Calendar.
Per saperne di più, consulta Componenti aggiuntivi per conferenze di Calendar. Consulta anche 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" dell'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.
In base alla scheda
Un componente aggiuntivo la cui interfaccia utente viene visualizzata come riquadro nella barra laterale (o, su dispositivi mobili, come un'altra finestra di attività accessibile tramite il menu). Il componente aggiuntivo ha una barra degli strumenti superiore che lo identifica e mostra una scheda, ovvero una "pagina" dell'interfaccia utente del componente aggiuntivo.
I componenti aggiuntivi di Google Workspace sono basati su carta.
Dati della conferenza
L'insieme di informazioni di cui ha bisogno Google Calendar 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 le conferenze.
Per ulteriori informazioni, consulta la sezione 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 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 corrente 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 attivatori 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 tuo componente aggiuntivo di fornire un'interfaccia utente pertinente al contesto. Gli attivatori contestuali vengono configurati nel manifest del progetto dello script del componente aggiuntivo e pertanto sono un tipo di attivatore manifest.
Componenti aggiuntivi dell'editor
L'insieme originale di tipi di componenti aggiuntivi che consentiva solo estensioni di Documenti, Fogli, Moduli o Presentazioni Google. I componenti aggiuntivi dell'editor non sono basati su schede, ma richiedevano 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 per Editor.
Oggetto evento
L'oggetto JSON creato automaticamente quando vengono richieste le home page, quando il componente aggiuntivo accede ai contesti a cui deve rispondere o come risultato delle interazioni degli utenti 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 è trasmettere 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 può quindi intervenire su queste informazioni e restituire la risposta appropriata.
Per maggiori dettagli, consulta Oggetti evento.
Componenti aggiuntivi di Gmail
Un componente aggiuntivo che espande solo Gmail. I componenti aggiuntivi di Gmail sono basati su schede. Gran parte della funzionalità, del comportamento e dei dettagli di sviluppo utilizzati per creare i componenti aggiuntivi di Gmail è identica a quella utilizzata per creare i 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 consentono al componente aggiuntivo di mostrare contenuti al di fuori di un contesto specifico (ad esempio, quando l'utente visualizza i thread email in Gmail, ma non ne ha aperto uno). Puoi definire l'aspetto e il comportamento della home page del componente aggiuntivo come per qualsiasi altra scheda.
Per ulteriori informazioni, consulta la sezione Homepage.
Host o applicazione host
L'applicazione Google Workspace estesa da un componente aggiuntivo di Google Workspace, ad esempio Gmail o Google Calendar.
In base a 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 più vecchi sono basati su HTML.
Attivazione dell'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 Google, come Documenti Google. L'attivazione dell'anteprima del link ti consente di definire pattern di URL da visualizzare in anteprima dal tuo servizio o dalla tua API e di configurare i contenuti dell'anteprima, inclusi lo smart chip e la scheda di anteprima. Gli attivatori di anteprima dei link vengono configurati nel file manifest del progetto dello script del componente aggiuntivo e sono quindi un tipo di attivatore manifest.
Per scoprire di più, consulta la sezione Visualizza l'anteprima dei link con gli smart chip.
Manifest
Un file JSON allegato a un progetto Apps Script. Il file manifest viene utilizzato per definire le informazioni del progetto necessarie per l'esecuzione corretta dello script. Per i componenti aggiuntivi di Google Workspace, il manifest viene utilizzato per specificare gli host a cui il componente aggiuntivo può estendersi e fornire determinate impostazioni di controllo dell'interfaccia utente.
Trigger manifest
Un attivatore definito nel file manifest di un progetto, ad esempio un attivatore della home page o contestuale. Gli attivatori 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.
Gli attivatori manifest sono diversi dagli altri attivatori in Apps Script perché non sono integrati (come gli attivatori semplici) e non possono essere creati tramite programmazione con il servizio Script di Apps Script (come gli attivatori installabili).
Schede non contestuali
Schede che mostrano contenuti quando l'utente non è in un contesto specifico, ad esempio quando visualizza i thread email in Gmail, ma non ne ha aperto uno. Le home page sono un tipo di scheda non contestuale.
Barra laterale
La sezione a destra dell'interfaccia utente dell'host in cui viene visualizzata l'interfaccia utente di un componente aggiuntivo di Google Workspace. Anche i componenti aggiuntivi di Gmail e Editor possono 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 relativi al file o al link. Ad esempio, quando gli utenti passano il mouse sopra un chip di una presentazione di Google Presentazioni, vedono uno screenshot di una diapositiva, 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 di un servizio di terze parti o non Google. Vedi Visualizzare in anteprima i link in Documenti Google.
Trigger
Una condizione e una risposta automatica agli eventi definita da un progetto o da un componente aggiuntivo di Apps Script. Gli attivatori vengono attivati quando si verifica l'evento associato (ad esempio quando viene aperto un plug-in) e causano 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 generano 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 la sezione 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, ad esempio un pulsante, un campo di testo o una casella di controllo. Le schede vengono costruite da una sequenza di oggetti widget, definiti dal servizio Schede integrato in Apps Script.
Per saperne di più, consulta la sezione Widget.
Funzione di gestore del widget
Una funzione che collega un determinato widget a un determinato oggetto azione. Ogni tipo di widget ha un insieme di funzioni di gestore dei widget definite che può utilizzare per connettersi alle azioni. Le funzioni di gestore dei widget definiscono il tipo di interazione utente che attiva l'azione risultante e sono un componente fondamentale dell'interattività dei widget.
Per ulteriori informazioni, consulta Funzioni di gestore dei widget.