App im Google Workspace Marketplace SDK konfigurieren

Auf dieser Seite wird erläutert, wie Sie Ihre Anwendung mit dem Google Workspace Marketplace SDK im Google Workspace Marketplace konfigurieren und verwalten.

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 Ihre Anwendung im Google Workspace Marketplace erstellen und steuern können. Mit dem Google Workspace Marketplace SDK verwalten Sie Marketplace-Einstellungen wie die folgenden:

• Verfügbarkeit der Anwendung für eine bestimmte Google Workspace-Organisation (private Anwendung) oder für alle Marketplace-Nutzer (öffentliche Anwendung)
• Die Arten von Marketplace-Nutzern, die Ihre Anwendung installieren können
• Mit welchen Google Workspace-Anwendungen Ihre App(s) integriert werden kann
• Die für Ihre Anwendung erforderlichen OAuth-Bereiche
• Informationen darüber, wer die App entwickelt und verwaltet

Unabhängig davon, ob Sie Ihre Anwendung öffentlich oder privat veröffentlichen, müssen Sie zur Verwaltung Ihrer Anwendung im Marketplace das Google Workspace Marketplace SDK verwenden.

Google Workspace Marketplace SDK aktivieren

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

1. Öffnen Sie die Google Cloud Console.
2. Klicken Sie oben auf Projekt auswählen. Wenn bereits ein anderes Google Cloud-Projekt geöffnet ist, klicken Sie auf den Namen des Cloud-Projekts, um zu einem anderen Cloud-Projekt zu wechseln.
3. Wählen Sie das Cloud-Projekt der 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 „Google Workspace Marketplace SDK“.

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

App-Einstellungen im Google Workspace Marketplace SDK eingeben

1. Öffnen Sie das Google Workspace Marketplace SDK.
2. Rufen Sie den Tab App-Konfiguration auf.
3. Geben Sie in jeden Abschnitt die Informationen zu Ihrer Anwendung ein. Weitere Informationen zu den einzelnen Einstellungen finden Sie im folgenden Abschnitt App-Konfigurationseinstellungen.
4. Klicken Sie auf Speichern.
5. (Optional) In Google Analytics können Sie Analysen zur App-Nutzung abrufen. Fügen Sie dazu im Google Workspace Marketplace SDK eine Google Analytics-ID hinzu.
   1. Rufen Sie den Tab Analytics auf.
   2. Geben Sie Ihre Google Analytics-ID ein.
   3. Klicken Sie auf Speichern.

App-Konfigurationseinstellungen

In der folgenden Referenz werden die Einstellungen beschrieben, die im Google Workspace Marketplace SDK auf der Seite App-Konfiguration verfügbar sind.

Sichtbarkeit von Apps

Die Option App-Sichtbarkeit wird angezeigt, wenn Sie ein Google Workspace-Konto verwenden (ein Konto, das von Ihrem Unternehmen oder Ihrer Bildungseinrichtung erstellt wurde). Wenn Sie ein Privatnutzerkonto verwenden, also ein Konto, das auf „@gmail.com“ endet, ist eine Veröffentlichung nur öffentlich möglich.

• Öffentlich: Die Anwendung kann von Personen außerhalb Ihrer Domain gefunden und installiert werden. Wenn Sie die öffentliche Sichtbarkeit auswählen, prüft und genehmigt Google Ihren App-Eintrag, bevor er veröffentlicht wird.
• Privat: Nur Personen in Ihrer Domain können Ihre App finden und installieren.

Wenn Sie die App als Nicht gelistet veröffentlichen, wird der App-Eintrag nicht im Browser oder in den Suchergebnissen 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 Abschnitt Vertrieb festlegen.

Installationseinstellungen

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

• Einzelinstallation + Administratorinstallation (Standard): Die Anwendung 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 Anwendung installiert, selbst wenn einzelne Installationen aktiviert sind.
• Installation nur durch Administrator: Die Anwendung kann nur von Administratoren für ihre Domain, Organisationseinheit oder eine Nutzergruppe installiert werden. Ihre Anwendung wird in den Google Workspace Marketplace-Suchergebnissen nur für Administratoren und Personen angezeigt, die nicht in ihrem Google-Konto angemeldet sind. Wählen Sie diese Option aus, wenn für Ihre Anwendung eine Domaininstallation erforderlich ist.

App-Einbindung

Wählen Sie die Google Workspace-Dienste aus, mit denen Ihre Anwendung oder Ihr Add-on zusammenarbeiten 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 Ihrem App-Eintrag mehrere App-Integrationen hinzufügen. Weitere Informationen finden Sie unter App-Integrationen zusammen auflisten.

Je nachdem, für welche Anwendungsintegrationen Sie sich entscheiden, müssen Sie in Ihrem Google Cloud-Projekt möglicherweise weitere Informationen angeben und relevante APIs aktivieren. In der folgenden Tabelle werden die jeweils zusätzlich erforderlichen Einrichtungsschritte beschrieben:

OAuth-Bereiche

Geben Sie eine vollständige Liste der OAuth-Bereiche an, die für Ihre Anwendung erforderlich sind. Die OAuth-Bereiche, die Sie hier eingeben, sollten mit den Werten auf Ihrem OAuth-Zustimmungsbildschirm und gegebenenfalls mit dem Apps Script-Manifest übereinstimmen.

Wenn Sie mehr als eine App-Integration verwenden, müssen Sie die Bereiche beider Bereiche auf der Seite für die App-Konfiguration des Google Workspace Marketplace SDK und in Ihrem OAuth-Zustimmungsbildschirm einfügen.

Verwenden Sie immer die schmalsten Bereiche wie möglich. Schließen Sie beispielsweise keinen vollständigen Drive-Bereich ein, wenn Sie nur einen schreibgeschützten Bereich benötigen.

Weitere Informationen zu Apps Script-Projekten finden Sie unter Bereiche.

Entwicklerinformationen

Diese Felder werden auf der Seite des Store-Eintrags 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 im Google Workspace Marketplace ein Händler oder ein Nicht-Händler ist: Händler – Ein Händler ist eine Person, die im Zusammenhang mit einem Gewerbe, Unternehmen, Handwerk oder Beruf oder im Namen eines Händlers oder im Namen eines Händlers handelt. Kein Händler: Ein Nicht-Händler (Verbraucher) ist eine Person, die nicht professionell handelt. Wenn kein Händlerstatus angegeben ist, wird auf der Seite des Store-Eintrags der App „Händlerstatus nicht angegeben“ angezeigt.
Postanschrift des Entwicklers	Für Händler erforderlich. Wird nicht für Nicht-Händler erhoben. Der Standort Ihres Unternehmens. Geben Sie eine gültige Postanschrift ein, unter der Sie erreichbar sind.
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.
URL der Entwicklerwebsite	Die Website, auf der Sie oder Ihre Organisation als Entwickler beschrieben werden.
E-Mail-Adresse des Entwicklers	Die E-Mail-Adresse, die als Ansprechpartner verwendet werden soll. Sie ist nicht in deinem App-Eintrag enthalten. Achten Sie darauf, dass diese E-Mail-Adresse immer auf dem neuesten Stand ist – sie muss verwendet werden: Ob Google den Entwickler kontaktieren muss, z. B. während der App-Überprüfung. Feedback über Editor-Add-ons senden, wenn auf der Seite des Store-Eintrags keine URL zur Meldung eines Problems angegeben ist
Website-URL der Anwendung	Optional. Die Website, auf der Ihre App genauer beschrieben wird.