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
- In welche Google Workspace-Anwendungen Ihre App eingebunden werden kann
- 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 die Anwendung festlegen
In der folgenden Referenz werden die Einstellungen beschrieben, die im Marketplace SDK auf der Seite App-Konfiguration verfügbar sind.
Festlegen, wer Ihre App ansehen und installieren darf
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 Anwendung so beeinflussen:
- Sie können steuern, ob ihre Nutzer Apps im Marketplace ansehen und 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 Anwendung für eine Organisation entwickeln, die Zulassungslisten verwendet, wenden Sie sich an einen Administrator, damit dieser die Anwendung auf die Zulassungsliste setzt.
- 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 Anwendung 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, also ein Konto, das von Ihrem Unternehmen oder Ihrer Bildungseinrichtung erstellt wurde. Wenn Sie ein Privatnutzerkonto verwenden (ein Konto, das auf „@gmail.com“ endet), können Sie nur öffentlich veröffentlichen.
- Öffentlich: Die Anwendung 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 Personen innerhalb 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.
- Installation nur durch Administrator: Die Anwendung 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.
Allgemeine 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 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, jeder in Ihrer Organisation. | Sofern zulässig, alle in Ihrer Organisation. | |
| Meine Organisation | Privat | Nur für Administratoren | 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 |
|
|
|
Ermitteln, wie sich Ihre Anwendung in Google Workspace-Anwendungen einbinden lässt
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 kannst du mehrere App-Integrationen in deinen 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 jeweils zusätzlich erforderliche Einrichtung 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 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 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 und 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 ermitteln 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 du eine Web-App veröffentlichen möchtest, musst du ihre universelle Navigations-URL angeben, also die URL, die vom Google Apps-Menü auf die Web-App 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, können Sie so die universelle Navigations-URL abrufen:
- Ö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 OAuth-Bereiche, die Sie hier eingeben, sollten mit den Angaben auf Ihrem OAuth-Zustimmungsbildschirm und gegebenenfalls mit dem 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 kleinstmöglichen Bereich (z. B. keinen vollständigen Drive-Bereich, wenn Sie nur einen schreibgeschützten Bereich benötigen).
Weitere Informationen zu Apps Script-Projekten finden Sie unter Autorisierungsbereiche.
Informationen zum App-Entwickler angeben
Geben Sie unter Informationen zum Entwickler 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 im Europäischen Wirtschaftsraum (EWR) darüber informiert werden, ob ein Händler im Google Workspace Marketplace Händler oder Nicht-Händler ist:
Andernfalls 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 Händler sind, geben Sie Ihren Handelsnamen oder rechtsgültigen Namen an. |
| Anschrift 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. Er 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. |
Konfigurationseinstellungen Ihrer App 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.