App im Google Workspace Marketplace SDK konfigurieren

Auf dieser Seite wird erläutert, wie Sie mit dem Google Workspace Marketplace SDK im Google Workspace Marketplace.

Damit Sie Ihre App verwenden können, müssen Sie sie im Google Workspace Marketplace SDK einrichten. Das Google Workspace Marketplace SDK ist ein Toolkit, mit dem Sie im Google Workspace Marketplace. Sie verwenden das Google Workspace Marketplace SDK, Marketplace-Einstellungen wie die folgenden:

  • Ob Ihre App für eine bestimmte Google Workspace-Organisation verfügbar ist (eine private App) oder für alle Marketplace-Nutzer (ein public App)
  • Die Typen der Marketplace-Nutzer, die Ihre App
  • In welche Google Workspace-Anwendungen Ihre App eingebunden werden kann
  • Die für Ihre Anwendung erforderlichen OAuth-Bereiche
  • Informationen darüber, wer die App entwickelt und verwaltet hat

Unabhängig davon, ob Sie Ihre App öffentlich oder privat veröffentlicht werden soll, müssen Sie das Google Workspace Marketplace SDK verwenden, um Ihre im Marketplace angeboten.

Google Workspace Marketplace SDK aktivieren

Falls noch nicht geschehen, erstellen Sie in Ihrem Google Cloud-Projekt Aktivieren Sie das Google Workspace Marketplace SDK:

  1. Öffnen Sie die Google Cloud Console.
  2. Klicken Sie oben auf Projekt auswählen. Wenn ein anderes Google Cloud-Projekt bereits geöffnet ist, klicken Sie auf den Namen des Cloud-Projekts, um zu wechseln Cloud-Projekte
  3. Wählen Sie das Cloud-Projekt Ihrer Anwendung aus und klicken Sie auf Öffnen.
  4. Geben Sie oben in der Suchleiste Google Workspace Marketplace SDK ein und drücken Sie die Eingabetaste.
  5. Öffnen Sie die Seite für das Google Workspace Marketplace SDK.

  6. Wenn das Google Workspace Marketplace SDK noch nicht aktiviert ist, klicken Sie auf Aktivieren.

Konfigurationseinstellungen für Ihre Anwendung festlegen

In der folgenden Referenz werden die Einstellungen beschrieben, die in der App Konfiguration des Google Workspace Marketplace SDK.

Festlegen, wer Ihre App ansehen und installieren darf

Bei der Konfiguration Ihrer App geben Sie die Nutzer an, die auf Ihre App zugreifen können mit den folgenden Einstellungen:

  • App-Sichtbarkeit: Wenn Sie eine App innerhalb einer ob Ihr App-Eintrag nicht gelistet ist, sichtbar für alle Nutzer in Ihrer Organisation oder für jeden, der Google Workspace
  • Installationseinstellungen: Hiermit legen Sie fest, ob die App nur von Google Workspace-Administratoren installiert werden.

Unabhängig von den Einstellungen, die Sie in Ihrem App-Eintrag festlegen, kann eine Google Workspace-Organisation oder deine App basierend auf den Einstellungen, die von ihren Administratoren festgelegt wurden, zu verwenden. Administratoren kann sich folgendermaßen auf die Verfügbarkeit Ihrer App auswirken:

  • Sie können steuern, ob Nutzer Apps im und Apps im Namen des Nutzenden.
  • Mit einer Zulassungsliste können Sie Apps für ihre Organisation verwalten und zusammenstellen. Wenn Sie eine App für eine Organisation entwickeln, in der Zulassungslisten verwendet werden, wenden Sie sich um die App auf die Zulassungsliste zu setzen.
  • Bestimmte Google Workspace-Apps deaktivieren, z. B. das Entfernen von Apps Zugriff auf Google Chat und/oder Google Chat-Apps. In diesen Fällen können Nutzer Ihre App nicht über die Marktplatz.

Um zu erfahren, wie Administratoren den Zugriff auf Marketplace finden Sie in der Marketplace-Admin-Hilfe

Einstellungen für die App-Sichtbarkeit

Die Option Sichtbarkeit von Apps wird in Google Workspace angezeigt. -Konto, also ein Konto, das von Ihrem Unternehmen oder Ihrer Bildungseinrichtung erstellt wurde. Wenn Sie Wenn Sie ein Privatnutzerkonto verwenden, also ein Konto, das auf „@gmail.com“ endet, können Sie nur für die Veröffentlichung öffentlich gemacht werden.

  • Öffentlich: Die App kann von Personen außerhalb Ihres Zuhauses gefunden und installiert werden. . Wenn du die öffentliche Sichtbarkeit auswählst, prüft und genehmigt Google deine App bevor sie veröffentlicht werden.
  • Privat: Nur Personen innerhalb Ihrer Domain können Ihre App finden und installieren.

Wenn du deine App als Nicht gelistet veröffentlichst, wird der App-Eintrag nicht im Browser angezeigt. oder Suchergebnisse. Nutzer können die Store-Seite der App nur über die direkte URL

Wenn Sie einschränken möchten, in welchen Ländern und Regionen Ihre App verfügbar ist, die Sie im Abschnitt Verteilung eingerichtet haben, Erstellen Sie den Store-Eintrag.

Einstellungen für die App-Installation

Mit den Installationseinstellungen wird festgelegt, ob Nutzer oder Workspace-Administratoren die App installieren können Ihre App über die Seite des Store-Eintrags im Google Workspace Marketplace.

  • Installation durch Administrator + Administrator (Standardeinstellung): Die App kann über von einzelnen Nutzern oder von Administratoren für ihre Domain, Organisationseinheit oder Gruppe von Nutzenden. Die Domainrichtlinien eines Nutzers verhindern möglicherweise die Installation. auch wenn einzelne Installationen aktiviert sind.
  • Installation nur durch Administrator: Die App kann nur von Administratoren für ihre eigenen Domain, Organisationseinheit oder Nutzergruppe. Ihre App erscheint nur in Google Workspace Marketplace-Suchergebnisse für Administratoren und Personen, die nicht in ihrem Google-Konto angemeldet sind. Wählen Sie diese Option aus, wenn Ihre App erfordert eine Domaininstallation.

Allgemeine Installations- und Sichtbarkeitseinstellungen

In der folgenden Tabelle sind einige gängige Konfigurationsoptionen für Installation und Sichtbarkeit:

Beabsichtigte App-Nutzer Einstellung für die App-Sichtbarkeit Einstellung für App-Installation Wer kann meine App installieren? Wer kann meine App verwenden?
Für Apps, die für eine Google Workspace-Organisation entwickelt wurden  
Bestimmte Nutzer in Ihrer Organisation Privat und Nicht gelistet Einzelinstallation und Installation durch Administrator Sofern zulässig, jede Person in Ihrer Organisation, die die URL des App-Eintrags hat. Sofern zulässig, jede Person in Ihrer Organisation, die die URL des App-Eintrags hat.
Meine Organisation Privat Einzelinstallation und Installation durch Administrator Sofern zulässig, alle in Ihrer Organisation. Sofern zulässig, alle in Ihrer Organisation.
Meine Organisation Privat Nur Administratoren Administratoren Nutzer, die die App von ihrem Administrator installiert haben
Für Apps, die für Nutzer außerhalb einer bestimmten Google Workspace-Organisation verfügbar sind  
Nutzer in Google Workspace-Organisationen Öffentlich Nur Administratoren Administratoren Nutzer, die die App von ihrem Administrator installiert haben
Alle Google Workspace-Nutzer Öffentlich Einzelinstallation und Installation durch Administrator
  • Alle, die Google Workspace-Anwendungen privat nutzen.
  • Sofern zulässig, Nutzer in Google Workspace-Organisationen.
  • Alle, die Google Workspace-Anwendungen privat nutzen.
  • Sofern zulässig, Nutzer in Google Workspace-Organisationen.

Ermitteln, wie sich Ihre Anwendung in Google Workspace-Anwendungen einbinden lässt

Google Workspace-Dienste auswählen, für die Ihre App oder Ihr Add-on entwickelt werden soll mit denen Sie arbeiten können, z. B. ein Google Workspace-Add-on oder ein Google Chat App. Sie müssen mindestens eine Option auswählen. In einigen Fällen können Sie mehrere App-Integrationen in Ihren App-Eintrag aufnehmen. Weitere Informationen finden Sie unter Listen Sie App-Integrationen zusammen auf.

Je nachdem, für welche App-Integrationen Sie sich entscheiden, und relevante APIs in Ihrem Google Cloud-Projekt zu aktivieren. Die folgenden In der Tabelle wird die zusätzliche Einrichtung beschrieben, die jeweils erforderlich ist:

Google Workspace-Add-on (Apps Script)

Wenn Sie ein Google Workspace-Add-on veröffentlichen möchten, müssen Sie die Bereitstellungs-ID. So finden Sie die Bereitstellungs-ID:

  1. Google Workspace-Add-on in Apps Script öffnen Editor.
  2. Klicken Sie auf Bereitstellen> Bereitstellungen verwalten.
  3. Klicken Sie unter der Bereitstellungs-ID auf Kopieren.

Google Workspace-Add-on (HTTP-Bereitstellungen)

Wenn Sie Ihr Google Workspace-Add-on mit HTTP-Endpunkten erstellt haben, führen Sie die folgenden Schritte aus, um die Bereitstellungs-ID aus dem Google Cloud-Bereitstellungsressource

  1. Gehen Sie auf der Seite „App-Konfiguration“ unter „Google Workspace-Add-on“ Klick Mit Cloud-Bereitstellungsressource bereitstellen > Wählen Sie „Bereitstellung“ aus.
  2. Wählen Sie die Bereitstellung aus, die Sie veröffentlichen möchten.
  3. Klicken Sie auf Auswählen.

Editor-Add-on für Google Docs, Google Tabellen, Präsentationen, Formulare)

Zum Veröffentlichen eines Editor-Add-ons müssen Sie Folgendes angeben: die Projektskript-ID und die Version, die Sie veröffentlichen möchten.

So finden Sie die Projektskript-ID:

  1. Öffnen Sie das Add-on im Apps Script-Editor.
  2. Klicken Sie links auf Projekteinstellungen.
  3. Wählen Sie unter „IDs“ kopieren Sie die Skript-ID.

So ermitteln Sie die Version:

  1. Öffnen Sie das Add-on im Apps Script-Editor.
  2. Klicken Sie oben rechts auf Bereitstellen> Bereitstellungen verwalten.
  3. Die Versionsnummer befindet sich unter „Konfiguration“.

Google Chat App

Wenn Sie eine Google Chat-App veröffentlichen möchten, müssen Sie die Google Chat API konfigurieren. Weitere Informationen finden Sie unter Veröffentlichung Apps.

Google Drive App

Bevor Sie eine Drive-App veröffentlichen können, müssen Sie die Funktion Drive API.

Web-App

Zum Veröffentlichen einer Web-App müssen Sie ihre universelle Navigations-URL angeben, also die URL, die verweist im Google Apps-Menü auf die Web-App. Ihre Webanwendung muss sich in der Produktionsphase befinden und voll funktionsfähig sein.

Beim Ausfüllen der Seite „Store-Eintrag“ müssen Sie zusätzliche Symbole zur Verfügung stellen. mit einer Größe von 96 x 96 und 48 x 48 Pixeln.

Wenn Sie Ihre Webanwendung in Apps Script erstellt haben, erhalten Sie Navigations-URL folgendermaßen:

  1. Google Workspace-Add-on in Apps Script öffnen Editor.
  2. Klicken Sie auf Bereitstellen> Neue Bereitstellung.
  3. Wählen Sie unter „Typ auswählen“ Klicken Sie auf Web-App.
  4. Füllen Sie die Optionen aus und klicken Sie auf Bereitstellen.
  5. Klicken Sie auf Kopieren.

Geben Sie die Zugriffsebene an, die Ihre App benötigt

Geben Sie unter OAuth-Bereiche eine vollständige Liste der OAuth-Bereiche für Ihre App an. erforderlich. Die OAuth-Bereiche, die Sie hier eingeben, sollten mit den Informationen in Ihrem OAuth-Zustimmungsbildschirm und, falls zutreffend, Apps Script-Manifest.

Wenn Sie mehr als eine App-Integration einbeziehen, fügen Sie die Bereiche aus jeden auf die Konfigurationsseite der Google Workspace Marketplace SDK-App und Ihre OAuth-Einwilligung Bildschirm.

Verwenden Sie immer den engsten Umfang, der möglich ist. Fügen Sie beispielsweise keinen vollständigen Drive-Bereich, wenn Sie nur einen schreibgeschützten Bereich benötigen).

Informationen zu Apps Script-Projekten finden Sie unter Bereiche .

Informationen zum App-Entwickler angeben

Geben Sie unter Entwicklerinformationen die Kontaktdaten und weitere Details ein. Diese Felder erscheinen auf der Store-Eintrag angezeigt werden.

Felder
Händlerstatus

Aufgrund von Verbraucherschutzgesetzen müssen Verbraucher in der EU Der EWR muss informiert werden, ob ein Händler im Google Workspace Marketplace ist ein Händler oder kein Händler:

  • Händler: Ein Händler ist eine Person, die zu bestimmten Zwecken handelt, zu einem Gewerbe, Unternehmen, Handwerk oder Beruf, oder im Namen von oder auf im Namen eines Händlers handelt.
  • Kein Händler: Ein Nicht-Händler (Verbraucher) ist eine Person, die für nicht-professionellen Zwecken dienen.

Wenn nicht angegeben, „Händlerstatus nicht angegeben“ auf der Seite Ihrer App Store-Eintrag Seite.

Anschrift des Entwicklers

Erforderlich für Händler. Wird nicht für Nicht-Händler erfasst.

Der Standort Ihres Unternehmens. Geben Sie eine gültige Postanschrift ein, an die Sie kann kontaktiert werden.

Name des Entwicklers Der Name, der als Autor der App angezeigt werden soll. Als Händler geben Sie Ihren Handelsnamen oder rechtsgültigen Namen an.
URL der Entwicklerwebsite Die Website, auf der Sie (oder Ihre Organisation) als Entwickler.
E-Mail-Adresse des Entwicklers

Die E-Mail-Adresse, die als Kontakt verwendet werden soll. Es ist nicht in Ihrem App-Eintrag enthalten. Achten Sie darauf, dass diese E-Mail-Adresse den verwendet:

  • Wenn Google den Entwickler kontaktieren muss, beispielsweise während der App-Überprüfungsprozess.
  • So senden Sie Feedback über Editor-Add-ons, wenn die URL „Problem melden“ nicht die im Store-Eintrag zur Verfügung stehen.
Website-URL der Anwendung Optional. Die Website, auf der Ihre App näher beschrieben wird.

Konfigurationseinstellungen Ihrer App im Google Workspace Marketplace SDK speichern

Verwenden Sie die Informationen aus dem vorherigen Abschnitt, Speichern Sie die App-Konfiguration im Google Workspace Marketplace SDK:

  1. Öffnen Sie das Google Workspace Marketplace SDK.
  2. Rufen Sie den Tab App-Konfiguration auf.
  3. Füllen Sie jeden Abschnitt basierend auf Ihren Angaben aus den vorherigen Abschnitt beschrieben.
  4. Klicken Sie auf Speichern.
  5. Optional: Sie können Analysen zur App-Nutzung abrufen. in Google Analytics. Fügen Sie dazu eine Google Analytics-ID hinzu. im Google Workspace Marketplace SDK.
    1. Rufe den Tab Analytics auf.
    2. Geben Sie Ihre Google Analytics-ID ein.
    3. Klicken Sie auf Speichern.