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 scrivere il codice di un componente aggiuntivo, determina quale account deve essere il proprietario del progetto e quale account funge da publisher. Determina anche quali account devono fungere da collaboratori e assicurati che questi account abbiano accesso al progetto di script e al progetto Google Cloud associato .
Estendere Google Workspace, non replicarlo
I componenti aggiuntivi sono progettati per fornire nuove funzionalità alle applicazioni Google Workspace che estendono o per automatizzare attività complesse. È improbabile che i componenti aggiuntivi che replicano semplicemente le funzionalità già presenti nell' applicazione o che non apportano miglioramenti significativi a un flusso di lavoro superino la revisione dei componenti aggiuntivi per la pubblicazione.
Mantenere gli ambiti ristretti
Quando definisci gli ambiti
in modo esplicito, scegli sempre il
set di ambiti meno permissivo possibile. Ad esempio, non fare in modo che il componente aggiuntivo richieda l'accesso completo al calendario dell'utente con l'ambito https://www.googleapis.com/auth/calendar se ha bisogno solo dell'accesso in lettura. Per l'accesso in lettura, utilizza l'ambito https://www.googleapis.com/auth/calendar.readonly.
Evitare di fare troppo affidamento sulle raccolte
L'utilizzo delle raccolte Apps Script può rallentare l'esecuzione del componente aggiuntivo rispetto a quando tutto il codice Apps Script è contenuto in un singolo progetto di script. Sebbene le raccolte Apps Script funzionino nei componenti aggiuntivi, potresti riscontrare una riduzione delle prestazioni se le utilizzi. Evita di includere raccolte non necessarie nel progetto e valuta come ridurre la dipendenza del componente aggiuntivo da queste raccolte.
La latenza descritta sopra si applica solo ai progetti Apps Script utilizzati come raccolte lato server. Puoi utilizzare liberamente le raccolte JavaScript lato client come jQuery senza riscontrare questa latenza.
Best practice per i componenti aggiuntivi dell'editor
Le seguenti best practice si applicano solo ai componenti aggiuntivi dell'editor.
Inserire il codice HTML dell'interfaccia e il codice JavaScript lato client nei propri file di script
Puoi creare più file di script in un progetto Apps Script. È più facile gestire un componente aggiuntivo complesso se inserisci il codice HTML e JavaScript che definisce le barre laterali e le finestre di dialogo del componente aggiuntivo in file di script dedicati.
Eseguire test approfonditi in diverse modalità di autorizzazione
Quando testi il componente aggiuntivo, assicurati di provare configurazioni con file e stati di autorizzazionediversi.