Tworzenie dodatków do Google Workspace

Gdy chcesz utworzyć nowy Google Workspace dodatek, wykonaj te ogólne czynności:

  1. Skonfiguruj projekty dodatku i wybierz właściciela i współpracowników.
  2. Zaprojektuj wygląd i działanie swojego dodatku.
  3. Skonfiguruj plik manifestu projektu lub zasób wdrożenia dodatku.
  4. Zapisz kod, aby określić wygląd i działanie dodatku.
  5. Sprawdź zakresy protokołu OAuth.
  6. Sprawdź dodatek w rozszerzanych aplikacjach hosta.
  7. Opublikuj dodatek.

Konfigurowanie projektów dodatków i wybieranie właściciela i współpracowników

Jeśli tworzysz dodatek w Apps Script, utworzysz zarówno projekt Apps Script, jak i projekt Google Cloud. Jeśli tworzysz dodatek w języku innym niż Apps Script, wystarczy utworzyć projekt Google Cloud.

Zanim zaczniesz tworzyć dodatki, wybierz konta użytkowników, które będą należące do projektów i zdecyduj, które z nich mają być współpracownicymi. Właściciel projektów tworzy pliki projektów i powiązane z nimi ustawienia oraz zarządza nimi, a współpracownicy mogą pomóc w kodowaniu i testowaniu.

Projekty Apps Script

Możesz utworzyć pliki projektu dodatku Apps Script na dysku współdzielonym, aby żadne konto nie miało do tego wyłącznego prawa. Umieszczenie pliku skryptu dodatku na dysku współdzielonym pozwala łatwo zapewnić dostęp do projektu skryptu wielu współpracownikom.

Gdy opublikujesz dodatek, wydawca będzie miał jedno konto użytkownika. Konto wydawcy musi mieć uprawnienia do edycji projektu skryptu, ale nie musi być właścicielem.

Projekty Google Cloud

Zalecamy dodanie współpracowników do projektu Cloud dodatku. Dzięki temu każdy członek Twojego zespołu będzie zawsze miał dostęp do ustawień Google Cloud dotyczących tego dodatku.

Wygląd i działanie dodatku

Zanim zaczniesz tworzyć dodatek, zdecyduj, jak powinien on wyglądać i jak powinien działać. Zastanów się, w jakich przypadkach dodatek powinien próbować przedstawić rozwiązania. Zacznij od prostego projektu, by rozpocząć pracę, a potem dodaj więcej zawężeń.

Więcej informacji na temat projektowania dodatków znajdziesz w Google Workspace przewodniku po stylu dodatku.

Skonfiguruj plik manifestu projektu dodatku

W projektach Apps Script plik manifestu projektu to specjalny plik JSON. Podaje różne informacje na temat projektu, na przykład zależności biblioteki. W przypadku Google Workspace dodatków plik manifestu zawiera też podstawowe informacje potrzebne do poprawnego wyświetlania dodatku w aplikacji hosta.

Szczegółowe informacje o tym, jak skonfigurować plik manifestu dodatku w Apps Script, znajdziesz w sekcji Pliki manifestu.

Dodając kod i funkcje, edytuj plik manifestu zgodnie z potrzebami, aby uzyskać wymagany wygląd i działanie dodatku.

Kodowanie dodatku

Musisz wdrożyć interfejs oparty na kartach. Skorzystaj z usługi kart w języku Apps Script lub jeśli piszesz w innym języku kodu, zwracaj prawidłowo sformatowany format JSON, aby interfejs mógł renderować się jako karty.

Musisz też zaimplementować wszystkie funkcje aktywatorów określone w pliku manifestu dodatku. Jeśli Twój dodatek łączy się z usługą innej firmy niż Google za pomocą protokołu OAuth, musisz też skonfigurować OAuth dla tej usługi.

Tworzenie kart

Interfejs użytkownika dodatku definiuje się, tworząc obiekty Card i wypełniając je widżetami. Funkcje aktywatora określone w pliku manifestu muszą zwracać pojedynczy obiekt Card lub tablicę obiektów Card, które reprezentują różne &&33;pages' interfejsu dodatku. Dodatek może też tworzyć i wyświetlać nowe karty w odpowiedzi na działania użytkownika.

W skrypcie aplikacji karty są tworzone za pomocą klasy CardBuilder. Każda karta musi zawierać CardHeader i co najmniej 1 CardSections. Każda sekcja karty powinna zawierać poszczególne widżety, które składają się na interfejs dodatku. Widżety interakcji są zwykle powiązane z działaniami definiującymi ich zachowanie.

Po dodaniu wszystkich sekcji i widżetów z kartą za pomocą CardBuilder musisz wywołać CardBuilder.build() i utworzyć odpowiedni obiekt Card.

Możesz użyć innych wbudowanych usług Apps Script, takich jak CalendarApp, aby pobrać informacje do wyświetlenia na utworzonych przez Ciebie kartach dodatków. Możesz użyć danych pobranych z usług innych firm.

Jeśli Twój Google Workspace dodatek wymaga dostępu do interfejsów API innych niż Google, które wymagają protokołu OAuth, musisz skonfigurować tę usługę i połączyć się z nią – więcej informacji znajdziesz w przewodniku Łączenie z usługami innymi niż Google

Zamówienie budowlane

Tworząc kartę, musisz utworzyć ją od góry. To znaczy, że musisz użyć tego zamówienia:

  1. Utwórz widżet.
  2. Dodaj widżet do sekcji karty.
  3. Powtarzaj tę czynność, aż wszystkie sekcje karty będą zawierać wszystkie widżety.
  4. Dodaj sekcję karty do karty.

Jest to wymagane, ponieważ gdy dodajesz widżet do sekcji karty lub karty, tak naprawdę dodajesz kopię tego widżetu. Zmiany, które wprowadzisz w obiekcie widżetu po dodaniu go, nie zostaną odzwierciedlone na ostatniej karcie.

Uniwersalne działania

Możesz użyć działań uniwersalnych, aby korzystać z funkcji niezależnych od kontekstu. Czynności uniwersalne to pozycje menu dostępne w interfejsie dodatku niezależnie od aktualnie wyświetlanej karty. Wszystkie zdefiniowane działania uniwersalne są zawsze wyświetlane w menu karty dodatku.

Więcej informacji znajdziesz w artykule Działania uniwersalne.

Sprawdzanie zakresów OAuth dodatku OAuth

Zakresy określają, jakie czynności może wykonywać dodatek w imieniu użytkownika. Sprawdzoną metodą dla dodatków jest podawanie zakresów tylko w przypadku czynności, które muszą być ułożone w odpowiedniej kolejności.

W projektach dodatków wyraźnie ustaw zakresy dodatków, aby mieć pewność, że dodatek korzysta z najmniej restrykcyjnych zakresów. Definiujesz zakresy, których używa dodatek w pliku manifestu.

Więcej informacji znajdziesz w sekcji Zakresy.

Testowanie dodatku

Aby przetestować nieopublikowane dodatki, najpierw zainstaluj nieopublikowany dodatek. Po zainstalowaniu i autoryzacji możesz użyć dodatku na koncie i sprawdzić jego wygląd i działanie w rozbudowanych aplikacjach hosta. Sprawdź, czy dodatek działa zgodnie z oczekiwaniami w przypadku kontekstów i działań użytkowników.

Więcej informacji znajdziesz w artykule o testowaniu Google Workspace dodatków.

Publikowanie dodatku

Opublikowanie dodatku powoduje udostępnienie go innym, publicznie lub tylko użytkownikom w domenie. Zanim rozpoczniesz proces publikowania, przeczytaj omówienie publikacji. Publikacja to skomplikowany proces, który wymaga przygotowania i czasu.

Google Workspace Dodatki są publikowane w Google Workspace Marketplace. Publicznie dostępne dodatki muszą zostać sprawdzone przed opublikowaniem.

Więcej informacji znajdziesz w sekcji Publikowanie Google Workspace dodatku.

Google Workspace Przykład dodatku

 l10n-placeholder41=

Aby pomóc Ci w sposobie stworzenia dodatków, Google Workspace Google Workspace >Koty" krótki przewodnik pokazują, jak stworzyć prosty Google Workspacedodatek, w tym strony główne, nawigację na kartach i połączenia z usługą innej firmy. Po ukończeniu krótkiego wprowadzenia możesz zainstalować dodatek i poeksperymentować z kodem.