Migliora l'esperienza complessiva dei tuoi utenti seguendo queste guide per la progettazione dei componenti aggiuntivi.
Best practice generali
Ti invitiamo a utilizzare le seguenti best practice per tutti i componenti aggiuntivi che sviluppi.
Determinare la proprietà del componente aggiuntivo prima di iniziare
I componenti aggiuntivi sono definiti dai progetti Apps Script, che devono essere di proprietà di un account specifico o essere inseriti in un Drive condiviso. Prima di codificare un componente aggiuntivo, determina quale account deve essere proprietario del progetto e quale account funge da publisher. Determina anche quali account devono fungere da collaboratori e assicurati che abbiano accesso al progetto di script e al progetto Google Cloud associato.
Estendi Google Workspace, non replicarlo
I componenti aggiuntivi hanno lo scopo di fornire nuove funzionalità alle applicazioni Google Workspace che estendono o di automatizzare attività complesse. I componenti aggiuntivi che replicano semplicemente funzionalità già presenti nell'applicazione o che non apportano miglioramenti significativi a un flusso di lavoro non supereranno probabilmente la revisione dei componenti aggiuntivi per la pubblicazione.
Mantieni gli ambiti ristretti
Quando definisci gli ambiti
in modo esplicito, scegli sempre
il set di ambiti meno permissivo possibile. Ad esempio, non richiedere l'accesso completo al calendario dell'utente con l'ambito https://www.googleapis.com/auth/calendar se l'accesso in lettura è sufficiente. Per l'accesso di sola lettura, utilizza
l'ambito https://www.googleapis.com/auth/calendar.readonly.
Evita di fare troppo affidamento sulle librerie
L'utilizzo delle librerie di Apps Script può far funzionare più lentamente il componente aggiuntivo rispetto a quando tutto il codice Apps Script è contenuto in un unico progetto di script. Sebbene le librerie Apps Script funzionino nei componenti aggiuntivi, potresti riscontrare riduzioni delle prestazioni se le utilizzi. Evita di includere librerie non necessarie nel tuo progetto e valuta i modi per ridurre la dipendenza del tuo componente aggiuntivo da queste librerie.
La latenza descritta sopra si applica solo ai progetti Apps Script utilizzati come librerie lato server. Puoi utilizzare liberamente librerie JavaScript lato client come jQuery senza riscontrare questa latenza.
Best practice per i componenti aggiuntivi dell'editor
Le best practice riportate di seguito si applicano solo al componente aggiuntivo Editor.
Inserisci l'HTML dell'interfaccia e il codice JavaScript lato client nei rispettivi file di script
Puoi creare più file di script in un progetto Apps Script. È più facile gestire un componente aggiuntivo complesso se inserisci l'HTML e il JavaScript che definiscono le barre laterali e le finestre di dialogo del componente aggiuntivo in file di script dedicati.
Esegui test approfonditi in diverse modalità di autorizzazione
Quando testi il tuo componente aggiuntivo, assicurati di provare configurazioni con file diversi e stati di autorizzazione diversi.