Aby utworzyć nowy dodatek do Google Workspace, wykonaj te ogólne czynności:
- Skonfiguruj projekty dodatku i wybierz właściciela oraz współpracowników.
- Zaprojektuj wygląd i działanie dodatku.
- Skonfiguruj plik manifestu projektu dodatku lub zasobu wdrożenia.
- Napisać kod, który określi wygląd i działanie dodatku.
- Sprawdź zakresy uprawnień OAuth dodatku.
- Przetestuj dodatek w aplikacjach hostujących, które rozszerza.
- Opublikuj dodatek.
Konfigurowanie projektów dodatku oraz wybieranie właściciela i współpracowników
Jeśli utworzysz dodatek w Apps Script, utworzysz zarówno projekt Apps Script, jak i projekt Google Cloud. Jeśli utworzysz dodatek w języku innym niż Apps Script, wystarczy utworzyć projekt Google Cloud.
Zanim zaczniesz tworzyć dodatek, wybierz jeden konta użytkownika, aby było właścicielem projektów i decydował, które inne konta współpracowników. Właściciel projektu tworzy pliki projektu i zarządza nimi oraz powiązanymi ustawieniami, a współpracownicy mogą pomagać w kodowaniu i testowaniu.
projekty Apps Script,
Pliki projektu Apps Script dodatku możesz tworzyć na dysku współdzielonym, aby żaden użytkownik nie był ich jedynym właścicielem. Umieszczenie pliku skryptu dodatku na dysku współdzielonym zapewnia dostęp do projektu skryptu wielu współpracownikom.
Gdy publikujesz dodatek, działa jedno konto użytkownika jako wydawcy. Konto publikujące musi mieć uprawnienia do edycji skryptu projektu, ale nie musi to być właściciel.
Aby utworzyć projekt Apps Script, zapoznaj się z artykułem Projekty skryptów.
Projekty Google Cloud
Zalecamy dodanie współpracowników do Projekt Cloud. Dzięki temu członkowie Twojego zespołu będą zawsze mieli dostęp do w ustawieniach Google Cloud dotyczących dodatku.
Aby utworzyć projekt Google Cloud, przeczytaj artykuł Tworzenie projektu Google Cloud.
Projektowanie wyglądu i działania dodatku
Zdecyduj, jak ma wyglądać Twój dodatek i w jaki sposób powinien działać, zanim zaczniesz go tworzyć. Zastanów się, w jakich sytuacjach powinien próbować dostarczyć rozwiązania. Początek ma prosty projekt, który najpierw pracuje, a potem dodaje kolejne ulepszenia.
Aby uzyskać wskazówki dotyczące projektowania interfejsu użytkownika dodatku, zapoznaj się z przewodnikiem po stylach dodatków Google Workspace.
Skonfiguruj plik manifestu projektu dodatku
W projektach Apps Script plik manifestu projektu to specjalny plik JSON . Określono w nim różne szczegóły projektu, takie jak jego biblioteka zależności. W przypadku dodatków do Google Workspace manifest zawiera też podstawowe informacje, których aplikacja hosta potrzebuje do prawidłowego wyświetlania dodatku.
Więcej informacji o konfigurowaniu pliku manifestu wtyczki w Google Apps Script znajdziesz w artykule Pliki manifestu.
Dodając kod i funkcje do dodatku, edytuj manifest w taki sposób, aby uzyskać wymagany wygląd i działanie dodatku.
Kodowanie dodatku
Musisz wdrożyć interfejs oparty na kartach dla dodatku. Skrypt Apps Script Card service, a jeśli piszesz w innym języku kodu, zwróć prawidłowo sformatowany plik JSON, aby interfejs wyrenderował się jako karty.
Musisz też zaimplementować wszystkie funkcje wyzwalające określone w pliku manifestu dodatku. Jeśli wtyczka łączy się z usługą innej firmy niż Google za pomocą OAuth, musisz też skonfigurować OAuth dla tej usługi.
karty konstrukcyjne,
Interfejs użytkownika dodatku definiujesz, tworząc obiekty Card i wypełniając je widżetami. Aktywuj funkcje określone w
Plik manifestu musi zwracać jedną
Card obiekt lub tablica
Card obiekty, które reprezentują
różne „strony” w interfejsie dodatku. Twój dodatek może też tworzyć i wyświetlać nowe karty w odpowiedzi na działania użytkownika.
W Apps Script karty tworzysz za pomocą klasy CardBuilder. Każdy
karta wymaga CardHeader
i jeszcze jeden
CardSections Zalecenia
wypełnij każdą sekcję kart poszczególnymi widżetami, z których składa się
interfejsu dodatku. Widoki interakcji są zwykle powiązane z działaniami, aby określić ich zachowanie.
Po dodaniu do karty wszystkich sekcji i widżetów za pomocą
CardBuilder, musisz zadzwonić
CardBuilder.build()
aby utworzyć odpowiedni obiekt Card.
Możesz używać innych wbudowanych usług Apps Script, takich jak CalendarApp, aby pobierać informacje do wyświetlania na tworzonych przez siebie kartach dodatków.
Możesz używać danych pobieranych z usług innych firm niż Google.
Jeśli dodatek potrzebuje dostępu do interfejsów API innych niż Google, które wymagają OAuth, musisz skonfigurować tę usługę i z nią połączyć. Więcej informacji znajdziesz w przewodniku Połączenie z usługami innymi niż Google.
Zlecenie budowy
Podczas tworzenia karty musisz zacząć od góry. Oznacza to, że musisz użyć tego Zlecenie budowy:
- Utwórz widżet.
- Dodaj widżet do sekcji karty.
- Powtarzaj te czynności, aż sekcja karty będzie zawierać wszystkie widżety.
- Dodaj do karty sekcję karty.
Jest to wymagane, ponieważ po dodaniu widżetu do karty lub sekcji karty dodaję kopię tego widżetu. wszelkie zmiany wprowadzone w widżecie. obiektu po jego dodaniu nie są odzwierciedlane na ostatecznej karcie.
Działania uniwersalne
Aby zapewnić działanie niezależnie od kontekstu, możesz używać działań uniwersalnych. Działania uniwersalne to pozycje menu dostępnych w interfejsie dodatku niezależnie od tego, która karta . Wszystkie zdefiniowane działania uniwersalne są zawsze widoczne w sekcji w menu karty dodatku.
Więcej informacji znajdziesz w sekcji Działania uniwersalne. .
Sprawdź zakresy OAuth dodatku
Zakresy określają, jakie działania może wykonywać dodatek w imieniu użytkownika. Najlepiej, jeśli dodatki mają tylko te zakresy, których potrzebują do działania.
W projektach dodatków wyraźnie określ zakresy dodatków, aby mieć pewność, że dodatek używa możliwie najmniej restrykcyjnych zakresów. Zakresy, których używa dodatek, określasz w pliku manifestu dodatku.
Więcej informacji znajdziesz w sekcji Zakresy.
Testowanie dodatku
Aby przetestować nieopublikowane dodatki, zainstaluj najpierw nieopublikowane . Po zainstalowaniu i autoryzowaniu dodatku możesz go używać na swoim koncie oraz testować jego wygląd i działanie w aplikacjach hosta, do których się rozszerza. Sprawdź, czy dodatek działa zgodnie z oczekiwaniami w różnych kontekstach i w reakcji na różne działania użytkowników.
Więcej informacji znajdziesz w artykule Testowanie dodatków do Google Workspace.
Publikowanie dodatku
Opublikowanie dodatku spowoduje, że będzie on dostępny dla innych użytkowników, albo publicznie, albo tylko dla użytkowników w Twojej domenie. Zanim rozpoczniesz proces publikowania, zapoznaj się z omówieniem publikowania. Publikowanie jest złożonym procesem, który wymaga przygotowania i czasu.
Dodatki Google Workspace są publikowane w Google Workspace Marketplace. Dodatki dostępne publicznie muszą przejść sprawdzenie aplikacji, zanim zostaną opublikowane.
Przeczytaj artykuł Publikowanie dodatku Google Workspace dla: .