Prima di creare il componente aggiuntivo dell'editor, consulta le quote e le limitazioni di Apps Script per assicurarti che la progettazione del progetto sia in linea con queste linee guida. Se acquisisci familiarità con questi limiti all'inizio del processo di sviluppo, puoi evitare potenziali problemi in un secondo momento. Apps Script è ideale per lo sviluppo leggero di componenti aggiuntivi per te, il tuo team o la tua organizzazione. Tuttavia, se prevedi di creare un componente aggiuntivo su larga scala che deve gestire molti utenti, richiede una bassa latenza o esige il controllo completo della tua infrastruttura, valuta la possibilità di sviluppare un componente aggiuntivo Google Workspace in un ambiente di runtime diverso.
Segui questa procedura generale quando crei 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 integrato di Apps Script.
- Testa il componente aggiuntivo.
- Pubblica il componente aggiuntivo.
Creare un progetto di script
Un componente aggiuntivo dell'editor è un progetto Apps Script autonomo. La guida agli script autonomi fornisce
istruzioni per creare nuovi progetti.
Puoi anche semplicemente
aprire un nuovo script.
Se lo fai, il file di 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 è proprietario del progetto del componente aggiuntivo. Quando pubblichi un componente aggiuntivo, un singolo account utente funge da publisher. L'account di pubblicazione deve disporre dell'accesso in modifica al progetto di 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 lasciato la tua organizzazione.
Per evitare di perdere l'accesso al codice del componente aggiuntivo, ti consigliamo di utilizzare unità condivise quando collabori a un componente aggiuntivo. Se inserisci il file di script del componente aggiuntivo in un Drive condiviso, nessun account sarà l'unico proprietario del progetto.
Ti consigliamo inoltre di aggiungere collaboratori al progetto Google Cloud del progetto di script. In questo modo, un membro del tuo team può 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. Utilizzi HtmlService di Apps Script per creare l'interfaccia utente del componente aggiuntivo, ovvero dialoghi e barre laterali, utilizzando HTML e CSS convenzionali. I componenti aggiuntivi Editor possono definire anche voci di menu personalizzate.
Durante la codifica, consulta la guida di stile dei componenti aggiuntivi dell'editor per le 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ò incontrare.
Testa il componente aggiuntivo
Puoi testare i componenti aggiuntivi dell'editor prima che vengano pubblicati per assicurarti che si comportino come previsto. Per il test è necessario creare una configurazione di test e utilizzare un documento, un foglio di lavoro, un modulo o una presentazione di test.
Per maggiori dettagli, vedi Testare un componente aggiuntivo Editor.
Pubblicare il componente aggiuntivo
La pubblicazione del componente aggiuntivo lo rende disponibile ad altri utenti, pubblicamente o solo agli utenti del tuo dominio. Prima di iniziare la procedura di pubblicazione, assicurati di consultare la panoramica della pubblicazione.
I componenti aggiuntivi dell'editor vengono pubblicati su Google Workspace Marketplace. I componenti aggiuntivi disponibili pubblicamente devono completare la revisione del componente aggiuntivo prima di essere pubblicati.
Per maggiori dettagli, consulta Pubblicare un componente aggiuntivo Editor.