Sprawdzone metody

Popraw ogólne wrażenia użytkowników, korzystając z tych przewodników dotyczących projektowania dodatków.

Ogólne sprawdzone metody

Zachęcamy do stosowania tych sprawdzonych metod w przypadku wszystkich tworzonych dodatków.

Przed rozpoczęciem określ, kto jest właścicielem dodatku

Dodatki są definiowane przez projekty Apps Script, które muszą należeć do określonego konta lub znajdować się 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ą pełnić rolę współpracowników, i upewnij się, że mają one dostęp do projektu skryptu i powiązanego z nimprojektu Google Cloud.

Rozszerzaj Google Workspace, a nie powielaj go

Dodatki mają na celu dodawanie nowych funkcji do aplikacji Google Workspace, które rozszerzają, lub automatyzowanie złożonych zadań. Dodatki, które jedynie powielają funkcje już dostępne w aplikacji lub nie wprowadzają znaczących ulepszeń w przepływie pracy prawdopodobnie nie przejdą weryfikacji dodatku przed publikacją.

Ogranicz zakresy

Podczas definiowania zakresów jawnie, zawsze wybieraj najmniej restrykcyjny zestaw zakresów. Na przykład, jeśli dodatek potrzebuje tylko dostępu do odczytu, nie żądaj pełnego dostępu do Kalendarza użytkownika za pomocą zakresu https://www.googleapis.com/auth/calendar. 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 znajduje się w jednym projekcie skryptu. Biblioteki Apps Script działają w dodatkach, ale ich używanie może spowodować spadek wydajności. Unikaj dodawania do projektu niepotrzebnych bibliotek i zastanów się, jak zmniejszyć zależność dodatku od nich.

Opisane powyżej opóźnienie 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 obawy o to opóźnienie.

Sprawdzone metody dotyczące dodatków do edytora

Te sprawdzone metody dotyczą tylko dodatków do edytora.

Umieść kod HTML interfejsu i JavaScript po stronie klienta w osobnych plikach skryptu

W projekcie Apps Script możesz utworzyć wiele plików skryptu. Łatwiej jest zarządzać złożonym dodatkiem, jeśli umieścisz kod HTML i JavaScript, który definiuje paski boczne i okna dialogowe dodatku, w plikach skryptu przeznaczonych do tego celu.

Dokładnie przetestuj w różnych trybach autoryzacji

Podczas testowania dodatku wypróbuj konfiguracje z różnymi plikami i różnymi stanami autoryzacji.