Tipi di componenti aggiuntivi
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina fornisce una panoramica generale dei due tipi di componenti aggiuntivi
che puoi creare:
componenti aggiuntivi di Google Workspace e componenti aggiuntivi dell'editor. Questi
tipi di componenti aggiuntivi differiscono per le applicazioni che estendono,
per la modalità di creazione e per le restrizioni a cui sono soggetti.
Componenti aggiuntivi di Google Workspace
I componenti aggiuntivi di Google Workspace sono l'ultima generazione di componenti aggiuntivi e
offrono molte funzionalità, tra cui:
Crea un solo componente aggiuntivo per più app Google Workspace: anziché creare componenti aggiuntivi separati per ogni applicazione Google Workspace, puoi creare e gestire un unico componente aggiuntivo di Google Workspace che funzioni in tutte le app Google Workspace.
Un componente aggiuntivo di Google Workspace può estendere le seguenti applicazioni host:
- Gmail
- Google Calendar
- Google Chat (anteprima per gli sviluppatori)
- Documenti Google
- Google Drive
- Google Meet
- Fogli Google
- Presentazioni Google
Aumenta la notorietà del brand: le icone dei componenti aggiuntivi sono visibili per impostazione predefinita nel riquadro a destra delle app host del componente aggiuntivo.
Creare esperienze della home page: puoi creare home page individuali
per ogni app Google Workspace estesa dal componente aggiuntivo oppure utilizzare la stessa home page per più app.
Rifletti il contesto dell'utente nel componente aggiuntivo: puoi
progettare il componente aggiuntivo Google Workspace in modo che mostri interfacce specifiche per
l'app host del componente aggiuntivo. Ad esempio, il
componente aggiuntivo può mostrare informazioni da un'email o da un evento
di calendario oppure suggerire un'azione in base alla pagina dell'app Google Workspace
corrente.
Utilizza interfacce standardizzate: crea interfacce utente da elementi widget integrati forniti dal servizio Card
di Apps Script. Non è necessaria
alcuna competenza in HTML o CSS per definire queste interfacce.
Estendere i client desktop e mobile per Gmail: se un
componente aggiuntivo di Google Workspace estende Gmail, puoi utilizzarlo sia nella
versione desktop che in quella mobile di Gmail. Se crei un
componente aggiuntivo Google Workspace che estende Gmail, non devi
progettare una versione mobile separata del componente aggiuntivo. La stessa interfaccia viene utilizzata ovunque.
Utilizza il runtime che preferisci. Puoi sviluppare componenti aggiuntivi di Google Workspace con l'infrastruttura di hosting, la catena di strumenti di sviluppo, il sistema di controllo del codice sorgente, il linguaggio di programmazione e le librerie di codice che preferisci.
Componenti aggiuntivi dell'editor
I componenti aggiuntivi per gli editor estendono una delle applicazioni Google Editor,
come Documenti, Fogli, Presentazioni o
Moduli. Ogni tipo di componente aggiuntivo di Editor (ad esempio, i componenti aggiuntivi di Fogli) può avere il proprio insieme di funzionalità, restrizioni e considerazioni speciali specifiche per il tipo. Quando
crei componenti aggiuntivi di Editor, è importante comprendere questi
dettagli specifici di Editor. Per maggiori dettagli sui componenti aggiuntivi per editor specifici, consulta le sezioni corrispondenti:
I componenti aggiuntivi dell'editor possono automatizzare le attività comuni dell'editor, come la creazione, la modifica, la formattazione e lo spostamento di dati tra le applicazioni.
Le interfacce dei componenti aggiuntivi dell'editor sono altamente personalizzabili per
le attività da svolgere.
I componenti aggiuntivi dell'editor sono ideali per automatizzare le attività in Documenti, Fogli, Presentazioni o Moduli Google per uso personale o interno. Per i componenti aggiuntivi
che richiedono funzionalità su larga scala che devono gestire molti utenti, richiedono una bassa
latenza o esigono il controllo completo dell'infrastruttura, valuta la possibilità di creare
componenti aggiuntivi Google Workspace in un ambiente di runtime diverso
per un migliore controllo dei processi di infrastruttura, deployment e rilascio.
I componenti aggiuntivi dell'editor si comportano in modo diverso dai componenti aggiuntivi di Google Workspace nei seguenti modi:
- I componenti aggiuntivi per la modifica possono creare interfacce costituite da voci di menu,
finestre di dialogo e barre laterali. Le finestre di dialogo e le barre laterali dei componenti aggiuntivi
sono definite utilizzando HTML e
CSS standard.
- I componenti aggiuntivi dell'editor hanno regole di autorizzazione speciali perché
creano, modificano o interagiscono in altro modo con i file in Google Drive. È
importante comprendere l'autorizzazione
del componente aggiuntivo Editor durante
lo sviluppo di un componente aggiuntivo Editor.
- I file creati e aggiornati in ogni editor hanno strutture specifiche. Ad esempio, le presentazioni Google Slides sono composte da pagine che possono essere
diapositive, master o layout. Devi comprendere queste strutture di file, in quanto
i componenti aggiuntivi spesso interagiscono con loro durante la lettura o la modifica
dei file.
- I componenti aggiuntivi dell'editor funzionano solo nei client desktop, non su Android
o iOS.
- I componenti aggiuntivi dell'editor devono essere implementati in
Apps Script.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-26 UTC.
[null,null,["Ultimo aggiornamento 2025-08-26 UTC."],[[["\u003cp\u003eGoogle Workspace add-ons offer a unified solution, extending functionalities across multiple Google Workspace applications like Gmail, Calendar, and Docs with a single add-on.\u003c/p\u003e\n"],["\u003cp\u003eEditor add-ons focus on enhancing specific Google Editors (Docs, Sheets, Slides, Forms) with custom interfaces and automation capabilities but are limited to desktop use.\u003c/p\u003e\n"],["\u003cp\u003eWhile Workspace add-ons utilize standardized interfaces and work seamlessly across platforms, Editor add-ons require HTML/CSS knowledge and adhere to specific authorization rules.\u003c/p\u003e\n"],["\u003cp\u003eBoth add-on types provide distinct advantages; Workspace add-ons enhance cross-application workflows, while Editor add-ons offer deep, editor-specific customization and task automation.\u003c/p\u003e\n"]]],["There are two add-on types: Google Workspace and Editor add-ons. Google Workspace add-ons offer a single build for multiple apps (Gmail, Calendar, Chat, Docs, Drive, Sheets, Slides), and they feature standardized interfaces, mobile and desktop compatibility, and customizable homepages. Editor add-ons extend Docs, Sheets, Slides, and Forms, allowing for highly customizable interfaces using HTML and CSS, but require specific authorization and only function on desktop. They are built to automate common editor tasks.\n"],null,["This page provides a general overview of the two types of add-ons\nyou can build:\n*Google Workspace add-ons* and *Editor add-ons*. These\nadd-on types differ in what applications they extend,\nhow they are created, and what restrictions they have.\n\nGoogle Workspace add-ons\n\n*Google Workspace add-ons* are the latest generation of add-ons, and\nprovide many capabilities, including:\n\n- **Build just one add-on for multiple\n Google Workspace apps**: Instead of creating separate\n add-ons for\n each Google Workspace application, you can build and manage a single\n Google Workspace add-on that works across Google Workspace.\n A Google Workspace add-on can extend the following host applications:\n\n - Gmail\n - Google Calendar\n - Google Chat (Developer Preview)\n - Google Docs\n - Google Drive\n - Google Meet\n - Google Sheets\n - Google Slides\n- **Increase your brand awareness**: Add-ons icons are by\n default visible in the right-side panel of the\n add-on's host apps.\n\n- **Build homepage experiences** : You can create individual [homepages](/workspace/add-ons/concepts/homepages)\n for each Google Workspace app your add-on\n extends, or use the same homepage for multiple apps.\n\n- **Reflect the user's context in your add-on**: You\n can design your Google Workspace add-on to show interfaces specific to the\n add-on's host app. For example, your\n add-on can display info from an email or calendar\n event, or suggest an action based on the current Google Workspace app\n page.\n\n- **Use standardized interfaces** : Construct user interfaces from built-in\n widget elements provided by the Apps Script\n [`Card`](/apps-script/reference/card-service/card) service. You don't need\n any expertise with HTML or CSS to define these interfaces.\n\n- **Extend desktop and mobile clients for Gmail**: If a\n Google Workspace add-on extends Gmail, you can use it in both the\n desktop and mobile versions of Gmail. If you build a\n Google Workspace add-on that extends Gmail, you don't need to\n design a separate mobile version of the add-on. The\n same interface is used everywhere.\n\n- **Use your preferred runtime.** You can develop Google Workspace add-ons with your\n preferred hosting infrastructure, development tool chain, source control\n system, coding language, and code libraries.\n\nEditor add-ons\n\n*Editor add-ons* extend one of the Google Editor applications,\nsuch as Docs, Sheets, Slides, or\nForms. Each Editor add-on type (for\nexample, Sheets add-ons) can have its own set of\ntype-specific capabilities, restrictions, and special considerations. When\nbuilding Editor add-ons, it's important to understand these\nEditor-specific details. For more details on add-ons for specific\nEditors, see the corresponding sections:\n\n- [Google Docs](/workspace/add-ons/editors/docs)\n- [Google Forms](/workspace/add-ons/editors/forms)\n- [Google Sheets](/workspace/add-ons/editors/sheets)\n- [Google Slides](/workspace/add-ons/editors/slides)\n\nEditor add-ons can automate common editor tasks such as file\ncreation, editing, formatting, and moving data between applications.\nEditor add-on interfaces are highly-customizable for\nthe tasks at hand.\n\nEditor add-ons are ideal for automating tasks within Google\nDocs, Sheets, Slides, or\nForms for individual or internal use. For add-ons\nrequiring large-scale capabilities that need to handle many users, require low\nlatency, or demands full control over your infrastructure, consider building a\nGoogle Workspace add-ons on a [different runtime](/workspace/add-ons/guides/alternate-runtimes)\nenvironment for better control over infrastructure, deployment and release\nprocesses.\n\nEditor add-ons behave differently from Google Workspace add-ons in the\nfollowing ways:\n\n- Editor add-ons can create interfaces consisting of menu items, dialogs, and sidebars. Add-ons dialogs and sidebars are defined using standard [HTML and\n CSS](/workspace/add-ons/concepts/html-interfaces).\n- Editor add-ons have special authorization rules because they create, modify, or otherwise interact with files within Google Drive. It is important to understand the [Editor add-on\n authorization](/workspace/add-ons/concepts/editor-auth-lifecycle) while developing an Editor add-on.\n- Files created and updated in each editor have specific structures. For example, Google Slides presentations are composed of pages which can be slides, masters, or layouts. You should understand these file structures, as add-ons often interact with them when reading or editing files.\n- Editor add-ons only function in desktop clients, not Android or iOS.\n- Editor add-ons must be implemented in Apps Script."]]