Jeśli dodatek do rozszerzania Gmaila lub Kalendarza został już utworzony i opublikowany, możesz go przekształcić w dodatek Google Workspace. Instrukcje na tej stronie zawierają szczegółowe informacje o tym, jak dodać funkcje Google Workspace do dotychczasowych 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ć informacje, instalacje i użytkowników z Google Workspace Marketplace. Dzięki przejściu na nową 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
Uaktualnione rozszerzenie korzysta z tego samego projektu Google Cloud co opublikowane rozszerzenie, ale ważne jest, aby utworzyć kopię podstawowego projektu AppsScript i z niej korzystać, aby podczas testowania uaktualnionej wersji nie wpływać na dotychczasowych użytkowników. Uaktualnianie kopii oryginalnego projektu skryptu oznacza też, że zawsze masz dostęp do oryginalnego kodu i w razie potrzeby możesz go ponownie wdrożyć.
- Otwórz istniejący projekt dodatku do Gmaila lub dodatku do kalendarza do prowadzenia konferencji w Google Apps Script.
- 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, który jest powiązany z istniejącym, opublikowanym projektem dodatku Apps Script.
- Kliknij Ustaw projekt.
Krok 2. Zintegruj dodatek Google Workspace
Musisz zaprojektować i wdrożyć funkcje dodatku Google Workspace, które chcesz dodać do swojego dodatku.
- Zaplanuj, jakie treści mają się wyświetlać na kartach na stronie głównej Twojego dodatku oraz czy mają się one pojawiać w Gmailu, Kalendarzu, Dysku czy w dowolnej kombinacji tych hostów. Jeśli chcesz mieć stronę główną w ramach więcej niż 1 hosta, zdecyduj, czy ma to być ta sama strona główna, czy chcesz mieć osobne karty stron głównych dla każdego hosta.
- W skopiowanym projekcie dodatku Apps Script utwórz karty na stronie głównej za pomocą funkcji
homepageTrigger. Pamiętaj, aby uwzględnić wszystkie funkcje pomocnicze lub logikę potrzebną do sterowania interfejsami nowych stron głównych. Zastanów się nad dodaniem kart kontekstowych aktywowanych przez działanie użytkownika, takie jak otwarcie wątku wiadomości w Gmailu lub wydarzenia w Kalendarzu.
Zaktualizuj dostęp do obiektów zdarzeń w dodatku (w funkcjach wywołania widżetu lub w funkcjach aktywatorów kontekstowych), aby używać zaktualizowanej struktury obiektu zdarzenia. Nowa struktura nadal zawiera te same pola obiektu wydarzenia, których używają dodatki do rozmów wideo w Gmailu i Kalendarzu, ale te oryginalne pola są przestarzałe i zostaną ostatecznie usunięte.
Krok 3. Zaktualizuj plik manifestu dodatku
Sposób przechowywania informacji o konfiguracji w strukturze pliku manifestu w dodatkach Google Workspace znacznie się zmienił w porównaniu ze strukturą dodatków do Gmaila i Kalendarza do prowadzenia konferencji. Podczas uaktualniania dodatku musisz zaktualizować pola w pliku manifestu projektu skryptu Apps Script zgodnie z tabelami poniżej. Musisz zaktualizować wszystkie odpowiednie usługi podrzędne do nowej usługi addOns.
W razie potrzeby zaktualizuj też pole oauthScopes w pliku manifestu, aby odzwierciedlić uprawnienia wymagane przez zaktualizowane rozszerzenie.
Więcej informacji o pliku manifestu dodatku Google Workspace znajdziesz w artykule 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 odpowiadającego mu pola addOns.common.universalActions[].label. |
gmail.useLocalFromApp |
Przenieś do addOns.common.useLocaleFromApp. |
Dodatki do Kalendarza dotyczące konferencji
| 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ć ulepszony dodatek przed opublikowaniem, zapoznaj się z artykułem Testowanie dodatków Google Workspace.
Krok 5. Poproś o opinie na temat ulepszonego dodatku
Wszystkie dodatki do Google Workspace, niezależnie od tego, czy są to ulepszone dodatki, czy też stworzone od podstaw, muszą zostać zatwierdzone, zanim będą mogły być dostępne w Google Workspace Marketplace.
Aby przesłać dodatek do sprawdzenia:
Upewnij się, że dodatek spełnia wszystkie wymagania dotyczące publikowania dodatków.
Utwórz wdrożenie z wersją dodatku do Google Workspace (w nowym projekcie Apps Script) za pomocą wersji kodu, który chcesz opublikować. Nie próbuj publikować za pomocą metody bezpośredniej.
Jeśli podczas aktualizacji dodatku dodano nowe zakresy, należy poprosić o weryfikację OAuth. Jeśli na przykład Twój dodatek do Gmaila używa nowych zakresów Dysku lub Kalendarza w wersji dodatku Google Workspace, musisz przesłać te nowe zakresy do weryfikacji. Weryfikacja często trwa kilka dni, dlatego rozpocznij proces jak najszybciej. Zanim przejdziesz do kroku 6, sprawdź, czy 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 na stronie aplikacji, aby odzwierciedlały nowe funkcje dodatku do Google Workspace.
W sekcji Rozszerzenia kliknij przycisk Przejdź na dodatek 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 dodajesz do dodatku do Google Workspace nowe zakresy, pamiętaj, aby dodać je 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 Google Workspace, skontaktuj się z nami.
Najczęstsze pytania
Poniżej znajdziesz odpowiedzi na najczęściej zadawane pytania dotyczące uaktualniania dodatków:
Czy mogę uaktualnić dodatek do edytora?
Większość dodatków do edytora można przenieść do dodatków Google Workspace. Nie można jednak przekształcić ich w dodatki Google Workspace tak łatwo jak dodatków do Gmaila i Kalendarza.
Jeśli chcesz przenieść dodatek do Edytora do dodatku do Google Workspace, musisz przerobić interfejs użytkownika z HTML na interfejs oparty na kartach oraz zaktualizować obsługę JavaScriptu do usługi kart.
Niektóre usługi w dotychczasowym dodatku Editor mogą być niedostępne w usłudze Card Service. Jeśli na przykład Twój dodatek Editor zawiera selektor plików, nie ma odpowiednika wśród dodatków Usługi kart dla Google Workspace.
Czy mogę utworzyć osobny dodatek do Google Workspace i zachować dotychczasowy?
Możesz tworzyć dodatkowe dodatki Google Workspace pod różnymi nazwami marek, ale nie zezwalaniamy na tworzenie oddzielnych dodatków do Gmaila lub Kalendarza pod tą samą nazwą marki co Twój dodatek 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 go autoryzować?
Dopóki Twój dodatek do Google Workspace korzysta z tego samego podstawowego projektu Google Cloud Platform (GCP) z powiązanym identyfikatorem klienta OAuth, użytkownicy nie będą musieli ponownie autoryzować uprawnień, które wcześniej autoryzowali dla oryginalnego dodatku. Jeśli jednak dodasz nowe zakresy uprawnień podczas procesu uaktualniania, użytkownicy będą musieli zatwierdzić te nowe zakresy uprawnień przy pierwszym użyciu wersji dodatku w Google Workspace.
Czy mogę przekształcić moje rozszerzenie Chrome w dodatek Google Workspace i przenieść użytkowników?
Nie. Nie możesz przenieść użytkowników, instalacji i opinii dotyczących listy rozszerzenia Chrome. Musisz utworzyć nowy dodatek do Google Workspace i skierować użytkowników swojej wtyczki do Chrome na Google Workspace Marketplace.
Czy mogę połączyć kilka dodatków z dodatkiem do Google Workspace?
Zobacz artykuł Lista integracji aplikacji.