Jeśli masz już stworzony i opublikowany dodatek, który rozszerza Gmaila lub Kalendarz, możesz go przekształcić w dodatek do Google Workspace. Instrukcje na tej stronie zawierają szczegółowe instrukcje dodawania funkcji Google Workspace do istniejących dodatków w Gmailu lub Kalendarza, a następnie publikowania uaktualnionego dodatku, aby można było go wykryć i zainstalować.
Możesz przenieść nową funkcję do pierwotnego dodatku, aby zachować informacje o aplikacji z Google Workspace Marketplace oraz instalacje i użytkowników. Dzięki temu 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 wykorzystuje ten sam projekt Google Cloud co opublikowany dodatek, ale ważne jest, aby utworzyć kopię bazowego projektu Apps Script i użyć jej kopii. Pozwoli to uniknąć wpływu na istniejących użytkowników podczas testowania uaktualnionej wersji. Uaktualnienie kopii pierwotnego projektu skryptu oznacza również, że zawsze będziesz mieć dostęp do oryginalnego kodu i w razie potrzeby możesz go ponownie wdrożyć później.
- Otwórz istniejący dodatek do Gmaila lub projekt dodatku Apps Script 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 dodatku Apps Script.
- Kliknij Ustaw projekt.
Krok 2. Zintegruj dodatek do Google Workspace
Wszystkie funkcje dodatku do Google Workspace, które chcesz dodać, musisz zaprojektować i wdrożyć.
- Zdecyduj, jakie treści mają być wyświetlane na kartach strony głównej dodatku oraz czy powinny pojawiać się w Gmailu, Kalendarzu, na Dysku czy w dowolnej kombinacji tych 3 hostów. Jeśli chcesz, aby strona główna była dostępna na kilku hostach, określ, czy może to być ta sama strona główna, czy też chcesz używać niestandardowych kart strony głównej dla każdego hosta.
- W skopiowanym projekcie Apps Script dodatku utwórz karty strony głównej za pomocą funkcji
homepageTrigger. Pamiętaj, aby uwzględnić wszystkie funkcje pomocnicze i logikę niezbędne do sterowania nowym interfejsem strony głównej. Rozważ dodanie kart kontekstowych wywoływanych przez działanie użytkownika, np. otwarcie wątku wiadomości w Gmailu lub wydarzenia w Kalendarzu.
Zaktualizuj wszystkie uprawnienia dostępu do obiektów zdarzeń w dodatku (w funkcjach wywołań zwrotnych widżetu lub w funkcjach aktywatora kontekstowego), aby używać zaktualizowanej struktury obiektów zdarzeń. Nowa struktura nadal zawiera te same pola obiektów zdarzeń, które są używane w dodatkach do rozmów wideo w Gmailu i Kalendarzu, ale ich stare pola są wycofane i w końcu zostaną usunięte.
Krok 3. Zaktualizuj plik manifestu dodatku
Sposób przechowywania informacji o konfiguracji w strukturze pliku manifestu dodatków do Google Workspace znacznie się zmienił. Różni się też struktura dodatków do Gmaila i dodatków do rozmów wideo w Kalendarzu. Podczas uaktualniania dodatku musisz zaktualizować pola pliku manifestu dodatku w języku Apps Script zgodnie z tabelami poniżej. Musisz zaktualizować wszystkie odpowiednie usługi podrzędne do nowej usługi addOns.
Pamiętaj też, aby w razie potrzeby zaktualizować pole oauthScopes w pliku manifestu, aby odzwierciedlić uprawnienia wymagane przez zaktualizowany dodatek.
Więcej informacji o plikach manifestu dodatków do Google Workspace znajdziesz w plikach manifestu.
Dodatki do Gmaila
| Oryginalne pole pliku manifestu | Wymagane działania |
|---|---|
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 rozmów wideo w Kalendarzu
| Oryginalne 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 uaktualniony dodatek
Aby przetestować uaktualniony dodatek przed opublikowaniem, przeczytaj artykuł Testowanie dodatków do Google Workspace.
Krok 5. Poproś o sprawdzenie uaktualnionego dodatku
Wszystkie dodatki do Google Workspace (uaktualnione czy utworzone od podstaw) muszą zostać zatwierdzone, zanim będą mogły być wyświetlane 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 wersji dodatku do Google Workspace (w nowym projekcie Apps Script), korzystając z wersji kodu, którą chcesz opublikować. Nie próbuj publikować za pomocą nagłówka.
Jeśli podczas uaktualniania dodatku dodasz nowe zakresy, musisz poprosić o weryfikację OAuth. Jeśli na przykład dodatek w Gmailu korzysta z nowych zakresów Dysku lub Kalendarza w jego wersji, musisz przesłać te zakresy do weryfikacji. Weryfikacja trwa często kilka dni, więc rozpocznij ją jak najwcześniej. Zanim przejdziesz do kroku 6, upewnij się, że dodatek jest zweryfikowany.
Krok 6. Udostępnij uaktualniony dodatek
Otwórz pakiet SDK Google Workspace Marketplace.
Po lewej stronie kliknij Konfiguracja. Zawiera on formularz, w którym podajesz informacje o swoim dodatku.
Zaktualizuj krótki opis, szczegółowy opis i zrzuty ekranu wizytówki, aby odzwierciedlać nowe funkcje dodatku Google Workspace.
W sekcji Rozszerzenia kliknij przycisk Przejdź na dodatek do Google Workspace. W wyświetlonym polu tekstowym 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, aby dodać je w sekcji Zakresy OAuth 2.0 na stronie Konfiguracja. Zakresy wymienione w tej sekcji powinny dokładnie odpowiadać zakresom z 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 uaktualniania dodatku do Google Workspace, skontaktuj się z nami.
Najczęstsze pytania
Poniżej znajdziesz odpowiedzi na najczęstsze pytania dotyczące uaktualniania dodatków:
Czy mogę uaktualnić dodatek do edytora?
Większość dodatków do Edytora można przenieść do dodatków do Google Workspace. Nie można ich jednak uaktualnić do dodatków do Google Workspace tak łatwo jak dodatki do Gmaila czy Kalendarza.
Jeśli chcesz przenieść dodatek do edytora jako dodatek do Google Workspace, musisz przepisać jego interfejs z HTML na interfejs oparty na kartach i zmienić obsługę JavaScriptu na usługę kart.
Niektóre usługi w istniejącym dodatku Edytor mogą być niedostępne w usłudze Card Service. Jeśli na przykład Twój dodatek do edytora zawiera selektor plików, nie ma odpowiednika w usłudze kart dla dodatków do Google Workspace.
Czy mogę utworzyć oddzielny 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 osobne dodatki do rozmów wideo w Gmailu lub Kalendarzu o tej samej nazwie marki co Dodatek do Google Workspace. Jeśli masz pytania lub chcesz poprosić o wyjątek, skontaktuj się z nami.
Czy po uaktualnieniu moi użytkownicy będą musieli ponownie autoryzować dodatek?
Dopóki dodatek do Google Workspace korzysta z tego samego podstawowego projektu Cloud Platform (GCP), z powiązanym identyfikatorem klienta OAuth, użytkownicy nie będą musieli ponownie autoryzować uprawnień, które przyznali wcześniej w przypadku pierwotnego dodatku. Jeśli jednak podczas uaktualniania dodasz nowe zakresy, użytkownicy będą musieli autoryzować je przy pierwszym korzystaniu z 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 o rozszerzeniu do Chrome. Musisz utworzyć nowy dodatek do Google Workspace i przekierować użytkowników tego rozszerzenia do Chrome do Google Workspace Marketplace.
Czy z dodatkiem do Google Workspace mogę dołączyć wiele dodatków?
Zobacz Wyświetlanie listy integracji aplikacji.