Dodatki do edytora budynków

Podczas tworzenia dodatku do Edytora postępuj zgodnie z tą ogólną procedurą:

  1. utworzyć projekt Apps Script,
  2. Napisz kod określający wygląd i działanie dodatku, korzystając z wbudowanej usługi HTML Apps Script.
  3. Przetestuj dodatek.
  4. Opublikuj dodatek.

Tworzenie projektu skryptu

Dodatek do edytora to samodzielny projekt Apps Script. Oddzielny przewodnik po skryptach zawiera instrukcje tworzenia nowych projektów. Możesz też otworzyć nowy skrypt. Jeśli to zrobisz, plik projektu (początkowo o nazwie Untitled project) zostanie umieszczony w głównym folderze na Dysku.

Współpraca

Gdy tworzysz dodatek wspólnie z innymi osobami, projekt dodatku jest przypisany do jednego konta użytkownika. Gdy publikujesz dodatek, rolę wydawcy pełni jedno konto użytkownika. Konto wydawcy musi mieć uprawnienia do edycji projektu skryptu dodatku, ale nie musi być właścicielem projektu.

Jest to bardzo ważne, aby uniknąć sytuacji, w których utracisz dostęp do kodu lub ustawień dodatku, ponieważ właściciel projektu opuścił organizację.

Aby zapobiec utracie dostępu do kodu dodatku, podczas współpracy nad dodatkiem korzystaj z dysków współdzielonych. Umieszczenie pliku skryptu dodatku na dysku współdzielonym sprawia, że żadne konto nie jest jedynym właścicielem projektu.

Zalecamy też, aby dodać współpracowników do projektu Cloud Platform (GCP). Dzięki temu inna osoba z zespołu zawsze będzie miała dostęp do ustawień Cloud dodatku.

Kodowanie dodatku

Po utworzeniu projektu skryptu możesz zacząć pisać kod określający wygląd i działanie dodatku. Interfejs Apps Script HTMLService służy do zbudowania interfejsu użytkownika dodatku – okien dialogowych i pasków bocznych – w tradycyjnym języku HTML i CSS. Dodatki do edytora mogą też definiować niestandardowe pozycje menu.

Podczas tworzenia kodu zapoznaj się ze wskazówkami dotyczącymi projektowania dodatków do edytora. Upewnij się też, że znasz różne stany cyklu życia autoryzacji i programujesz dla nich odpowiedni dodatek.

Testowanie dodatku

Możesz przetestować dodatki do edytora przed ich opublikowaniem, aby sprawdzić, czy działają one zgodnie z oczekiwaniami. Testowanie wymaga utworzenia konfiguracji testowej i użycia dokumentu, arkusza kalkulacyjnego, formularza lub prezentacji.

Więcej informacji znajdziesz w artykule Testowanie dodatku do Edytora.

Publikowanie dodatku

Opublikowanie dodatku spowoduje udostępnienie go innym – publicznie lub tylko użytkownikom w Twojej domenie. Przed rozpoczęciem procesu publikowania zapoznaj się z omówieniem publikacji.

Dodatki do Edytora są publikowane w Google Workspace Marketplace. Publicznie dostępne dodatki muszą przejść weryfikację dodatków przed ich opublikowaniem.

Więcej informacji znajdziesz w artykule Publikowanie dodatku do Edytora.