Sprawdzone metody

Aby poprawić ogólne wrażenia 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 Ciebie 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 jego wydawcą. 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 w Google Cloud.

Rozszerz możliwości Google Workspace, a nie powielaj ich

Dodatki mają zapewniać nowe funkcje w aplikacji Google Workspace, którą rozszerzają, lub automatyzować złożone zadania. Dodatki, które tylko powielają funkcje już dostępne w aplikacji, lub nie wprowadzają znaczących ulepszeń w procesie pracy, prawdopodobnie nie przejdą sprawdzenia pod kątem opublikowania.

Zakresy powinny być wąskie

Podczas określania zakresów w sposób jawny zawsze wybieraj zestaw zakresów o jak najmniejszym zakresie. Na przykład nie proś o pełny dostęp do kalendarza użytkownika w zakresie https://www.googleapis.com/auth/calendar, jeśli dodatek potrzebuje tylko dostępu tylko do odczytu. W przypadku dostępu 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 używać 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 do Edytora.

 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 i okna dialogowe dodatku 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.