Jeśli masz już zbudowany i opublikowany dodatek rozszerzający Gmaila lub Kalendarz, możesz go przekształcić w dodatek Google Workspace. Instrukcje na tej stronie opisują, jak dodać funkcje Google Workspace do istniejących dodatków do Gmaila lub Kalendarza, a następnie opublikować ulepszony dodatek, aby można go było znaleźć i zainstalować.
Możesz przenieść nową funkcję do pierwotnego dodatku, aby zachować wpis w Google Workspace Marketplace, instalacje i użytkowników. Przejście na wyższą wersję umożliwia też korzystanie z nowych funkcji dodatku do Google Workspace, takich jak strony główne.
Krok 1. Utwórz kopię projektu skryptu do aplikacji dodatku
Ulepszony dodatek korzysta z tego samego projektu Google Cloud co opublikowany dodatek, ale ważne jest, aby utworzyć i używać kopii bazowego projektu Apps Script, aby nie wpływać na dotychczasowych użytkowników podczas testowania ulepszonej wersji. Uaktualnienie kopii oryginalnego projektu skryptu oznacza też, że zawsze możesz uzyskać dostęp do oryginalnego kodu i w razie potrzeby ponownie go wdrożyć.
- Otwórz istniejący projekt Apps Script dodatku do Gmaila lub dodatku do konferencji w Kalendarzu.
- Po lewej stronie kliknij Przegląd .
- Po prawej stronie kliknij Utwórz kopię .
- Po lewej stronie kliknij Ustawienia projektu > Zmień projekt.
- Kliknij Numer projektu GCP.
- Wpisz ten sam numer projektu powiązany z istniejącym, opublikowanym projektem Apps Script dodatku.
- Kliknij Ustaw projekt.
Krok 2. Zintegruj dodatek do Google Workspace
Musisz zaprojektować i wdrożyć wszystkie funkcje dodatku do Google Workspace, które chcesz dodać do swojego dodatku.
- Zaplanuj, jakie treści mają się wyświetlać na kartach strony głównej dodatku, i określ, czy mają się one pojawiać w Gmailu, Kalendarzu, na Dysku czy w dowolnej kombinacji tych 3 usług. Jeśli chcesz mieć stronę główną na więcej niż 1 platformie, zdecyduj, czy ma to być ta sama strona główna, czy też chcesz mieć niestandardowe karty strony głównej dla każdej platformy.
- W skopiowanym projekcie Apps Script dodatku utwórz karty strony głównej za pomocą funkcji
homepageTrigger. Pamiętaj, aby uwzględnić wszystkie funkcje pomocnicze lub logikę potrzebną do sterowania nowymi interfejsami strony głównej. Rozważ dodanie kart kontekstowych wywoływanych przez działanie użytkownika, takie jak otwarcie wątku wiadomości w Gmailu lub wydarzenia w Kalendarzu.
Zaktualizuj wszystkie miejsca w dodatku, w których następuje dostęp do obiektów zdarzeń (w funkcjach wywołania zwrotnego widżetu lub w funkcjach wyzwalacza kontekstowego), aby używać zaktualizowanej struktury obiektu zdarzenia. Nowa struktura nadal zawiera te same pola obiektu wydarzenia, które są używane przez dodatki do konferencji w Gmailu i Kalendarzu, ale te oryginalne pola są wycofane i zostaną ostatecznie usunięte.
Krok 3. Zaktualizuj plik manifestu dodatku
Sposób przechowywania informacji o konfiguracji w strukturze manifestu dodatków do Google Workspace znacznie różni się od struktury używanej przez dodatki do Gmaila i dodatki do konferencji w Kalendarzu. Podczas uaktualniania dodatku musisz zaktualizować pola pliku manifestu projektu Apps Script dodatku zgodnie z tabelami poniżej. Musisz zaktualizować wszystkie odpowiednie usługi podrzędne, aby odwoływały się do nowej usługi addOns.
Pamiętaj też, aby w razie potrzeby zaktualizować pole oauthScopes w pliku manifestu, aby odzwierciedlało uprawnienia wymagane przez zaktualizowany dodatek.
Więcej informacji o plikach manifestu dodatków do Google Workspace znajdziesz w sekcji Pliki manifestu.
Dodatki do Gmaila
| Pole oryginalnego pliku manifestu | Wymagane działanie |
|---|---|
gmail.composeTrigger |
Przenieś do: addOns.gmail.composeTrigger. |
gmail.contextualTriggers[] |
Przenieś listę do addOns.gmail.contextualTriggers[]. |
gmail.logoUrl |
Przenieś do: addOns.common.logoUrl. |
gmail.name |
Przenieś do: addOns.common.name. |
gmail.openLinkUrlPrefixes[] |
Przenieś listę do addOns.common.openLinkUrlPrefixes[].
|
gmail.primaryColor |
Przenieś do: addOns.common.layoutProperties.primaryColor. |
gmail.secondaryColor |
Przenieś do: addOns.common.layoutProperties.secondaryColor.
|
gmail.universalActions[] |
Przenieś listę do addOns.common.universalActions[]. |
gmail.universalActions[].text |
Przenieś każde pole gmail.universalActions[].text do odpowiedniego pola addOns.common.universalActions[].label. |
gmail.useLocalFromApp |
Przenieś do: addOns.common.useLocaleFromApp. |
Dodatki do konferencji w Kalendarzu
| Pole oryginalnego pliku manifestu | Wymagane działanie |
|---|---|
calendar.createSettingsUrlFunction |
Przenieś do: addOns.calendar.createSettingsUrlFunction. |
calendar.conferenceSolution[] |
Przenieś do: addOns.calendar.conferenceSolution[]. |
calendar.logoUrl |
Przenieś do: addOns.common.logoUrl. |
calendar.name |
Przenieś do: addOns.common.name. |
Krok 4. Przetestuj uaktualniony dodatek
Aby przetestować uaktualniony dodatek przed opublikowaniem, zapoznaj się z artykułem Testowanie dodatków do Google Workspace.
Krok 5. Poproś o sprawdzenie ulepszonego dodatku
Wszystkie dodatki do Google Workspace, zarówno te ulepszone, jak i te utworzone od podstaw, muszą zostać zatwierdzone, zanim będzie można je opublikować w Google Workspace Marketplace.
Aby przesłać dodatek do sprawdzenia, wykonaj te czynności:
Upewnij się, że dodatek spełnia wszystkie wymagania dotyczące publikowania dodatków.
Utwórz wdrożenie z określoną wersją dodatku do Google Workspace (w nowym projekcie Apps Script) przy użyciu wersji kodu, którą chcesz opublikować. Nie próbuj publikować za pomocą wdrożenia head.
Jeśli podczas uaktualniania dodatku dodasz nowe zakresy, musisz poprosić o weryfikację OAuth. Jeśli na przykład dodatek do Gmaila używa nowych zakresów Dysku lub Kalendarza w wersji dodatku do Google Workspace, musisz przesłać te nowe zakresy do weryfikacji. Weryfikacja trwa zwykle kilka dni, więc rozpocznij ten proces jak najwcześniej. Zanim przejdziesz do kroku 6, upewnij się, że dodatek został zweryfikowany.
Krok 6. Udostępnij ulepszony dodatek
Otwórz pakiet SDK Google Workspace Marketplace.
Po lewej stronie kliknij Konfiguracja. Ten panel zawiera formularz, w którym możesz podać informacje o dodatku.
Zaktualizuj krótki opis, szczegółowy opis i zrzuty ekranu w informacjach o aplikacji, aby odzwierciedlały nowe funkcje dodatku do Google Workspace.
W sekcji Rozszerzenia kliknij przycisk Przejdź na dodatek do Google Workspace. W wyświetlonym polu tekstowym wpisz nowy identyfikator wdrożenia utworzony w poprzednim kroku dla dodatku do Google Workspace. Jeśli identyfikator wdrożenia jest prawidłowy, pojawi się lista obsługiwanych hostów.
Jeśli do dodatku Google Workspace dodano nowe zakresy, pamiętaj, aby dodać je w sekcji Zakresy OAuth 2.0 na stronie Konfiguracja. Zakresy wymienione w tej sekcji powinny dokładnie odpowiadać zakresom wymienionym w pliku manifestu dodatku.
Sprawdź, czy informacje podane w formularzu są prawidłowe. Następnie kliknij Zapisz zmiany.
Jeśli masz pytania lub napotkasz problem podczas procesu uaktualniania dodatku do Google Workspace, skontaktuj się z nami.
Najczęstsze pytania
Poniżej znajdziesz odpowiedzi na najczęstsze pytania dotyczące uaktualnień dodatków:
Czy mogę uaktualnić dodatek Edytor?
Większość dodatków do edytora można przenieść do dodatków do Google Workspace. Nie można ich jednak tak łatwo przekształcić w dodatki do Google Workspace jak dodatków do Gmaila i Kalendarza.
Jeśli chcesz przenieść dodatek do edytora na dodatek do Google Workspace, musisz przepisać interfejs dodatku z HTML na interfejs oparty na kartach i zaktualizować obsługę JavaScriptu do usługi kart.
Niektóre usługi w dotychczasowym dodatku do edytora mogą być niedostępne w usłudze kart. Jeśli na przykład dodatek do edytora zawiera selektor plików, w usłudze kart dla dodatków do Google Workspace nie ma odpowiednika.
Czy mogę utworzyć osobny dodatek do Google Workspace i zachować dotychczasowy dodatek?
Możesz tworzyć dodatkowe dodatki do Google Workspace pod różnymi nazwami marek, ale nie zezwalamy na oddzielne dodatki do obsługi rozmów wideo w Gmailu lub Kalendarzu pod tą samą nazwą marki co dodatek do Google Workspace. Jeśli masz pytania lub chcesz poprosić o wyjątek, skontaktuj się z nami.
Czy po uaktualnieniu dodatku użytkownicy będą musieli ponownie autoryzować dodatek?
Jeśli dodatek do Google Workspace korzysta z tego samego projektu Cloud Platform (GCP) z powiązanym identyfikatorem klienta OAuth, użytkownicy nie będą musieli ponownie autoryzować uprawnień, które wcześniej autoryzowali w przypadku oryginalnego dodatku. Jeśli jednak podczas procesu uaktualniania dodasz nowe zakresy, użytkownicy będą musieli autoryzować te nowe zakresy przy pierwszym użyciu dodatku w wersji Google Workspace.
Czy mogę przekształcić rozszerzenie Chrome w dodatek do Google Workspace i przenieść użytkowników?
Nie. Nie możesz przenieść użytkowników, instalacji ani opinii o rozszerzeniu do Chrome. Musisz utworzyć nowy dodatek do Google Workspace i skierować użytkowników rozszerzenia do Chrome do Google Workspace Marketplace.
Czy mogę połączyć w pakiet kilka dodatków z moim dodatkiem do Google Workspace?
Zobacz artykuł Wyświetlanie listy integracji aplikacji.