Na tej stronie dowiesz się, jak za pomocą pakietu SDK Google Workspace Marketplace konfigurować aplikację i zarządzać nią w Google Workspace Marketplace.
Aby udostępnić aplikację do użytku, musisz ją skonfigurować w pakiecie SDK Marketplace. Pakiet SDK Marketplace to zestaw narzędzi, który umożliwia tworzenie aplikacji w usłudze Marketplace i zarządzanie nią. Za pomocą pakietu SDK Marketplace możesz zarządzać ustawieniami Marketplace, takimi jak:
- czy aplikacja jest dostępna dla konkretnej organizacji Google Workspace (aplikacja prywatna) czy dla wszystkich użytkowników Marketplace (aplikacja publiczna);
- Rodzaje użytkowników Marketplace, którzy mogą zainstalować Twoją aplikację
- z którymi aplikacjami Google Workspace integruje się Twoja aplikacja;
- zakresy OAuth, których wymaga Twoja aplikacja;
- Informacje o tym, kto utworzył aplikację i kto nią zarządza
Niezależnie od tego, czy publikujesz aplikację prywatnie, czy publicznie, musisz używać pakietu SDK Marketplace do zarządzania nią w Marketplace.
Włączanie pakietu SDK Marketplace
Jeśli jeszcze tego nie zrobiono, w projekcie Google Cloud włącz pakiet SDK Marketplace.
Otwórz projekt w chmurze w konsoli Google Cloud
Jeśli nie jest jeszcze otwarty, otwórz projekt w chmurze, którego chcesz użyć w tym przykładzie:
- W konsoli Google Cloud otwórz stronę Wybierz projekt.
- Wybierz projekt w chmurze Google, którego chcesz używać. Możesz też kliknąć Utwórz projekt i postępować zgodnie z instrukcjami wyświetlanymi na ekranie. Jeśli utworzysz projekt Google Cloud, może być konieczne włączenie płatności za ten projekt.
Włączanie pakietu SDK Marketplace
Zanim zaczniesz korzystać z interfejsów API Google, musisz je włączyć w projekcie w chmurze Google. W jednym projekcie Google Cloud możesz włączyć co najmniej 1 interfejs API.W konsoli Google Cloud włącz pakiet SDK Google Workspace Marketplace.
Określanie ustawień konfiguracji aplikacji
Poniższe informacje opisują ustawienia dostępne na stronie Konfiguracja aplikacji w pakiecie SDK Marketplace.
Wybierz, kto może wyświetlać i instalować Twoją aplikację
Podczas konfigurowania aplikacji możesz określić użytkowników, którzy mogą mieć do niej dostęp, za pomocą tych ustawień:
- Widoczność aplikacji: jeśli publikujesz aplikację w organizacji Google Workspace, możesz określić, czy informacje o aplikacji będą niepubliczne, widoczne dla wszystkich użytkowników w organizacji czy dla wszystkich osób korzystających z Google Workspace.
- Ustawienia instalacji: czy aplikację mogą instalować tylko administratorzy Google Workspace.
Niezależnie od ustawień określonych w informacjach o aplikacji użytkownicy należący do organizacji Google Workspace mogą nie mieć możliwości odkrywania, instalowania ani używania aplikacji ze względu na ustawienia skonfigurowane przez administratorów. Administratorzy mogą wpływać na dostępność aplikacji w ten sposób:
- Określa, czy użytkownicy mogą wyświetlać aplikacje w Marketplace i instalować je w imieniu innych użytkowników.
- Używaj listy dozwolonych, aby zarządzać aplikacjami w organizacji i wybierać je. Jeśli tworzysz aplikację dla organizacji, która korzysta z list dozwolonych, skontaktuj się z administratorem i poproś o dodanie aplikacji do listy dozwolonych.
- wyłączyć niektóre aplikacje Google Workspace, np. usunąć dostęp do Google Chat, aplikacji Google Chat lub obu tych usług; W takich przypadkach użytkownicy nie będą mogli zainstalować Twojej aplikacji z Marketplace.
Aby dowiedzieć się, jak administratorzy zarządzają dostępem do Marketplace, zapoznaj się z dokumentacją pomocy dla administratorów Marketplace.
Ustawienia widoczności aplikacji
Opcja Widoczność aplikacji jest widoczna, jeśli używasz konta Google Workspace (konta utworzonego przez Twoją organizację służbową lub szkolną). Jeśli używasz konta konsumenckiego (konta kończącego się na „@gmail.com”), możesz publikować tylko publicznie.
- Publiczna: aplikację mogą znaleźć i zainstalować osoby spoza Twojej domeny. Jeśli wybierzesz widoczność publiczną, Google sprawdzi i zatwierdzi informacje o aplikacji przed ich opublikowaniem.
- Prywatna: tylko osoby z Twojej domeny mogą znaleźć i zainstalować aplikację.
Jeśli zdecydujesz się opublikować aplikację jako niepubliczną, informacje o aplikacji nie będą widoczne w wynikach przeglądania ani wyszukiwania. Użytkownicy mogą uzyskać dostęp do strony sklepu aplikacji tylko za pomocą bezpośredniego adresu URL.
Jeśli chcesz ograniczyć dostępność aplikacji do określonych krajów i regionów, możesz to zrobić w sekcji Dystrybucja podczas tworzenia informacji o aplikacji w sklepie.
Ustawienia instalacji aplikacji
Opcja Ustawienia instalacji określa, czy użytkownicy lub administratorzy Google Workspace mogą zainstalować Twoją aplikację ze strony informacji o aplikacji w Marketplace.
- Instalacja indywidualna i administratora (domyślna): aplikację mogą instalować poszczególni użytkownicy lub administratorzy w swojej domenie, jednostce organizacyjnej lub grupie użytkowników. Zasady domeny użytkownika mogą uniemożliwiać mu instalowanie aplikacji, nawet jeśli instalacje indywidualne są włączone.
- Instalacja tylko przez administratora: aplikację mogą instalować tylko administratorzy w swojej domenie, jednostce organizacyjnej lub grupie użytkowników. Aplikacja będzie wyświetlana w wynikach wyszukiwania w Google Workspace Marketplace tylko administratorom i osobom, które nie są zalogowane na konto Google. Wybierz tę opcję, jeśli aplikacja wymaga instalacji w domenie.
Typowe ustawienia instalacji i widoczności
W tabeli poniżej znajdziesz podsumowanie niektórych typowych opcji konfiguracji aplikacji dotyczących instalacji i widoczności:
| Docelowi użytkownicy aplikacji | Ustawienie Widoczność aplikacji | Ustawienie Instalacja aplikacji | Kto może zainstalować moją aplikację? | Kto może korzystać z mojej aplikacji? | |
|---|---|---|---|---|---|
| W przypadku aplikacji utworzonych dla organizacji korzystającej z Google Workspace | |||||
| określeni użytkownicy w Twojej organizacji; | Prywatny i Niepubliczny | Instalacja indywidualna i administracyjna | Jeśli jest to dozwolone, każda osoba w Twojej organizacji, która ma adres URL strony aplikacji. | Jeśli jest to dozwolone, każda osoba w Twojej organizacji, która ma adres URL strony aplikacji. | |
| Twojej organizacji, | Prywatne | Instalacja indywidualna i administracyjna | Jeśli jest to dozwolone, każda osoba w organizacji. | Jeśli jest to dozwolone, każda osoba w organizacji. | |
| Twojej organizacji, | Prywatne | Tylko administrator | Administratorzy | Użytkownicy, którzy mają aplikację zainstalowaną przez administratora. | |
| W przypadku aplikacji dostępnych dla użytkowników spoza określonej organizacji Google Workspace | |||||
| Użytkownicy w organizacjach Google Workspace | Publiczny | Tylko administrator | Administratorzy | Użytkownicy, którzy mają aplikację zainstalowaną przez administratora. | |
| Wszyscy użytkownicy Google Workspace | Publiczny | Instalacja indywidualna i administracyjna |
|
|
|
Określanie sposobu integracji aplikacji z aplikacjami Google Workspace
Opcja Integracje aplikacji umożliwia wybranie usług Google Workspace, z którymi Twoja aplikacja lub dodatek ma działać, np. dodatek do Google Workspace lub aplikacja do Google Chat. Musisz wybrać co najmniej 1 opcję. W niektórych przypadkach w informacjach o aplikacji możesz uwzględnić kilka integracji aplikacji. Zobacz Lista integracji aplikacji.
W przypadku każdego dodatku do Google Workspace na stronie wyświetlany jest stan publikacji dla każdego obsługiwanego produktu hosta. Dzięki temu dowiesz się, które integracje są dostępne dla Twoich użytkowników. Możliwe stany integracji aplikacji:
Unsaved: dodano lub zmodyfikowano integrację, ale nie zapisano zmian na karcie Konfiguracja aplikacji.Draft: zmiany zostały zapisane, ale nie zostały opublikowane.Under review: przesłano zaktualizowaną integrację aplikacji do sprawdzenia.Published: Integracja aplikacji jest uwzględniona w informacjach w Marketplace.
W zależności od wybranych integracji aplikacji może być konieczne podanie dodatkowych informacji i włączenie odpowiednich interfejsów API w projekcie Google Cloud. W tabeli poniżej znajdziesz opis dodatkowych ustawień wymaganych w przypadku poszczególnych opcji:
Dodatek do Google Workspace
Aby opublikować dodatek do Google Workspace, musisz podać identyfikator wdrożenia dodatku.
Aby znaleźć identyfikator wdrożenia w Apps Script:
- Otwórz dodatek do Google Workspace w edytorze Apps Script.
- Kliknij Wdróż > Zarządzaj wdrożeniami.
- Pod identyfikatorem wdrożenia kliknij Kopiuj.
Aby znaleźć identyfikator wdrożenia dodatku HTTP, wykonaj te czynności:
- Na stronie Konfiguracja aplikacji w sekcji „Dodatek do Google Workspace” kliknij Wdrożenia HTTP lub inne> Wybierz wdrożenie.
- Wybierz wdrożenie, które chcesz opublikować.
- Kliknij Wybierz.
Dodatek do edytora (Dokumenty, Arkusze, Prezentacje, Formularze)
Aby opublikować dodatek do edytora, musisz podać identyfikator skryptu projektu i wersję, którą chcesz opublikować.
Aby znaleźć identyfikator skryptu projektu, wykonaj te czynności:
- Otwórz dodatek w edytorze Apps Script.
- Po lewej stronie kliknij Ustawienia projektu .
- W sekcji „Identyfikatory” skopiuj identyfikator skryptu.
Aby sprawdzić wersję, wykonaj te czynności:
- Otwórz dodatek w edytorze Apps Script.
- W prawym górnym rogu kliknij Wdróż > Zarządzaj wdrożeniami.
- Numer wersji znajdziesz w sekcji „Konfiguracja”.
Aplikacja Google Chat
Aby opublikować interaktywną aplikację Google Chat, zapoznaj się z tymi dokumentami:
- Aby skonfigurować aplikację do obsługi czatu w interfejsie Chat API, zapoznaj się z artykułem Konfigurowanie interfejsu Chat API.
- Jeśli aplikacja do Google Chat nie jest dodatkiem do Google Workspace, musisz skonfigurować ustawienia zdarzeń interakcji w interfejsie Chat API. Instrukcje znajdziesz w artykule Otrzymywanie interakcji użytkowników i odpowiadanie na nie.
- Jeśli aplikacja do Google Chat została utworzona przy użyciu automatycznej konfiguracji AppSheet, opublikuj ją, wykonując czynności opisane w dokumentacji AppSheet w sekcji Udostępnianie aplikacji do Google Chat przy użyciu automatycznej konfiguracji.
Aplikacja Dysku
Aby opublikować aplikację na Dysku, musisz włączyć i skonfigurować interfejs Google Drive API.
Aplikacja internetowa
Aby opublikować aplikację internetową, musisz podać jej uniwersalny adres URL nawigacji, czyli adres URL, który prowadzi do aplikacji internetowej z menu aplikacji Google . Twoja aplikacja internetowa musi być w wersji produkcyjnej i w pełni funkcjonalna.
Wypełniając stronę z informacjami o aplikacji, musisz podać dodatkowe ikony o rozmiarach 96 x 96 i 48 x 48 pikseli.
Jeśli aplikacja internetowa została utworzona w Apps Script, wykonaj te czynności, aby uzyskać uniwersalny adres URL nawigacji:
- Otwórz dodatek do Google Workspace w edytorze Apps Script.
- Kliknij Wdróż> Nowe wdrożenie.
- W sekcji „Wybierz typ” kliknij Aplikacja internetowa.
- Wypełnij opcje i kliknij Wdróż.
- Kliknij Kopiuj.
Określ poziom dostępu wymagany przez aplikację
W sekcji Zakresy OAuth podaj pełną listę zakresów OAuth 2.0 wymaganych przez Twoją aplikację. Zakresy OAuth, które tu wpiszesz, powinny być zgodne z zakresami wyświetlanymi na ekranie zgody OAuth i w manifeście Apps Script (jeśli dotyczy).
Jeśli uwzględniasz więcej niż 1 integrację aplikacji, dodaj zakresy z każdej z nich na stronie konfiguracji aplikacji w pakiecie SDK Marketplace i na ekranie zgody OAuth.
Zawsze używaj jak najwęższych zakresów (np. nie uwzględniaj pełnego zakresu Drive, jeśli potrzebujesz tylko zakresu tylko do odczytu).
Więcej informacji o projektach Apps Script znajdziesz w artykule Zakresy autoryzacji.
Podawanie informacji o deweloperze aplikacji
W sekcji Informacje o deweloperze podaj dane kontaktowe i inne informacje. Te pola pojawiają się na stronie aplikacji w sklepie.
| Pola | |
|---|---|
| Status przedsiębiorcy |
Ze względu na przepisy dotyczące ochrony konsumentów musimy informować konsumentów z Europejskiego Obszaru Gospodarczego, czy sprzedawcy na platformie handlowej są przedsiębiorcami czy osobami niebędącymi przedsiębiorcami:
Jeśli nie określisz statusu, na stronie informacji o aplikacji pojawi się komunikat „Status przedsiębiorcy nieokreślony”. |
| Nazwa dewelopera | Nazwa, która będzie wyświetlana jako autor aplikacji. Jeśli jesteś przedsiębiorcą, podaj nazwę handlową lub imię i nazwisko. |
| Adres pocztowy dewelopera |
Wymagane w przypadku sprzedawców. Nie są zbierane w przypadku osób niebędących przedsiębiorcami. Lokalizacja Twojej firmy. Wpisz prawidłowy adres pocztowy, pod którym można się z Tobą skontaktować. |
| Adres URL witryny dewelopera | Witryna, w której Ty (lub Twoja organizacja) jesteś wymieniony(-a) jako deweloper. |
| Adres e-mail dewelopera |
Adres e-mail, który będzie używany jako punkt kontaktowy. Nie jest ona uwzględniona na stronie aplikacji. Upewnij się, że ten adres e-mail jest aktualny, ponieważ jest on używany:
|
| Adres URL witryny aplikacji | Opcjonalnie: Witryna, która zawiera dodatkowe informacje o aplikacji. |
Zapisywanie ustawień konfiguracji aplikacji w pakiecie SDK Marketplace
Korzystając z informacji z poprzedniej sekcji, zapisz konfigurację aplikacji w pakiecie SDK Marketplace:
W konsoli Google Cloud otwórz stronę Marketplace SDK – Konfiguracja aplikacji:
Wypełnij każdą sekcję na podstawie informacji określonych w poprzedniej sekcji.
Kliknij Zapisz kopię roboczą.
(Opcjonalnie) Możesz uzyskać dane analityczne dotyczące korzystania z aplikacji w Google Analytics. Aby to zrobić, dodaj identyfikator Google Analytics w pakiecie SDK Marketplace.
- Otwórz kartę Statystyki.
- Wpisz identyfikator Google Analytics.
- Kliknij Zapisz.
Rozwiązywanie problemów
W tej sekcji opisujemy typowe problemy, które mogą wystąpić.
Brak wymaganych uprawnień podczas publikowania aplikacji w Marketplace
Nie możesz publikować aplikacji w Marketplace, ponieważ próby skonfigurowania aplikacji na stronie Konfiguracja aplikacji w pakiecie SDK Marketplace kończą się niepowodzeniem i wyświetla się ten komunikat o błędzie:
You are missing at least one of the following required permissions: Project workspacemarketplace.appconfiguration.view / workspacemarketplace.appconfiguration.update
Ten błąd występuje, gdy interfejs Marketplace SDK API jest włączony i używasz roli IAM innej niż Editor lub Owner.
Aby rozwiązać ten problem, zastosuj jedno z tych rozwiązań:
Poproś właściciela projektu o przypisanie roli
roles/appmetadata.workspaceMarketplaceAppConfigurationAdmindo konta z brakującymi uprawnieniami, aby umożliwić mu konfigurowanie aplikacji i zarządzanie nią w pakiecie SDK Marketplace.Poproś właściciela projektu o dodanie brakujących uprawnień do roli niestandardowej na stronie Administracja > Role w konsoli Google Cloud. Następnie przypisz rolę niestandardową do konta, na którym brakuje uprawnień.
Do publikowania aplikacji można używać typów prostych
roles/editorlubroles/owner. Jednak w dokumentacji Bezpieczne korzystanie z IAM uznaje się to za złą praktykę, ponieważ nie można łatwo ograniczyć dostępu do edycji innych zasobów w projekcie.