Zanim zaczniesz tworzyć dodatek do edytora, zapoznaj się z limitami i ograniczeniami Apps Script, aby upewnić się, że projekt jest zgodny z tymi wytycznymi. Zapoznanie się z tymi limitami na wczesnym etapie procesu tworzenia aplikacji może pomóc w uniknięciu potencjalnych problemów w przyszłości. Apps Script idealnie nadaje się do tworzenia lekkich dodatków dla siebie, zespołu lub organizacji. Jeśli jednak planujesz utworzyć dodatek na dużą skalę, który będzie obsługiwać wielu użytkowników, wymagać niskich opóźnień lub pełnej kontroli nad infrastrukturą, rozważ opracowanie dodatku Google Workspace w innym środowisku wykonawczym.
Podczas tworzenia dodatku do Edytora postępuj zgodnie z tą ogólną procedurą:
- Utwórz projekt Apps Script.
- Napisz kod, aby określić wygląd i działanie dodatku, korzystając z wbudowanej usługi HTML Apps Script.
- Przetestuj dodatek.
- Opublikuj dodatek.
Tworzenie projektu skryptu
Dodatek do edytora to samodzielny projekt Apps Script. W przewodniku po skryptach samodzielnych znajdziesz instrukcje tworzenia nowych projektów.
Możesz też po prostu otworzyć nowy skrypt.
W takim przypadku plik projektu (początkowo o nazwie Untitled project) zostanie umieszczony w głównym folderze Dysku.
Współpraca
Gdy współpracujesz z innymi osobami przy tworzeniu dodatku, projekt dodatku jest własnością jednego konta użytkownika. Gdy opublikujesz dodatek, wydawcą będzie jedno konto użytkownika. Konto publikowania musi mieć uprawnienia do edytowania projektu skryptu dodatku, ale nie musi być właścicielem projektu.
Bardzo ważne jest, aby unikać sytuacji, w których tracisz dostęp do kodu lub ustawień dodatku, ponieważ właściciel projektu opuścił Twoją organizację.
Aby nie utracić dostępu do kodu dodatku, podczas współpracy nad nim zalecamy korzystanie z dysków współdzielonych. Umieszczenie pliku skryptu dodatku na dysku współdzielonym gwarantuje, że żaden użytkownik nie będzie jedynym właścicielem projektu.
Zalecamy też dodanie współpracowników do projektu Cloud Platform (GCP) projektu skryptu. Dzięki temu ktoś z Twojego zespołu będzie zawsze mieć dostęp do ustawień dodatku w chmurze.
Kodowanie dodatku
Po utworzeniu projektu skryptu możesz zacząć pisać kod, aby określić wygląd i działanie dodatku. Do tworzenia interfejsu użytkownika dodatku – okien i pasków bocznych – używasz usługi HtmlService Apps Script, korzystając z tradycyjnych języków HTML i CSS. Dodatki do edytora mogą też definiować niestandardowe elementy menu.
Podczas pisania kodu korzystaj z przewodnika po stylu dodatków do edytora, aby poznać wytyczne dotyczące projektowania interfejsu użytkownika dodatku. Pamiętaj też, aby poznać i zaprogramować różne stany cyklu życia autoryzacji, z którymi może się spotkać Twój dodatek.
Testowanie dodatku
Zanim opublikujesz dodatki do edytora, możesz je przetestować, aby sprawdzić, czy działają zgodnie z oczekiwaniami. Testowanie wymaga utworzenia konfiguracji testowej i użycia dokumentu, arkusza kalkulacyjnego, formularza lub prezentacji testowej.
Szczegółowe informacje znajdziesz w artykule Testowanie dodatku do edytora.
Publikowanie dodatku
Opublikowanie dodatku sprawi, że będzie on dostępny dla innych użytkowników – publicznie lub tylko dla użytkowników w Twojej domenie. Zanim rozpoczniesz proces publikowania, zapoznaj się z omówieniem publikacji.
Dodatki do edytora są publikowane w Google Workspace Marketplace. Dodatki dostępne publicznie muszą przejść weryfikację, zanim zostaną opublikowane.
Więcej informacji znajdziesz w artykule Publikowanie dodatku do edytora.