Aby zwiększyć ogólny komfort użytkowników, postępuj zgodnie z tymi wskazówkami dotyczącymi projektowania dodatków.
Ogólne sprawdzone metody
Zachęcamy do stosowania tych sprawdzonych metod w przypadku wszystkich tworzonych przez siebie dodatków.
Zanim zaczniesz, sprawdź, kto jest właścicielem dodatku
Dodatki są definiowane przez projekty Apps Script, które muszą należeć do konkretnego konta lub być umieszczone na dysku współdzielonym. Zanim zaczniesz kodować dodatek, określ, które konto powinno być właścicielem projektu, a które będzie pełnić rolę wydawcy. Określ też, które konta mają działać jako współpracownicy, i upewnij się, że mają one dostęp do projektu skryptu i powiązanego z nim projektu Google Cloud.
Rozszerz możliwości Google Workspace, a nie powielaj ich
Dodatki mają zapewniać nowe funkcje aplikacji Google Workspace, które rozszerzają, lub automatyzować złożone zadania. Dodatki, które jedynie powielają funkcje już dostępne w aplikacji, lub te, które nie wprowadzają znaczących ulepszeń w procesie, prawdopodobnie nie przejdą sprawdzenia pod kątem publikacji.
Zakresy powinny być wąskie
Podczas określania zakresów zawsze wybieraj możliwie najbardziej restrykcyjne zakresy. Na przykład nie proś o pełny dostęp do kalendarza użytkownika z zakresem https://www.googleapis.com/auth/calendar, jeśli dodatek potrzebuje tylko dostępu tylko do odczytu. Aby uzyskać dostęp tylko do odczytu, użyj zakresu https://www.googleapis.com/auth/calendar.readonly.
Unikaj nadmiernego polegania na bibliotekach
Korzystanie z bibliotek Apps Script może spowodować, że dodatek będzie działać wolniej niż wtedy, gdy cały kod Apps Script byłby zawarty w pojedynczym projekcie skryptu. Biblioteki Apps Script działają w dodatkach, ale ich używanie może spowodować spadek wydajności. Unikaj umieszczania w projekcie niepotrzebnych bibliotek i zastanów się, jak ograniczyć ich użycie w dodatku.
Opóźnienie opisane powyżej dotyczy tylko projektów Apps Script używanych jako biblioteki po stronie serwera. Możesz swobodnie korzystać z bibliotek JavaScript po stronie klienta, takich jak jQuery, bez opóźnień.
Sprawdzone metody dotyczące dodatków do edytora
Poniższe sprawdzone metody dotyczą tylko dodatku Editor.
Umieszczaj kod HTML interfejsu i kod JavaScript po stronie klienta w osobnych plikach skryptów
W projekcie Apps Script możesz utworzyć wiele plików skryptu. Zarządzanie złożonym dodatkiem jest łatwiejsze, jeśli umieścisz kod HTML i JavaScript definiujący paski boczne dodatku oraz okna dialogowe w dedykowanych im plikach skryptu.
Dokonywanie dokładnych testów w różnych trybach autoryzacji
Podczas testowania dodatku wypróbuj różne konfiguracje z różnymi plikami i różnymi stanami autoryzacji.