Konfigurowanie aplikacji w pakiecie SDK Google Workspace Marketplace

Na tej stronie dowiesz się, jak skonfigurować aplikację w pakiecie SDK Google Workspace Marketplace i zarządzać nią w Google Workspace Marketplace.

Aby udostępnić aplikację do użytku, musisz ją skonfigurować w pakiecie Marketplace SDK. Pakiet SDK Marketplace to zestaw narzędzi, który umożliwia tworzenie aplikacji w Marketplace i zarządzanie nią. Za pomocą pakietu Marketplace SDK możesz zarządzać ustawieniami platformy, takimi jak:

• czy aplikacja jest dostępna dla konkretnej organizacji Google Workspace (aplikacja prywatna) czy dla wszystkich użytkowników Marketplace (aplikacja publiczna);
• Typy użytkowników Marketplace, którzy mogą zainstalować Twoją aplikację
• z którymi aplikacjami Google Workspace integruje się Twoja aplikacja;
• zakresy protokołu 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 Marketplace SDK do zarządzania aplikacją w Marketplace.

Włącz pakiet 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:

1. W konsoli Google Cloud otwórz stronę Wybierz projekt.

   Wybierz projekt w chmurze

2. 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

• W konsoli Google Cloud włącz pakiet SDK Google Workspace Marketplace.

  Włącz pakiet SDK

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 określasz 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 jej karta ma być niepubliczna, widoczna 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 ich imieniu.
• Używać listy dozwolonych, aby zarządzać aplikacjami w organizacji i je wybierać. 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ć 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 organizację, w której pracujesz lub do której uczęszczasz). Jeśli używasz konta dla użytkowników indywidualnych (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.
• Prywatne: tylko osoby w Twojej domenie mogą znaleźć i zainstalować aplikację.

Jeśli zdecydujesz się opublikować aplikację jako niepubliczną, nie będzie ona widoczna w wynikach przeglądania ani wyszukiwania. Użytkownicy mogą uzyskać dostęp do strony aplikacji w sklepie 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 strony 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 niej w sklepie w Marketplace.

• Instalacja dowolnego użytkownika i administratora (domyślnie): aplikację mogą zainstalować użytkownicy lub administratorzy w domenie, jednostce organizacyjnej lub grupie użytkowników. Zasady domeny użytkownika mogą uniemożliwiać mu zainstalowanie 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 domeny.

Typowe ustawienia instalacji i widoczności

W tabeli poniżej znajdziesz podsumowanie niektórych typowych opcji konfiguracji aplikacji dotyczących instalacji i widoczności:

Określanie sposobu integracji aplikacji z aplikacjami Google Workspace

Opcja Integracje aplikacji umożliwia wybór usług Google Workspace, z którymi Twoja aplikacja lub Twój dodatek ma działać, np. dodatku do Google Workspace lub aplikacji 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 Listę 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 zmiany nie zostały zapisane 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 opisujemy dodatkowe ustawienia wymagane w przypadku poszczególnych opcji:

Określ poziom dostępu wymagany przez aplikację

W sekcji Zakresy OAuth podaj pełną listę zakresów OAuth 2.0, których wymaga Twoja aplikacja. 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 Dysku, 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 informacje kontaktowe i inne dane. Te pola pojawiają się na stronie informacji o aplikacji.

Zapisywanie ustawień konfiguracji aplikacji w pakiecie SDK Marketplace

Korzystając z informacji z poprzedniej sekcji, zapisz konfigurację aplikacji w pakiecie SDK Marketplace:

1. W konsoli Google Cloud otwórz stronę Marketplace SDK – Konfiguracja aplikacji:

   Otwórz stronę konfiguracji pakietu SDK Marketplace

2. Wypełnij każdą sekcję na podstawie informacji określonych w poprzedniej sekcji.

3. Kliknij Zapisz wersję roboczą.

4. (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.

   1. Otwórz kartę Statystyki.
   2. Wpisz swój identyfikator Google Analytics.
   3. 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.workspaceMarketplaceAppConfigurationAdmin do konta, na którym brakuje uprawnień, 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ć elementów pierwotnych roles/editor lub roles/owner. Dokumentacja Bezpieczne korzystanie z IAM uznaje to za złą praktykę, ponieważ nie można łatwo ograniczyć dostępu do edycji innych zasobów w projekcie.