Jeśli masz już i opublikujesz dodatek rozszerzający działanie Gmaila lub Kalendarza, możesz uaktualnić go do wersji dodatku do Google Workspace. Instrukcje na tej stronie szczegółowo wyjaśniają, jak dodać funkcje Google Workspace do dotychczasowych dodatków Gmaila lub Kalendarza, a następnie opublikować ulepszony dodatek, aby można go było wykryć i zainstalować.
Możesz przenieść nowe funkcje do pierwotnego dodatku, aby zachować informacje o użytkownikach, instalacje i użytkowników z Google Workspace Marketplace. Po przejściu na wyższą wersję możesz też korzystać z nowych funkcji dodatku do Google Workspace, takich jak strony główne.
Krok 1. Utwórz kopię projektu Apps Script dodatku
Uaktualniony dodatek używa tego samego projektu Google Cloud co opublikowany dodatek, ale ważne jest, aby utworzyć kopię bazowego projektu Apps Script i jej użyć, aby przetestowanie uaktualnionej wersji nie miało wpływu na Twoich istniejących użytkowników. Uaktualnienie kopii oryginalnego projektu skryptu oznacza też, że zawsze masz dostęp do oryginalnego kodu i w razie potrzeby możesz go wdrożyć ponownie.
- Otwórz istniejący dodatek do Gmaila lub projekt dodatku do rozmów wideo 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 numer projektu powiązany z istniejącym, opublikowanym projektem Apps Script.
- Kliknij Set project (Ustaw projekt).
Krok 2. Zintegruj dodatek do Google Workspace
Musisz zaprojektować i wdrożyć wszystkie funkcje dodatku Google Workspace, które chcesz dodać do dodatku.
- Zaplanuj, jakie treści mają być widoczne na kartach na stronie głównej dodatku oraz czy powinny się pojawiać w Gmailu, Kalendarzu, na Dysku lub w dowolnej kombinacji tych trzech hostów. Jeśli chcesz mieć stronę główną na więcej niż jednym hoście, zdecyduj, czy może to być ta sama strona główna, czy też niestandardowe karty strony głównej dla każdego z nich.
- W skopiowanym projekcie Apps Script dodatku utwórz karty strony głównej z funkcjami
homepageTrigger. Pamiętaj, aby uwzględnić funkcje pomocnicze lub logikę potrzebne do sterowania interfejsami nowej strony głównej. Rozważ dodanie kart kontekstowych uruchamianych przez działanie użytkownika, na przykład otwarcie wątku wiadomości w Gmailu lub wydarzenia w Kalendarzu.
Zaktualizuj ustawienia dostępu do obiektów zdarzeń w dodatku (w funkcjach wywołań zwrotnych widżetu lub w kontekstowych funkcjach aktywatora), aby używać zaktualizowanej struktury obiektów zdarzeń. Nowa struktura nadal będzie zawierać te same pola obiektów wydarzenia, które są używane przez dodatki do rozmów wideo w Gmailu i dodatkach do Kalendarza, ale oryginalne pola zostaną wycofane i z czasem zostaną usunięte.
Krok 3. Zaktualizuj plik manifestu dodatku
Sposób przechowywania informacji o konfiguracji w strukturze manifestu Dodatków do Google Workspace znacznie się zmienił niż struktura dodatków do Gmaila i dodatków do rozmów wideo w Kalendarzu. Podczas uaktualniania dodatku musisz zaktualizować pola manifestu projektu Apps Script dodatku zgodnie z tabelami poniżej. Musisz zaktualizować wszystkie odpowiednie usługi podrzędne do nowej usługi addOns.
Pamiętaj też, aby zaktualizować pole oauthScopes pliku manifestu, ponieważ to konieczne, aby odzwierciedlało uprawnienia wymagane przez zaktualizowany dodatek.
Więcej informacji o plikach manifestu dodatków do Google Workspace znajdziesz w tym artykule.
Dodatki do Gmaila
| Pierwotne pole pliku manifestu | Wymagane działania |
|---|---|
gmail.composeTrigger |
Przenieś do: addOns.gmail.composeTrigger. |
gmail.contextualTriggers[] |
Przenieś listę do usługi addOns.gmail.contextualTriggers[]. |
gmail.logoUrl |
Przenieś do: addOns.common.logoUrl. |
gmail.name |
Przenieś do: addOns.common.name. |
gmail.openLinkUrlPrefixes[] |
Przenieś listę do usługi addOns.common.openLinkUrlPrefixes[].
|
gmail.primaryColor |
Przenieś do: addOns.common.layoutProperties.primaryColor. |
gmail.secondaryColor |
Przenieś do: addOns.common.layoutProperties.secondaryColor.
|
gmail.universalActions[] |
Przenieś listę do usługi 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 rozmów wideo w Kalendarzu
| Pierwotne pole pliku manifestu | Wymagane działania |
|---|---|
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 ulepszony dodatek
Aby przetestować ulepszony dodatek przed opublikowaniem, zapoznaj się z sekcją Testowanie dodatków do Google Workspace.
Krok 5. Poproś o sprawdzenie uaktualnionego dodatku
Wszystkie dodatki do Google Workspace (zarówno ulepszone, jak i stworzone od podstaw) muszą zostać zatwierdzone, zanim pojawią się w Google Workspace Marketplace.
Aby przesłać dodatek do sprawdzenia, wykonaj te czynności:
Sprawdź, czy Twój dodatek spełnia wszystkie wymagania dotyczące publikowania dodatków.
Utwórz wdrożenie w wersji dodatku do Google Workspace (w nowym projekcie Apps Script) przy użyciu wersji kodu, który chcesz opublikować. Nie próbuj publikować treści za pomocą wdrożenia głównego.
Jeśli podczas uaktualniania dodatku dodano nowe zakresy, musisz poprosić o weryfikację OAuth. Jeśli na przykład dodatek do Gmaila w wersji dodatku do Google Workspace korzysta z nowych zakresów Dysku lub Kalendarza, musisz przesłać te nowe zakresy do weryfikacji. Weryfikacja często zajmuje kilka dni, więc warto zacząć ją jak najwcześniej. Zanim przejdziesz do kroku 6, upewnij się, że Twój dodatek został zweryfikowany.
Krok 6. Udostępnij uaktualniony 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 swoim dodatku.
Zaktualizuj krótki opis, szczegółowy opis oraz zrzuty ekranu wizytówki, aby odzwierciedlały nowe funkcje dodatku do Google Workspace.
W sekcji Rozszerzenia kliknij przycisk Przejdź na dodatek do Google Workspace. W polu tekstowym, które się pojawi, wpisz nowy identyfikator wdrożenia utworzony dla dodatku do Google Workspace w poprzednim kroku. Jeśli identyfikator wdrożenia jest prawidłowy, pojawi się lista obsługiwanych hostów.
Jeśli do dodatku do Google Workspace zostały dodane nowe zakresy, pamiętaj o dodaniu ich do 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 do edytora?
Większość dodatków do Edytora Google można przenieść do dodatków do Google Workspace. Nie można ich jednak uaktualnić do dodatków do Google Workspace tak łatwo, jak dodatków do Gmaila i Kalendarza.
Jeśli chcesz przenieść dodatek Edytora do dodatku do Google Workspace, musisz zmienić jego interfejs z HTML na interfejs oparty na karcie, a potem zaktualizować obsługę JavaScriptu do usługi kart.
Niektóre usługi z dotychczasowego dodatku do edytora mogą być niedostępne w usłudze karty. Jeśli na przykład dodatek do Edytora zawiera selektor plików, nie ma jego odpowiednika w usłudze karty dla dodatków do Google Workspace.
Czy mogę utworzyć oddzielny dodatek do Google Workspace i zachować dotychczasowy?
Możesz tworzyć dodatkowe dodatki do Google Workspace pod różnymi nazwami marek, ale nie zezwalamy na używanie oddzielnych dodatków do 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 moi użytkownicy będą musieli ponownie autoryzować dodatek?
Jeśli Twój dodatek do Google Workspace korzysta z tego samego podstawowego projektu Cloud Platform (GCP) z powiązanym identyfikatorem klienta OAuth, Twoi użytkownicy nie będą musieli ponownie autoryzować uprawnień, które wcześniej przyznali do korzystania z pierwotnego dodatku. Jeśli jednak w trakcie procesu uaktualniania dodasz nowe zakresy, użytkownicy będą musieli je autoryzować przy pierwszym użyciu wersji Google Workspace Twojego dodatku.
Czy mogę zmienić rozszerzenie do Chrome na dodatek do Google Workspace i przenieść użytkowników?
Nie. Nie można przenieść użytkowników, instalacji i opinii dotyczących rozszerzenia do Chrome. Musisz utworzyć nowy dodatek do Google Workspace i skierować użytkowników swojego rozszerzenia do Chrome do Google Workspace Marketplace.
Czy z dodatkiem do Google Workspace mogę dodać wiele dodatków?
Zobacz Wyświetlanie listy integracji aplikacji.