Migliora l'esperienza complessiva dei tuoi utenti seguendo queste guide per la progettazione dei componenti aggiuntivi.
Best practice generali
Ti invitiamo a seguire le seguenti best practice per tutti i componenti aggiuntivi che sviluppi.
Determinare la proprietà dei componenti aggiuntivi prima di iniziare
I componenti aggiuntivi sono definiti dai progetti Apps Script, che devono essere di proprietà di un account specifico oppure devono essere inseriti in un Drive condiviso. Prima di codificare un componente aggiuntivo, determina quale account dovrebbe essere proprietario del progetto e quale account agisce in qualità di publisher. Determina inoltre quali account devono agire come collaboratori e assicurati che questi account abbiano accesso al progetto di script e al progetto della piattaforma Cloud associato.
Estendi Google Workspace, non replicarlo
i componenti aggiuntivi sono concepiti per fornire nuove funzionalità alle applicazioni Google Workspace che estendono o per automatizzare attività complesse. I componenti aggiuntivi che si limitano a replicare le funzionalità già all'interno dell'applicazione o quelli che non apportano miglioramenti significativi a un flusso di lavoro hanno poche probabilità di superare la revisione dei componenti aggiuntivi per la pubblicazione.
Mantieni gli ambiti ristretti
Quando definisci i tuoi ambiti in modo esplicito,
scegli sempre l'insieme di ambiti meno permissivo possibile. Ad esempio, la richiesta del componente aggiuntivo non può avere l'accesso completo al calendario dell'utente con l'ambito https://www.googleapis.com/auth/calendar se necessita solo dell'accesso in lettura. Per l'accesso di sola lettura, utilizza l'ambito https://www.googleapis.com/auth/calendar.readonly.
Evitare di fare troppo affidamento sulle librerie
L'utilizzo delle librerie di Apps Script può causare l'esecuzione più lenta del componente aggiuntivo rispetto a quanto accadrebbe se tutto il codice di Apps Script fosse contenuto in un singolo progetto di script. Anche se le librerie di Apps Script funzionano all'interno dei componenti aggiuntivi, se li utilizzi potresti riscontrare riduzioni delle prestazioni. Evita di includere nel progetto librerie non necessarie e pensa a modi per fare in modo che i componenti aggiuntivi non vi facciano affidamento.
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 Editor
Le seguenti best practice si applicano solo al componente aggiuntivo Editor}.
Inserisci il codice 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 i codici HTML e JavaScript che definiscono le barre laterali e le finestre di dialogo dei componenti aggiuntivi in file di script dedicati a loro.
Esegui test accurati in diverse modalità di autorizzazione
Quando testi il componente aggiuntivo, assicurati di provare configurazioni con file e stati di autorizzazione diversi.