Konfigurowanie aplikacji w pakiecie SDK Google Workspace Marketplace

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:

  1. Otwórz konsolę Google Cloud.
  2. 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.
  3. Wybierz projekt aplikacji w chmurze i kliknij Otwórz.
  4. Na pasku wyszukiwania u góry wpisz Google Workspace Marketplace SDK i naciśnij Enter.
  5. Otwórz stronę pakietu SDK Google Workspace Marketplace.

  6. 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
  • każdego, kto korzysta z aplikacji Google Workspace do użytku osobistego.
  • Użytkownicy z organizacji Google Workspace (jeśli są dozwolone).
  • każdego, kto korzysta z aplikacji Google Workspace do użytku osobistego.
  • Użytkownicy z organizacji Google Workspace (jeśli są dozwolone).

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 identyfikatora wdrożenia. Aby znaleźć identyfikator wdrożenia, wykonaj te czynności:

  1. Otwieranie dodatku do Google Workspace w Apps Script redaktorem.
  2. Kliknij przycisk Wdróż > Zarządzaj wdrożeniami.
  3. Pod identyfikatorem wdrożenia kliknij Kopiuj.

Dodatek do Google Workspace (Wdrożenia HTTP)

Jeśli dodatek do Google Workspace został utworzony przy użyciu punktów końcowych HTTP, wykonaj te czynności, aby uzyskać identyfikator wdrożenia z Zasób wdrożenia Google Cloud.

  1. Na stronie Konfiguracja aplikacji w sekcji „Dodatek do Google Workspace” kliknij Wdróż z użyciem zasobu wdrożenia w chmurze > Wybierz Wdrożenie.
  2. Wybierz wdrożenie, które chcesz opublikować.
  3. 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:

  1. Otwórz dodatek w edytorze Apps Script.
  2. Po lewej stronie kliknij Ustawienia projektu.
  3. W sekcji „Identyfikatory” skopiuj identyfikator skryptu.

Aby sprawdzić wersję przeglądarki, wykonaj te czynności:

  1. Otwórz dodatek w edytorze Apps Script.
  2. W prawym górnym rogu kliknij Wdróż. Zarządzaj wdrożeniami.
  3. 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:

  1. Otwieranie dodatku do Google Workspace w Apps Script redaktorem.
  2. Kliknij przycisk Wdróż > Nowe wdrożenie.
  3. W sekcji „Wybierz typ” kliknij Aplikacja internetowa.
  4. Wypełnij opcje i kliknij Wdróż.
  5. 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 Unii Europejskiej Należy poinformować, czy sprzedawca na Google Workspace Marketplace to przedsiębiorca lub osoba niebędąca przedsiębiorcą:

  • Przedsiębiorca – osoba, która działa w celach związanych z branży, firmy, rzemiosła lub zawodu; lub w imieniu użytkownika lub w dniu w imieniu przedsiębiorcy.
  • Osoba niebędąca przedsiębiorcą – osoba niebędąca przedsiębiorcą (konsument) to osoba, która działa w imieniu w celach niezawodowych.

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 aktualny date – jest używany:

  • Jeśli Google musi skontaktować się z deweloperem – na przykład podczas procesu sprawdzania aplikacji.
  • Aby przesłać opinię z dodatków edytora, jeśli adres URL zgłaszania problemu nie jest podany na stronie Informacje o aplikacji.
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:

  1. Otwórz pakiet SDK Google Workspace Marketplace.
  2. Otwórz kartę App Configuration (Konfiguracja aplikacji).
  3. Wypełnij każdą sekcję, opierając się na tym, co udało Ci się poprzedniej sekcji.
  4. Kliknij Zapisz.
  5. (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.
    1. Otwórz kartę Statystyki.
    2. Wpisz swój identyfikator Google Analytics.
    3. Kliknij Zapisz.