Segui questa procedura generale per creare un componente aggiuntivo di Editor:
- Crea un progetto Apps Script.
- Scrivi il codice per definire l'aspetto e il comportamento del componente aggiuntivo utilizzando il servizio HTML di Apps Script integrato.
- Testa il componente aggiuntivo.
- Pubblica il componente aggiuntivo.
Creare un progetto di script
Un componente aggiuntivo di Editor è un progetto Apps Script autonomo. La guida agli script autonomi fornisce
istruzioni per creare nuovi progetti.
Puoi anche
aprire un nuovo script.
In questo caso, il file del progetto (inizialmente denominato Untitled project) viene inserito nella cartella principale di Drive.
Collaborazione
Quando collabori con altri allo sviluppo di un componente aggiuntivo, un singolo account utente possiede il progetto del componente aggiuntivo. Quando pubblichi un componente aggiuntivo, un singolo account utente funge da editore. L'account di pubblicazione deve avere accesso in modifica al progetto dello script del componente aggiuntivo, ma non deve essere il proprietario del progetto.
È molto importante evitare situazioni in cui perdi l'accesso al codice o alle impostazioni di un componente aggiuntivo perché il proprietario del progetto ha abbandonato la tua organizzazione.
Per evitare di perdere l'accesso al codice del componente aggiuntivo, ti invitiamo a utilizzare le unità condivise quando collabori a un componente aggiuntivo. Se inserisci il file dello script del componente aggiuntivo in un drive condiviso, nessun account è l'unico proprietario del progetto.
Ti consigliamo inoltre di aggiungere collaboratori al progetto Cloud (Google Cloud) del progetto di script. In questo modo, un membro del tuo team potrà sempre accedere alle impostazioni cloud del componente aggiuntivo.
Codificare il componente aggiuntivo
Dopo aver creato un progetto di script, puoi iniziare a scrivere il codice per definire l'aspetto e il comportamento del componente aggiuntivo. Utilizza HtmlService di Apps Script per creare l'interfaccia utente del componente aggiuntivo (finestre di dialogo e barre laterali) utilizzando HTML e CSS convenzionali. I componenti aggiuntivi Editor possono anche definire voci di menu personalizzate.
Durante la scrittura del codice, consulta la guida di stile per i componenti aggiuntivi di Editor per linee guida su come progettare l'esperienza utente del componente aggiuntivo. Inoltre, assicurati di comprendere e programmare i diversi stati del ciclo di vita dell'autorizzazione che il tuo componente aggiuntivo può riscontrare.
Testare il componente aggiuntivo
Puoi testare i componenti aggiuntivi di Editor prima che vengano pubblicati per assicurarti che funzionino come previsto. Per eseguire i test, devi creare una configurazione di test e utilizzare un documento, un foglio di lavoro, un modulo o una presentazione di test.
Per maggiori dettagli, consulta Testare un componente aggiuntivo Editor.
Pubblicare il componente aggiuntivo
La pubblicazione del componente aggiuntivo lo rende disponibile ad altri, pubblicamente o solo agli utenti del tuo dominio. Prima di iniziare la procedura di pubblicazione, consulta la panoramica della pubblicazione.
I componenti aggiuntivi di Editor vengono pubblicati su Google Workspace Marketplace. I componenti aggiuntivi disponibili pubblicamente devono completare la revisione dei componenti aggiuntivi prima di essere pubblicati.
Per ulteriori dettagli, consulta Pubblicare un componente aggiuntivo per Editor.