Auf dieser Seite wird erläutert, wie Sie mit dem Google Workspace Marketplace SDK Ihre App im Google Workspace Marketplace konfigurieren und verwalten.
Damit Ihre App verwendet werden kann, müssen Sie sie im Marketplace SDK einrichten. Das Marketplace SDK ist ein Toolkit, mit dem Sie Ihre App im Google Workspace Marketplace erstellen und verwalten können. Mit dem Marketplace SDK können Sie Marketplace-Einstellungen verwalten, z. B.:
- Ob Ihre App für eine bestimmte Google Workspace-Organisation (private App) oder für alle Marketplace-Nutzer (öffentliche App) verfügbar ist
- Die Arten von Marketplace-Nutzern, die Ihre App installieren können
- Mit welchen Google Workspace-Anwendungen Ihre App verknüpft ist
- Die für Ihre App erforderlichen OAuth-Bereiche
- Informationen dazu, wer die App entwickelt und verwaltet
Unabhängig davon, ob Sie Ihre App privat oder öffentlich veröffentlichen, müssen Sie das Marketplace SDK verwenden, um Ihre App im Marketplace zu verwalten.
Marketplace SDK aktivieren
Aktivieren Sie in Ihrem Google Cloud-Projekt das Google Workspace Marketplace SDK, falls noch nicht geschehen.
Cloud-Projekt in der Google Cloud Console öffnen
Öffnen Sie das Cloud-Projekt, das Sie für dieses Beispiel verwenden möchten, falls noch nicht geschehen:
- Rufen Sie in der Google Cloud Console die Seite Projekt auswählen auf.
- Wählen Sie das Google Cloud-Projekt aus, das Sie verwenden möchten. Sie können auch auf Projekt erstellen klicken und der Anleitung auf dem Bildschirm folgen. Wenn Sie ein Google Cloud-Projekt erstellen, müssen Sie möglicherweise die Abrechnung für das Projekt aktivieren.
Google Workspace Marketplace SDK aktivieren
Bevor Sie Google APIs verwenden können, müssen Sie sie in einem Google Cloud-Projekt aktivieren. Sie können eine oder mehrere APIs in einem einzelnen Google Cloud-Projekt aktivieren.Aktivieren Sie in der Google Cloud Console das Google Workspace Marketplace SDK.
Konfigurationseinstellungen für Ihre App festlegen
In der folgenden Referenz werden die Einstellungen beschrieben, die auf der Seite App-Konfiguration des Marketplace SDK verfügbar sind.
Festlegen, wer Ihre App sehen und installieren kann
Wenn Sie Ihre App konfigurieren, geben Sie mit den folgenden Einstellungen an, welche Nutzer auf Ihre App zugreifen können:
- App-Sichtbarkeit: Wenn Sie eine App in einer Google Workspace-Organisation veröffentlichen, können Sie festlegen, ob Ihr App-Eintrag nicht gelistet, für alle Nutzer in Ihrer Organisation oder für alle Nutzer von Google Workspace sichtbar sein soll.
- Installationseinstellungen: Gibt an, ob die App nur von Google Workspace-Administratoren installiert werden kann.
Unabhängig von den Einstellungen, die Sie in Ihrem App-Eintrag angeben, können Nutzer, die zu einer Google Workspace-Organisation gehören, Ihre App aufgrund der Einstellungen ihrer Administratoren möglicherweise nicht finden, installieren oder verwenden. Administratoren können die Verfügbarkeit Ihrer App auf folgende Weise beeinflussen:
- Sie können festlegen, ob ihre Nutzer Apps im Marketplace ansehen und Apps im Namen ihrer Nutzer installieren dürfen.
- Mit einer Zulassungsliste können sie Apps für ihre Organisation verwalten und auswählen. Wenn Sie eine App für eine Organisation entwickeln, die Zulassungslisten verwendet, wenden Sie sich an einen Administrator, um die App auf die Zulassungsliste setzen zu lassen.
- Sie können bestimmte Google Workspace-Anwendungen deaktivieren, z. B. den Zugriff auf Google Chat, Google Chat-Apps oder beides. In diesen Fällen können Nutzer Ihre App nicht über den Marketplace installieren.
Informationen dazu, wie Administratoren den Zugriff auf den Marketplace verwalten, finden Sie in der Marketplace Admin Help-Dokumentation.
Einstellungen für die Sichtbarkeit der App
Die Option App-Sichtbarkeit wird angezeigt, wenn Sie ein Google Workspace-Konto verwenden, das von Ihrer Organisation (Arbeitsplatz oder Bildungseinrichtung) erstellt wurde. Wenn Sie ein Privatnutzerkonto verwenden (ein Konto, das auf „@gmail.com“ endet), können Sie nur öffentlich veröffentlichen.
- Öffentlich: Die App kann von Personen außerhalb Ihrer Domain gefunden und installiert werden. Wenn Sie die öffentliche Sichtbarkeit auswählen, wird Ihr App-Eintrag von Google geprüft und genehmigt, bevor er veröffentlicht wird.
- Privat: Nur Nutzer in Ihrer Domain können Ihre App finden und installieren.
Wenn Sie die Option Nicht gelistet auswählen, wird der App-Eintrag nicht in den Suchergebnissen oder in der Übersicht angezeigt. Nutzer können nur über die direkte URL auf die Store-Seite der App zugreifen.
Wenn Sie einschränken möchten, in welchen Ländern und Regionen Ihre App verfügbar ist, können Sie dies beim Erstellen des Store-Eintrags im Bereich Vertrieb festlegen.
Einstellungen für App-Installationen
Mit der Option Installationseinstellungen legen Sie fest, ob Nutzer oder Google Workspace-Administratoren Ihre App über die Seite Ihres Store-Eintrags im Google Workspace Marketplace installieren können.
- Einzelinstallation und Installation durch Administrator (Standard): Die App kann von einzelnen Nutzern oder von Administratoren für ihre Domain, Organisationseinheit oder eine Gruppe von Nutzern installiert werden. Die Domainrichtlinien eines Nutzers können verhindern, dass er eine App installiert, auch wenn die Installation einzelner Apps aktiviert ist.
- Nur Administratorinstallation: Die App kann nur von Administratoren für ihre Domain, Organisationseinheit oder eine Gruppe von Nutzern installiert werden. Ihre App wird nur in den Suchergebnissen des Google Workspace Marketplace für Administratoren und Personen angezeigt, die nicht in ihrem Google-Konto angemeldet sind. Wählen Sie diese Option aus, wenn für Ihre App eine Domaininstallation erforderlich ist.
Gängige Installations- und Sichtbarkeitseinstellungen
In der folgenden Tabelle sind einige der gängigen App-Konfigurationsoptionen für Installation und Sichtbarkeit zusammengefasst:
| Vorgesehene App-Nutzer | Einstellung Sichtbarkeit der App | Einstellung 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, alle Nutzer in Ihrer Organisation, die die URL des App-Eintrags haben. | Sofern zulässig, alle Nutzer in Ihrer Organisation, die die URL des App-Eintrags haben. | |
| Meine Organisation | Privat | Einzelinstallation und Installation durch Administrator | Sofern zulässig, jeder in Ihrer Organisation. | Sofern zulässig, jeder in Ihrer Organisation. | |
| Meine Organisation | Privat | Nur Administrator | Administratoren | Nutzer, bei denen die App von ihrem Administrator installiert wurde. | |
| Für Apps, die Nutzern außerhalb einer bestimmten Google Workspace-Organisation zur Verfügung stehen | |||||
| Nutzer in Google Workspace-Organisationen | Öffentlich | Nur Administrator | Administratoren | Nutzer, bei denen die App von ihrem Administrator installiert wurde. | |
| Alle Google Workspace-Nutzer | Öffentlich | Einzelinstallation und Installation durch Administrator |
|
|
|
Integration Ihrer App in Google Workspace-Anwendungen
Wählen Sie die Google Workspace-Dienste aus, die Ihre Anwendung oder Ihr Add-on verwenden soll, z. B. ein Google Workspace-Add-on oder eine 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 App-Integrationen gemeinsam auflisten.
Je nachdem, welche App-Integrationen Sie auswählen, müssen Sie möglicherweise weitere Informationen angeben und die entsprechenden APIs in Ihrem Google Cloud-Projekt aktivieren. In der folgenden Tabelle wird die zusätzliche Einrichtung für die einzelnen Optionen beschrieben:
Google Workspace-Add-on (Apps Script)
Wenn Sie ein Google Workspace-Add-on veröffentlichen möchten, müssen Sie die Bereitstellungs-ID des Add-ons angeben. So finden Sie die Bereitstellungs-ID:
- Öffnen Sie Ihr Google Workspace-Add-on im Apps Script-Editor.
- Klicken Sie auf Bereitstellen> Bereitstellungen verwalten.
- Klicken Sie unter der Deployment-ID auf Kopieren.
Google Workspace-Add-on (HTTP-Bereitstellungen)
Wenn Sie Ihr Google Workspace-Add-on mit HTTP-Endpunkten erstellt haben, gehen Sie so vor, um die Bereitstellungs-ID aus der Google Cloud-Bereitstellungsressource abzurufen:
- Klicken Sie auf der Seite „App-Konfiguration“ unter „Google Workspace-Add-on“ auf HTTP- oder andere Bereitstellungen > Bereitstellung auswählen.
- Wählen Sie die Bereitstellung aus, die Sie veröffentlichen möchten.
- Klicken Sie auf Auswählen.
Editor-Add-on (Google Docs, Google Tabellen, Google Präsentationen, Google Formulare)
Wenn Sie ein Editor-Add-on veröffentlichen möchten, müssen Sie die Projekt-Script-ID und die Version angeben, die Sie veröffentlichen möchten.
So finden Sie die Projekt-Script-ID:
- Öffnen Sie das Add-on im Apps Script-Editor.
- Klicken Sie links auf Projekteinstellungen .
- Kopieren Sie unter „IDs“ die Script-ID.
So finden Sie die Version:
- Öffnen Sie das Add-on im Apps Script-Editor.
- Klicken Sie rechts oben auf Bereitstellen > Bereitstellungen verwalten.
- Die Versionsnummer finden Sie 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 Google Chat-Apps veröffentlichen.
Drive App
Wenn Sie eine Drive-App veröffentlichen möchten, müssen Sie die Google Drive API aktivieren und konfigurieren.
Web-App
Wenn Sie eine Webanwendung veröffentlichen möchten, müssen Sie die universelle Navigations-URL angeben. Das ist die URL, die vom Google Apps-Menü auf die Webanwendung verweist. Ihre Webanwendung muss in der Produktionsversion verfügbar und voll funktionsfähig sein.
Wenn Sie die Seite „Store-Eintrag“ ausfüllen, müssen Sie zusätzliche Symbole mit einer Größe von 96 x 96 und 48 x 48 Pixeln angeben.
Wenn Sie Ihre Webanwendung in Apps Script erstellt haben, gehen Sie so vor, um die universelle Navigations-URL zu erhalten:
- Öffnen Sie Ihr Google Workspace-Add-on im Apps Script-Editor.
- Klicken Sie auf Bereitstellen> Neue Bereitstellung.
- Klicken Sie unter „Typ auswählen“ auf Web-App.
- Füllen Sie die Optionen aus und klicken Sie auf Bereitstellen.
- Klicken Sie auf Kopieren.
Zugriffsebene für Ihre App angeben
Geben Sie unter OAuth-Bereiche eine vollständige Liste der OAuth 2.0-Bereiche an, die für Ihre App erforderlich sind. Die hier eingegebenen OAuth-Bereiche müssen mit den Angaben auf dem OAuth-Zustimmungsbildschirm und gegebenenfalls im Apps Script-Manifest übereinstimmen.
Wenn Sie mehr als eine App-Integration verwenden, fügen Sie die Bereiche der einzelnen Apps auf der Seite „App-Konfiguration des Marketplace SDK“ und auf dem OAuth-Zustimmungsbildschirm hinzu.
Verwenden Sie immer den möglichst eng gefassten Umfang. Geben Sie beispielsweise nicht den gesamten Drive-Umfang an, wenn Sie nur Lesezugriff benötigen.
Weitere Informationen zu Apps Script-Projekten finden Sie unter Autorisierungsbereiche.
Informationen zum App-Entwickler angeben
Geben Sie unter Informationen zum Entwickler Ihre Kontaktdaten und weitere Details ein. Diese Felder werden auf der Seite Store-Eintrag Ihrer App angezeigt.
| Felder | |
|---|---|
| Händlerstatus |
Aufgrund von Verbraucherschutzgesetzen müssen Verbraucher mit Wohnsitz im Europäischen Wirtschaftsraum (EWR) darüber informiert werden, ob ein Händler auf dem Google Workspace Marketplace ein Händler oder ein Nicht-Händler ist:
Wenn Sie keinen Status angeben, wird auf der Seite Store-Eintrag Ihrer App „Händlerstatus nicht angegeben“ angezeigt. |
| Name des Entwicklers | Der Name, der als Autor der App angezeigt werden soll. Wenn Sie ein Händler sind, geben Sie Ihren Handelsnamen oder rechtsgültigen Namen an. |
| Postanschrift des Entwicklers |
Erforderlich für Händler. Wird für Nicht-Händler nicht erfasst. Der Standort Ihres Unternehmens. Geben Sie eine gültige Postanschrift ein, unter der Sie erreichbar sind. |
| URL der Website des Entwicklers | Die Website, auf der Sie (oder Ihre Organisation) als Entwickler angegeben sind. |
| E-Mail-Adresse des Entwicklers |
Die E-Mail-Adresse, die als Ansprechpartner verwendet werden soll. Sie ist nicht in Ihrem App-Eintrag enthalten. Achten Sie darauf, dass diese E-Mail-Adresse immer auf dem neuesten Stand ist, da sie verwendet wird:
|
| URL der Website der Anwendung | Optional. Die Website, auf der Ihre App näher beschrieben wird. |
App-Konfigurationseinstellungen im Marketplace SDK speichern
Speichern Sie anhand der Informationen aus dem vorherigen Abschnitt die App-Konfiguration im Marketplace SDK:
Rufen Sie in der Google Cloud Console die Seite Konfiguration des Marketplace SDK auf:
Füllen Sie die einzelnen Abschnitte anhand der Informationen aus dem vorherigen Abschnitt aus.
Klicken Sie auf Speichern.
Optional: In Google Analytics können Sie Analysen zur App-Nutzung abrufen. Fügen Sie dazu eine Google Analytics-ID in das Marketplace SDK ein.
- Rufe den Tab Analytics auf.
- Geben Sie Ihre Google Analytics-ID ein.
- Klicken Sie auf Speichern.