Na tej stronie objaśniamy, jak używać pakietu SDK Google Workspace Marketplace do konfigurowania jest dostępna w Google Workspace Marketplace.
Aby udostępnić aplikację do użytku, musisz ją skonfigurować w pakiecie SDK Google Workspace Marketplace. Pakiet SDK Google Workspace Marketplace to zestaw narzędzi umożliwiający tworzenie jest dostępna w Google Workspace Marketplace. Do zarządzania używasz pakietu SDK Google Workspace Marketplace Ustawienia Marketplace, takie jak:
- Określa, czy aplikacja jest dostępna dla konkretnej organizacji korzystającej z Google Workspace. (aplikacji prywatnej) lub w przypadku wszystkich użytkowników Marketplace ( publiczna)
- Typy użytkowników Marketplace, którzy mogą instalować aplikacja
- Z którymi aplikacjami Google Workspace integruje się Twoja aplikacja
- Zakresy protokołu OAuth wymagane przez aplikację
- informacje o tym, kto stworzył i utrzymuje aplikację;
Niezależnie od tego, czy publikujesz publicznej lub prywatnej aplikacji, do zarządzania nią musisz używać pakietu SDK Google Workspace Marketplace aplikacji w Marketplace.
Włączanie pakietu SDK Google Workspace Marketplace
Jeśli jeszcze nie zostało to zrobione, w projekcie Google Cloud włącz pakiet SDK Google Workspace Marketplace:
- Otwórz konsolę Google Cloud.
- U góry kliknij Wybierz projekt. Jeśli inny projekt Google Cloud jest już otwarte, kliknij nazwę projektu Cloud, aby przełączyć Projekty w chmurze.
- Wybierz projekt aplikacji w chmurze i kliknij Otwórz.
- Na pasku wyszukiwania u góry wpisz
Google Workspace Marketplace SDKi naciśnij Enter. Otwórz stronę pakietu SDK Google Workspace Marketplace.
Jeśli pakiet SDK Google Workspace Marketplace nie jest jeszcze włączony, kliknij Włącz.
Określanie ustawień konfiguracji aplikacji
Poniżej znajdziesz opis ustawień dostępnych w aplikacji Strona konfiguracji pakietu SDK Google Workspace Marketplace.
Określ, kto może zobaczyć i zainstalować Twoją aplikację
Podczas konfigurowania aplikacji określasz użytkowników, którzy mają mieć do niej dostęp przy użyciu tych ustawień:
- Widoczność aplikacji: jeśli publikujesz aplikację w Google Workspace niezależnie od tego, czy informacje o aplikacji są niepubliczne, widoczne dla wszystkich użytkowników w organizacji lub dla każdego, kto korzysta z Google Workspace
- Ustawienia instalacji – określa, czy aplikacja może być instalowane przez administratorów Google Workspace.
Niezależnie od ustawień określonych w informacjach o aplikacji użytkownicy, którzy należą do organizacja Google Workspace może nie być w stanie wykryć, zainstalować lub korzystać z aplikacji zgodnie z ustawieniami skonfigurowanymi przez ich administratorów. Administratorzy może wpłynąć na dostępność aplikacji w taki sposób:
- Określ, czy użytkownicy mogą wyświetlać aplikacje w Marketplace i instalować aplikacje w imieniu swoich klientów, użytkowników.
- Za pomocą listy dozwolonych można wybierać aplikacje na potrzeby organizacji i nimi zarządzać. Jeśli tworzysz aplikację dla organizacji, która korzysta z list dozwolonych, sprawdź w administrator może dodać aplikację do listy dozwolonych;
- wyłączyć określone aplikacje Google Workspace, takie jak usunięcie; do Google Chat, Google Chat lub obu tych usług. W takich przypadkach użytkownicy nie będą mogli zainstalować Twojej aplikacji z Rynek.
Aby dowiedzieć się, jak administratorzy zarządzają dostępem do Marketplace, patrz Dokumentacja pomocy dla administratorów Marketplace
Ustawienia widoczności aplikacji
Jeśli korzystasz z Google Workspace, zobaczysz opcję Widoczność aplikacji. (konto utworzone przez firmę lub szkołę). Jeśli za pomocą konta dla użytkowników indywidualnych (konta kończącego się na „@gmail.com”), możesz opublikować publicznie.
- Publiczna: aplikacje mogą znaleźć i zainstalować osoby spoza w Twojej domenie. Jeśli wybierzesz widoczność publiczną, Google sprawdzi i zatwierdzi Twoją aplikację przed opublikowaniem.
- Prywatna: tylko osoby z Twojej domeny mogą znaleźć i zainstalować Twoją aplikację.
Jeśli zdecydujesz się opublikować aplikację jako niepubliczną, informacje o niej nie będą widoczne w przeglądarce. lub w wynikach wyszukiwania. Użytkownicy mogą uzyskać dostęp do strony sklepu w aplikacji tylko za pomocą polecenia bezpośredniego Adres URL.
Jeśli chcesz ograniczyć kraje i regiony, w których jest dostępna Twoja aplikacja, możesz to zrobić w sekcji Dystrybucja podczas podaj informacje o aplikacji.
Ustawienia instalowania aplikacji
Ustawienia instalacji określają, czy mogą ją instalować użytkownicy lub administratorzy Workspace ze strony z informacjami o aplikacji. w Google Workspace Marketplace.
- Instalacja indywidualna i administracyjna (domyślnie): aplikację może zainstalować przez poszczególnych użytkowników lub administratorów z ich domeny, jednostki organizacyjnej do grupy użytkowników. Zasady dotyczące domeny użytkownika mogą uniemożliwiać mu instalację nawet wtedy, gdy włączone są pojedyncze instalacje.
- Instalacja tylko przez administratora: aplikację mogą zainstalować tylko administratorzy domenę, jednostkę organizacyjną lub grupę użytkowników. Twoja aplikacja wyświetla się tylko w tych krajach: Wyniki wyszukiwania w Google Workspace Marketplace przeznaczone dla administratorów i osób, które nie są zalogowani na swoje konta Google. Wybierz tę opcję, jeśli Twoja aplikacja wymaga instalacji w domenie.
Typowe ustawienia instalacji i widoczności
W tabeli poniżej znajdziesz podsumowanie niektórych często używanych opcji konfiguracji aplikacji instalacja i widoczność:
| Docelowi użytkownicy aplikacji | Ustawienie Widoczność aplikacji | Ustawienie Instalacja aplikacji | Kto może instalować moją aplikację? | Kto może używać mojej aplikacji? | |
|---|---|---|---|---|---|
| Aplikacje stworzone dla organizacji Google Workspace | |||||
| Określeni użytkownicy w Twojej organizacji | Prywatne i Niepubliczne | Instalacja przez użytkownika indywidualnego i administratora | Każda osoba w organizacji, która ma adres URL strony aplikacji (jeśli jest to dozwolone). | Każda osoba w organizacji, która ma adres URL strony aplikacji (jeśli jest to dozwolone). | |
| Twoja organizacja | Prywatne | Instalacja przez użytkownika indywidualnego i administratora | Każda osoba w organizacji, jeśli jest to dozwolone. | Każda osoba w organizacji, jeśli jest to dozwolone. | |
| Twoja organizacja | Prywatne | Tylko administrator | Administratorzy | Użytkownicy, którzy mają aplikację zainstalowaną przez administratora. | |
| Aplikacje dostępne 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 przez użytkownika indywidualnego i administratora |
|
|
|
Sprawdź, jak Twoja aplikacja integruje się z aplikacjami Google Workspace
Wybierz usługi Google Workspace, do których ma być przeznaczona Twoja aplikacja lub dodatek takie jak dodatek do Google Workspace aplikacji Google Chat. Musisz wybrać co najmniej 1 opcję. W niektórych przypadkach możesz uwzględnić wiele integracji w informacjach o aplikacji. Zobacz Utwórz listę integracji aplikacji.
W zależności od wybranych integracji aplikacji konieczne może być przesłanie dodatkowych informacji informacje i włącz odpowiednie interfejsy API w swoim projekcie Google Cloud. Poniżej w tabeli opisano dodatkową konfigurację wymaganą w przypadku każdego z następujących elementów:
Dodatek do Google Workspace (Apps Script)
Aby opublikować dodatek do Google Workspace, musisz podać jego identyfikator wdrożenia. Aby znaleźć identyfikator wdrożenia, wykonaj te czynności:
- Otwieranie dodatku do Google Workspace w Apps Script redaktorem.
- Kliknij przycisk Wdróż > Zarządzaj wdrożeniami.
- Pod identyfikatorem wdrożenia kliknij Kopiuj.
Dodatek do Google Workspace (alternatywne środowisko wykonawcze)
Jeśli dodatek do Google Workspace został utworzony w języku innym niż Google Apps Script, wykonaj te czynności, aby uzyskać identyfikator wdrożenia z Zasób wdrożenia Google Cloud.
- Na stronie Konfiguracja aplikacji w sekcji „Dodatek do Google Workspace” kliknij Wdróż z użyciem zasobu wdrożenia w chmurze > Wybierz Wdrożenie.
- Wybierz wdrożenie, które chcesz opublikować.
- Kliknij Wybierz.
Dodatek do Edytora (Dokumenty, Arkusze, Prezentacje, Formularze)
Aby opublikować dodatek do Edytora Google, musisz podać identyfikator skryptu projektu i wersję do opublikowania.
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ę przeglądarki, wykonaj te czynności:
- Otwórz dodatek w edytorze Apps Script.
- W prawym górnym rogu kliknij Wdróż. Zarządzaj wdrożeniami.
- Numer wersji znajduje się w sekcji „Konfiguracja”.
Aplikacja Google Chat
Aby opublikować aplikację Google Chat, musisz skonfigurować interfejs Google Chat API. Zobacz Wydawnictwa
Aplikacja Dysk
Aby opublikować aplikację Dysku, musisz włączyć i skonfigurować Drive API.
Aplikacja internetowa
Aby opublikować aplikację internetową, musisz podać jej adres URL uniwersalnego nawigacji, czyli adres URL wskazuje aplikację internetową z menu aplikacji Google . Twoja aplikacja internetowa musi być w wersji produkcyjnej i w pełni funkcjonalna.
Podczas wypełniania strony Informacje o aplikacji musisz podać dodatkowe ikony. 96 x 96 i 48 x 48 pikseli.
Jeśli tworzysz aplikację internetową w Apps Script, aby uzyskać uniwersalny URL nawigacji, wykonaj te czynności:
- Otwieranie dodatku do Google Workspace w Apps Script redaktorem.
- Kliknij przycisk 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 protokołu OAuth podaj pełną listę zakresów protokołu OAuth Twojej aplikacji. wymaga. Wpisane tutaj zakresy protokołu OAuth powinny odpowiadać zakresom wyświetlanym Ekran zgody OAuth i (w stosownych przypadkach) plik manifestu Apps Script.
Jeśli uwzględniasz więcej niż jedną integrację aplikacji, pamiętaj o dodaniu zakresów z każdy z nich na stronie konfiguracji aplikacji w pakiecie SDK Google Workspace Marketplace i wpisać zgodę OAuth. ekranu.
Zawsze używaj najwęższych zakresów (np. nie uwzględniaj pełnych zakresu Dysku, jeśli potrzebujesz tylko zakresu tylko do odczytu).
W przypadku projektów Apps Script zapoznaj się z artykułem Zakresy .
Podawanie informacji o deweloperze aplikacji
W sekcji Informacje o deweloperze wpisz informacje kontaktowe i inne dane. Te pola są widoczne na stronie aplikacji z informacjami o aplikacji.
| Pola | |
|---|---|
| Status przedsiębiorcy |
Ze względu na przepisy dotyczące ochrony konsumentów konsumenci z Europy Należy poinformować, czy sprzedawca na Google Workspace Marketplace to przedsiębiorca lub osoba niebędąca przedsiębiorcą:
Jeśli nie określono inaczej, „Stan przedsiębiorcy nieokreślony” pojawia się w informacje o aplikacji stronę. |
| Adres pocztowy dewelopera |
Wymagane w przypadku przedsiębiorców. Nie są zbierane dla osób niebędących przedsiębiorcami. Lokalizacja Twojej firmy. Wpisz prawidłowy adres pocztowy, z danymi osobowymi. |
| Nazwa dewelopera | Nazwa wyświetlana jako autor aplikacji. Jeśli jesteś przedsiębiorcą, podać nazwę handlową lub nazwę prawną. |
| Adres URL witryny dewelopera | Witryna, która opisuje Ciebie (lub Twoją organizację) jako Google Play. |
| Adres e-mail dewelopera |
Adres e-mail osoby kontaktowej. Jest nie ma ich w informacjach o aplikacji. Upewnij się, że ten adres e-mail jest przechowywany za date – jest używany:
|
| URL witryny aplikacji | Opcjonalnie: Witryna, w której bardziej szczegółowo opisujesz aplikację. |
Zapisz ustawienia konfiguracji aplikacji w pakiecie SDK Google Workspace Marketplace
Korzystając z informacji z poprzedniej sekcji, zapisz konfigurację aplikacji w pakiecie SDK Google Workspace Marketplace:
- Otwórz pakiet SDK Google Workspace Marketplace.
- Otwórz kartę App Configuration (Konfiguracja aplikacji).
- Wypełnij każdą sekcję, opierając się na tym, co udało Ci się poprzedniej sekcji.
- Kliknij Zapisz.
- (Opcjonalnie) Możesz uzyskać statystyki dotyczące korzystania z aplikacji
w Google Analytics.
Aby to zrobić, dodaj identyfikator Google Analytics.
w pakiecie SDK Google Workspace Marketplace.
- Otwórz kartę Statystyki.
- Wpisz swój identyfikator Google Analytics.
- Kliknij Zapisz.