Jeśli masz już utworzony i opublikowany dodatek rozszerzający Gmaila lub Kalendarz, może uaktualnić go w dodatek do Google Workspace. Instrukcje na tej stronie szczegółowo wyjaśniają, aby dodać funkcje Google Workspace do dotychczasowych dodatków Gmaila lub Kalendarza; , a następnie opublikuj uaktualniony dodatek, aby można go było wykryć i zainstalować.
Nową funkcję możesz przenieść do pierwotnej aby zachować informacje o produktach, instalacje i użytkowników w Google Workspace Marketplace. 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 Apps Script dodatku
Uaktualniony dodatek używa tego samego projektu Google Cloud co opublikowany dodatek Google Apps, ale ważne jest, aby utworzyć i wykorzystać kopię Projekt skryptu, tak aby testy nie miały wpływu na istniejących użytkowników do zaktualizowanej wersji. Uaktualnienie kopii oryginalnego projektu skryptu oznacza, że zawsze możesz uzyskać dostęp do oryginalnego kodu i wdrożyć go później, niezbędną.
- Otwórz istniejący dodatek do Gmaila lub dodatek Apps Script do rozmów wideo w Kalendarzu w projektach AI.
- 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 to samo numer projektu powiązane z istniejącym, opublikowanym projektem Apps Script.
- Kliknij Set project (Ustaw projekt).
Krok 2. Zintegruj dodatek do Google Workspace
Musisz zaprojektować i wdrożyć funkcje dodatków do Google Workspace, do których chcesz dodać Twój dodatek.
- Zaplanuj, jakie treści mają być wyświetlane w dodatku kartami na stronie głównej powinny pojawić się w Gmailu, Kalendarzu, na Dysku lub w dowolnej kombinacji tych 3 elementów hostów. Jeśli chcesz mieć stronę główną na więcej niż jednym hoście, zdecyduj, czy może być tą samą stroną główną lub chcesz mieć niestandardowe karty strony głównej dla każdego hosta.
- Utwórz stronę główną w skopiowanym projekcie Apps Script dodatku
karty z:
homepageTriggerfunkcji. Dodaj funkcje pomocnicze lub funkcje logiczne wymagane do nad interfejsami nowej strony głównej. Rozważ dodanie kart kontekstowych uruchamianych przez działanie użytkownika, takie jak otwarcie wątek wiadomości w Gmailu lub Wydarzenie w kalendarzu.
Aktualizuj dostęp do obiektów zdarzeń. w swoim dodatku (w funkcjach wywołań zwrotnych widżetu lub w aktywatorze kontekstowym ), aby używać zaktualizowanych funkcji strukturze obiektów zdarzenia. Nowa struktura nadal będzie zawierać te same pola obiektu zdarzenia, które są używane przez w Gmailu i Kalendarzu, ale oryginalne pola są są wycofane i z czasem zostaną usunięte.
Krok 3. Zaktualizuj plik manifestu dodatku
Sposób przechowywania informacji o konfiguracji w
wyświetlaj strukturę
Dodatki do Google Workspace znacznie się zmieniły od struktury dodatków do Gmaila
oraz dodatki do rozmów wideo w Kalendarzu. Po uaktualnieniu dodatku musisz zaktualizować pola manifestu projektu Apps Script zgodnie z
do tabel poniżej. Musisz zaktualizować wszystkie odpowiednie usługi podrzędne do nowej
addOns.
Pamiętaj, aby w pliku manifestu zaktualizować też
oauthScopes jako
odzwierciedlające uprawnienia wymagane przez zaktualizowany dodatek.
Aby dowiedzieć się więcej o plikach manifestu dodatków do Google Workspace, zobacz Pliki manifestu.
Dodatki do Gmaila
| Pierwotne pole pliku manifestu | Wymagane działanie |
|---|---|
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
odpowiadające: addOns.common.universalActions[].label
. |
gmail.useLocalFromApp |
Przenieś do: addOns.common.useLocaleFromApp. |
Dodatki do rozmów wideo w Kalendarzu
| Pierwotne pole 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ś na listę addOns.common.name. |
Krok 4. Przetestuj ulepszony dodatek
Aby przetestować ulepszony dodatek przed opublikowaniem: Więcej informacji znajdziesz w artykule Testowanie dodatków do Google Workspace.
Krok 5. Poproś o sprawdzenie uaktualnionego dodatku
wszystkie dodatki do Google Workspace – zarówno te ulepszone, jak i utworzone od podstaw – muszą zostać zatwierdzone, zanim pojawią się w Google Workspace Marketplace.
Aby przesłać dodatek do sprawdzenia, wykonaj te czynności:
Upewnij się, że Twój dodatek spełnia wszystkie wymagań dotyczących publikowania dodatków.
Tworzenie wdrożenia z obsługą wersji dodatku do Google Workspace (w nowym projekcie Apps Script) przy użyciu wersji który chcesz opublikować. Nie próbuj publikować z użyciem nagłówka. lub wdrożenia.
Jeśli podczas uaktualniania dodatku dodano nowe zakresy, musisz poprosić o weryfikację OAuth. Jeśli na przykład dodatek do Gmaila używa nowych zakresów Dysku lub Kalendarza w Wersja dodatku Google Workspace. Musisz przesłać nowe zakresy do weryfikacji. Weryfikacja często zajmuje kilka dni, więc rozpocznij ją jako jak najwcześniej. Zanim przejdziesz dalej, sprawdź, czy Twój dodatek został zweryfikowany do kroku 6.
Krok 6. Udostępnij uaktualniony dodatek
Otwórz pakiet SDK Google Workspace Marketplace.
Po lewej stronie kliknij Konfiguracja. Ten panel zawiera formularz, podaj informacje o swoim dodatku.
Zaktualizuj krótki opis, szczegółowy opis oraz zrzuty ekranu swojej firmy aby uwzględnić nowe funkcje dodatku do Google Workspace.
W sekcji Rozszerzenia kliknij Przejdź na Przycisk dodatku Google Workspace. W wyświetlonym polu tekstowym wpisz nowy identyfikator wdrożenia utworzony dla dodatek 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 Google Workspace zostały dodane nowe zakresy, pamiętaj, aby dodać je do Sekcja Zakresy protokołu OAuth 2.0 na stronie Konfiguracja. Wymienione zakresy w tej sekcji powinny być dokładnie takie same jak zakresy wymienione w pliku manifestu.
Sprawdź, czy informacje podane w formularzu są prawidłowe. Następnie: kliknij Zapisz zmiany.
Jeśli masz pytania lub napotkasz problem podczas przechodzenia na ten dodatek 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 mogą one jednak być przejście na Dodatki do Google Workspace jest równie łatwe jak dodatki do Gmaila Kalendarz.
Jeśli chcesz przenieść dodatek Edytor do Google Workspace, wykonaj zmienić interfejs użytkownika dodatku z HTML na oparty na kartach i zaktualizuj JavaScript z usługą karty.
Niektóre usługi w istniejącym dodatku Edytor mogą być niedostępne Usługa kart. Jeśli na przykład dodatek do Edytora Google Ads zawiera selektor plików, nie jest odpowiednikiem w Usłudze kart 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 oddzielne dodatki do rozmów wideo w Gmailu i Kalendarzu, tej samej nazwy marki co dodatek do Google Workspace. Jeśli masz pytania lub chcesz poprosić o dostęp w takim przypadku, 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 Projekt Cloud Platform (GCP), z powiązanym identyfikatorem klienta OAuth, użytkownicy nie będą musieli ponownie autoryzować uprawnienia, którymi dysponowała wcześniej dla pierwotnego dodatku. Jeśli jednak Jeśli podczas uaktualniania dodasz nowe zakresy, użytkownicy muszą je autoryzować. nowych zakresów przy pierwszym użyciu Google Workspace. wersji 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 informacji o rozszerzeniu do Chrome opinie. Musisz utworzyć nowy dodatek do Google Workspace i kierować użytkowników Chrome do Google Workspace Marketplace.
Czy z dodatkiem do Google Workspace mogę dodać wiele dodatków?
Zobacz Wyświetlanie listy integracji aplikacji.