Jeśli chcesz utworzyć nowy dodatek do Google Workspace, postępuj zgodnie z tymi ogólnymi wskazówkami procedura:
- Konfigurowanie projektów dodatku i wybieranie właściciela i współpracowników.
- Zaprojektuj wygląd i działanie dodatku.
- Skonfiguruj plik manifestu projektu dodatku lub zasobu wdrożenia.
- Napisz kod określający wygląd dodatku zachowanie użytkownika.
- Sprawdź zakresy protokołu OAuth dodatku.
- Przetestuj dodatek w aplikacje hostujące co się zmienia.
- 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 projektów tworzy pliki projektu i nimi zarządza i powiązane z nimi ustawienia, a współpracownicy mogą pomóc w kodowaniu i testowaniu.
Projekty Apps Script
Możesz utworzyć skrypt Apps Script dla swojego dodatku plików projektu w udostępnionym drive, tak aby nie jedno konto jest wyłącznym właścicielem. Umieszczanie dodatku na dysku współdzielonym umożliwia wielu współpracownikom dostęp do w projekcie skryptu.
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 dowiedzieć się, jak utworzyć projekt Apps Script, zobacz artykuł na temat projektów 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, zapoznaj się z sekcją 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.
Zapoznaj się z przewodnikiem stylistycznym na temat dodatków do Google Workspace. , aby uzyskać wskazówki dotyczące projektowania użytkownika dodatku z myślą o użytkownikach.
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 plik manifestu zawiera też podstawowe informacje informacje, których aplikacja hosta wymaga do wyświetlania nie zawiera błędów.
Szczegółowe informacje o konfigurowaniu plików manifestu znajdziesz w sekcji Pliki manifestu. z pliku manifestu dodatku w Apps Script.
Podczas dodawania kodu i funkcji do dodatku edytuj plik manifestu w razie potrzeby potrzebny do wygenerowania wymaganego dodatku jej wyglądu i działania.
Kodowanie dodatku
Musisz wdrożyć interfejs oparty na kartach Google Analytics. Użyj języka Apps Script Service 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ć dowolne reguły funkcje określone w za pomocą pliku manifestu dodatku. Jeśli łączy się z usługą innej firmy niż Google używając protokołu OAuth, musisz skonfigurować dla niego usługi.
Karty tworzenia
Interfejs użytkownika dodatku definiuje się przez utworzenie
Card obiektów i wypełnianie ich
widżety. 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. Twoje
mogą też tworzyć i wyświetlać nowe karty w
w reakcji na działania użytkownika.
W Apps Script możesz tworzyć karty za pomocą
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. Interakcja
widżety, są
są zwykle powiązane z działaniami, które określają,
ich interakcji z reklamą.
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 skryptów Apps Script
usług takich jak
CalendarApp do pobrania
wyświetlane na utworzonych przez Ciebie kartach dodatków.
Możesz używać danych pobranych z usług innych niż Google.
Jeśli Twoje dodatki do Google Workspace wymagają dostępu do interfejsów API spoza Google, które wymagają protokołu OAuth, musi skonfigurować tę usługę i połączyć się z nią – zapoznaj się z sekcją Łączenie z Przewodnik po usługach innych niż Google – .
Zlecenie budowy
Tworząc kartę, musisz zacząć od doładowania. Oznacza to, że musisz użyć tego Zlecenie budowy:
- Utwórz widżet.
- Dodaj widżet do sekcji karty.
- Powtarzaj czynność, aż w sekcji karty będą widoczne 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. po dodaniu obiektu nie są odzwierciedlane na ostatecznej karcie.
Działania uniwersalne
Możesz używać działań uniwersalnych aby zapewnić funkcje niezależne od kontekstu. Działania uniwersalne to pozycje menu dostępnych w interfejsie dodatku niezależnie od tego, która karta wyświetlenie. Wszystkie zdefiniowane działania uniwersalne są zawsze widoczne w sekcji w menu karty dodatku.
Więcej informacji znajdziesz w sekcji Działania uniwersalne. .
Sprawdzanie dodatkowych zakresów protokołu OAuth
Zakresy określają, jakie działania może wykonać dodatek w imieniu użytkownika. To zgodnie ze sprawdzonymi metodami dotyczącymi dodatków, aby miały zakresy tylko dla działań, musi spełniać funkcję porządku i nic więcej.
W projektach dodatkowych wyraźnie ustaw dodatek , aby zapewnić, dodatek używa najmniej restrykcyjnego zestawu zakresów jak to tylko możliwe. Ty określasz zakresy, w których używa Twój dodatek dodatek manifest.
Więcej informacji znajdziesz w sekcji Zakresy.
Testowanie dodatku
Aby przetestować nieopublikowane dodatki, zainstaluj najpierw nieopublikowane . Po zainstalowaniu i autoryzowaniu możesz używać dodatku na swoim koncie i przetestować jego wygląd oraz działanie w aplikacjach, Sprawdź, czy dodatek działa tak oczekiwane w kontekście kontekstów i działaniach użytkownika.
Więcej informacji znajdziesz w artykule Testowanie dodatków do Google Workspace.
Opublikuj dodatek
Gdy opublikujesz swój dodatek, zostanie on udostępniony innym użytkownikom. publicznie lub tylko użytkownikom w domenie. Przed rozpoczęciem publikowania zapoznaj się z omówieniem publikacji. Publikacja to skomplikowany proces, który wymaga i czas na jej przygotowanie.
Dodatki do Google Workspace zostały opublikowane w Google Workspace Marketplace. Dostępna publicznie dodatki muszą ukończyć sprawdzenie aplikacji przed po opublikowaniu informacji.
Przeczytaj artykuł Publikowanie dodatku Google Workspace dla: .