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:
- Öffnen Sie die Google Cloud Console.
- 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
- Wählen Sie das Cloud-Projekt Ihrer Anwendung aus und klicken Sie auf Öffnen.
- Geben Sie oben in der Suchleiste
Google Workspace Marketplace SDK
ein und drücken Sie die Eingabetaste. Öffnen Sie die Seite für das Google Workspace Marketplace SDK.
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.
- Einzelinstallation + Installation durch Administrator (Standardeinstellung): Die App kann über von einzelnen Nutzern oder Administratoren für ihre Domain, Organisationseinheit oder eine 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 |
|
|
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:
- Google Workspace-Add-on in Apps Script öffnen Editor.
- Klicken Sie auf Bereitstellen> Bereitstellungen verwalten.
- Klicken Sie unter der Bereitstellungs-ID auf Kopieren.
Google Workspace-Add-on (alternative Laufzeit)
Wenn Sie das Google Workspace-Add-on in einer anderen Programmiersprache als Google Apps Script verwenden, befolgen Sie diese Schritte, um die Bereitstellungs-ID von der Google Cloud-Bereitstellungsressource
- Gehen Sie auf der Seite „App-Konfiguration“ unter „Google Workspace-Add-on“ Klick Mit Cloud-Bereitstellungsressource bereitstellen > Wählen Sie „Bereitstellung“ aus.
- Wählen Sie die Bereitstellung aus, die Sie veröffentlichen möchten.
- 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:
- Öffnen Sie das Add-on im Apps Script-Editor.
- Klicken Sie links auf Projekteinstellungen.
- Wählen Sie unter „IDs“ kopieren Sie die Skript-ID.
So ermitteln Sie die Version:
- Öffnen Sie das Add-on im Apps Script-Editor.
- Klicken Sie oben rechts auf Bereitstellen> Bereitstellungen verwalten.
- 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:
- Google Workspace-Add-on in Apps Script öffnen Editor.
- Klicken Sie auf Bereitstellen> Neue Bereitstellung.
- Wählen Sie unter „Typ auswählen“ Klicken Sie auf Web-App.
- Füllen Sie die Optionen aus und klicken Sie auf Bereitstellen.
- 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. erfordert. 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:
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, unter der 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 Ansprechpartner verwendet werden soll. Es ist nicht in Ihrem App-Eintrag enthalten. Achten Sie darauf, dass diese E-Mail-Adresse den verwendet:
|
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:
- Öffnen Sie das Google Workspace Marketplace SDK.
- Rufen Sie den Tab App-Konfiguration auf.
- Füllen Sie jeden Abschnitt basierend auf Ihren Angaben aus den vorherigen Abschnitt beschrieben.
- Klicken Sie auf Speichern.
- 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.
- Rufe den Tab Analytics auf.
- Geben Sie Ihre Google Analytics-ID ein.
- Klicken Sie auf Speichern.