Ulepszaj ogólny komfort, postępując zgodnie z tymi przewodnikami dotyczącymi dodatku projektu.
Ogólne sprawdzone metody
Zachęcamy do stosowania tych sprawdzonych metod dotyczących wszystkich dodatków, z których korzystasz i tworzenia aplikacji.
Zanim zaczniesz, ustal własność dodatku
dodatki są definiowane przez projekty Apps Script, które muszą należeć do określonego lub umieszczone na dysku współdzielonym. Przed zakodowaniem dodatku określ, do którego konta należy projekt i które jakie konto ma działać jako wydawca. Określ też, które konta mają działać jako współpracowników i upewnić się, że te konta mają dostęp do skryptu projektu i powiązanego z nim Projekt z Cloud Platform.
Rozszerz zakres Google Workspace, nie powielaj go
mają dawać nowe możliwości aplikacje Google Workspace, które rozszerzają, lub w inny sposób automatyzować złożone zadania. które powielają tylko funkcje dostępne w aplikacje lub takie, które nie powielają istotnych ulepszeń prawdopodobnie nie przejdzie weryfikacji dodatków dla publikacji.
Zawęź zakresy
Podczas jawnego zdefiniowania zakresów,
zawsze wybieraj najmniej restrykcyjny zestaw zakresów. Nie stosuj na przykład:
poproś o pełny dostęp do Kalendarza użytkownika za pomocą
https://www.googleapis.com/auth/calendar zakres, jeśli potrzebuje tylko odczytu
dostęp. Aby uzyskać dostęp tylko do odczytu, użyj
Zakres: https://www.googleapis.com/auth/calendar.readonly.
Unikanie nadmiernego polegania na bibliotekach
Korzystanie z bibliotek Apps Script może spowodować aby działał wolniej niż on gdyby cały kod Apps Script był zawarty w jednym projekcie skryptu. Chociaż biblioteki Apps Script działają w dodatkach, możesz napotkać wydajność ich stosowania. Unikaj dodawania niepotrzebnych bibliotek do projektu i zastanów się, jak ograniczyć zależność od nich.
Opisane powyżej opóźnienie dotyczy tylko używanych projektów Apps Script jako biblioteki po stronie serwera. Możesz używać bibliotek JavaScript po stronie klienta, takich jak możesz swobodnie korzystać z jQuery bez napotykania opóźnień.
Sprawdzone metody dotyczące dodatku do Google Workspace
Te sprawdzone metody dotyczą tylko Dodatki do Google Workspace i zastosowanie w usłudze kart.
Korzystanie tylko z kilku kart
Jeśli dodatek korzysta ze zbyt wielu kart, konfiguracja nawigacji staje się złożone i trudne do zarządzania.
Unikaj impulsu do tworzenia większej liczby kart, niż jest to konieczne.
Korzystanie z funkcji tworzenia widżetów
Podczas pisania kodu, który tworzy Card
lub innych złożonych obiektów interfejsu, rozważ umieszczenie tego kodu w osobnej funkcji.
Ta funkcja tworzenia powinna po prostu skompilować obiekt i go zwrócić. Dzięki temu
możesz szybko wygenerować go ponownie po każdym odświeżeniu interfejsu użytkownika. Zapamiętaj
aby wywołać build() po użyciu klas konstruktora w sekcji
Usługa kart.
Karty powinny być proste
Jeśli dana karta ma za dużo widżetów, może wypełnić zbyt dużą część ekranu mogą stać się mniej przydatne. Duże sekcje kart renderują się jako zwijane elementy interfejsu, powoduje ukrycie informacji przed użytkownikiem. Spróbuj zoptymalizować dodatek i zapewnij dokładnie to, czego użytkownik potrzebuje, i nie tylko.
Korzystanie z kart błędów
Utwórz karty z warunkami błędów. Jeśli dodatek generuje błąd, powinien Wyświetlenie karty z informacjami o błędzie i instrukcjami jego poprawienia jeśli to możliwe. Jeśli na przykład dodatek nie może połączyć się z , ponieważ autoryzacja nie powiodła się, wyświetl kartę z informacją o tym i zapytaj użytkownik musi zweryfikować używane informacje o koncie.
Pisanie testów i wiadomości testowych
Dokładnie przetestuj wszystkie utworzone dodatki. Utwórz funkcje testowe, które tworzyć karty i widżety na podstawie danych testowych, a następnie sprawdzać, czy obiekty utworzony zgodnie z oczekiwaniami.
Podczas korzystania z funkcji wywołania zwrotnego działania: musisz zwykle utworzyć obiekt odpowiedzi. Możesz użyć takich wyrażeń jak Wykonaj te czynności, aby sprawdzić, czy odpowiedzi są formułowane prawidłowo:
Logger.log(response.printJson());
Uruchamiaj funkcje testowe utworzone bezpośrednio z poziomu Apps Script w edytorze, klikając menu Uruchom. Jeśli Twój dodatek działa dobrze, pamiętaj, aby zainstalować nieopublikowaną wersję aby ją przetestować.
Użyj danych testowych odpowiednich dla każdej aplikacji hosta rozszerzenia. Dla: Jeśli na przykład dodatek rozszerza Gmaila, prawdopodobnie będziesz potrzebować kilku testowych e-maili i ich identyfikatorów wiadomości, aby zapewnić, że dodatek będzie działać oczekiwano od innych treści. Możesz uzyskać identyfikator wiadomości dla daną wiadomość, wymieniając wiadomości przy użyciu Gmail API Users.messages.list lub za pomocą biblioteki Apps Script Usługa Gmail.
Sprawdzone metody dotyczące rozmów w Kalendarzu
Jeśli Twój dodatek integruje rozwiązania innych firm rozmowy w kalendarzu , skorzystaj z tych dodatkowych sprawdzonych metod:
Nie wyłączaj lampki onCreateFunction
Co onCreateFunction
zdefiniowane w pliku manifestu jest wywoływane synchronicznie, gdy użytkownik próbuje
przy tworzeniu rozwiązania
konferencyjnego tego typu. Upewnij się, że te funkcje wykonują tylko
minimalny nakład pracy potrzebny, by utworzyć konferencję. Ćwiczenie za bardzo
mogą spowolnić działanie dodatku.
Do przechowywania danych rozmów wideo użyj odpowiednich pól ConferenceData
Gdy tworzysz
ConferenceData
obiektów, możesz wypełnić je szczegółowymi informacjami o konferencji (dostęp
kody, numery telefonów, kody PIN, identyfikatory URI itp.). Pamiętaj, aby użyć odpowiedniej wartości
Pole EntryPoint
tych informacji. Nie umieszczaj tych informacji w sekcji ConferenceData
notatek.
Nie dodawaj szczegółów rozmowy do wydarzenia w Kalendarzu Google
Dodatek nie musi dodawać informacji o utworzonych firmach zewnętrznych rozmowy wideo w opisie wydarzenia w Kalendarzu Google. Kalendarz Google automatycznie w razie potrzeby.