Quando crei un componente aggiuntivo Editor, segui questa procedura generale:
- Creare 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 Editor è un progetto Apps Script autonomo. La guida agli script autonomi fornisce
istruzioni per creare nuovi progetti.
Puoi anche semplicemente
aprire un nuovo script.
In questo modo, il file di progetto (inizialmente denominato Untitled project) viene inserito nella cartella Drive principale.
Collaborazione
Quando collabori con altri utenti per sviluppare un componente aggiuntivo, il progetto sarà di proprietà di un singolo account utente. Quando pubblichi un componente aggiuntivo, un singolo account utente agisce da publisher. L'account di pubblicazione deve disporre dell'accesso in modifica al progetto di script dei componenti aggiuntivi, ma non è necessario che sia 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 l'organizzazione.
Per evitare di perdere l'accesso al codice del componente aggiuntivo, ti invitiamo a utilizzare i Drive condivisi quando collabori a un componente aggiuntivo. Se posizioni il file di script del componente aggiuntivo in un Drive condiviso, avrai la certezza che nessun account sia l'unico proprietario del progetto.
Ti consigliamo inoltre di aggiungere collaboratori al progetto Cloud Platform (Google Cloud) del progetto di script. In questo modo, qualcuno del tuo team può sempre accedere alle impostazioni Cloud del componente aggiuntivo.
Codifica il componente aggiuntivo
Una volta creato un progetto di script, puoi iniziare a scrivere il codice per definire l'aspetto e il comportamento del componente aggiuntivo. Puoi utilizzare Apps Script HtmlService per creare l'interfaccia utente del componente aggiuntivo (finestre di dialogo e barre laterali) utilizzando HTML e CSS convenzionali. I componenti aggiuntivi dell'Editor possono anche definire voci di menu personalizzate.
Durante la programmazione, consulta la guida di stile per i componenti aggiuntivi dell'Editor per le linee guida su come progettare l'esperienza utente dei componenti aggiuntivi. Assicurati inoltre di comprendere e programmare i diversi stati del ciclo di vita di autorizzazione che il componente aggiuntivo può rilevare.
Testa il componente aggiuntivo
Puoi testare i componenti aggiuntivi Editor prima che vengano pubblicati per assicurarti che si comportino come previsto. Per i 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.
Pubblica 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, 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 dei componenti aggiuntivi prima di essere pubblicati.
Per ulteriori dettagli, consulta Pubblicazione di un componente aggiuntivo Editor.