Nachdem Sie eine Chat-App erstellt haben, können Sie sie veröffentlichen, damit sie für ausgewählte Personen oder Gruppen, alle in Ihrer Google Workspace-Organisation oder alle Google Chat-Nutzer verfügbar ist.
So können Nutzer Chat-Apps finden und verwenden
Nutzer haben folgende Möglichkeiten, Google Chat-Apps zu finden:
- Suchen und installieren Sie Chat-Apps aus Google Chat oder dem Google Workspace Marketplace.
- Mit einer App interagieren, die einem Chatbereich hinzugefügt wurde
- Sie finden die App im Bereich für Direktnachrichten, nachdem ein Google Workspace-Administrator die App in seinem Namen installiert hat.
Um eine App zu verwenden, können Google Chat-Nutzer eine Direktnachricht an die App senden oder die App einem Gruppenbereich hinzufügen. Nutzer können die App auch hinzufügen, indem sie sie mit @ erwähnen. Das folgende Beispiel zeigt, wie ein Nutzer mit @ eine Chat-App erwähnt, um sie einem Gruppenbereich hinzuzufügen:
So installieren Google Workspace-Administratoren Chat-Apps
Google Workspace-Administratoren können im Google Workspace Marketplace nach Chat-Apps suchen und die Apps für Nutzer in ihrer Organisation installieren. Wenn ein Administrator eine Chat-App installiert, wird die App im Bereich für Direktnachrichten der Nutzer angezeigt.
Google Workspace-Administratoren können auch die Verwendung von Chat-Anwendungen in ihrer Google Workspace-Organisation verwalten und auf die Zulassungsliste setzen. Wenn Sie eine Chat-App für eine Organisation entwickeln, die Zulassungslisten verwendet, müssen Sie einen Administrator bitten, Ihre Chat-App der Zulassungsliste hinzuzufügen, damit Nutzer die App finden und verwenden können. Weitere Informationen finden Sie in der Google Workspace-Admin-Hilfe unter Nutzern erlauben, Chat-Apps zu installieren.
Chat-App über die Google Cloud Console konfigurieren und veröffentlichen
So veröffentlichen Sie Ihre Chat-App und machen sie anderen zugänglich:
- Aktivieren und konfigurieren Sie die Google Chat API. Wenn Sie die API konfigurieren, gewähren Sie anderen Google Chat-Nutzern zu Testzwecken Zugriff auf Ihre Chat-Anwendung.
- Veröffentlichen Sie Ihre App mit dem Google Workspace Marketplace SDK. Sie können die Chat-Anwendung so konfigurieren, dass sie für Nutzer in Ihrer Google Workspace-Organisation oder für alle Google Chat-Nutzer verfügbar ist.
- Wenn Ihre Google Workspace-Organisation den Zugriff auf Chat-Apps verwaltet, bitten Sie Ihren Google Workspace-Administrator, die App der Zulassungsliste der Organisation hinzuzufügen.
Sichtbarkeits- und Veröffentlichungseinstellungen für die Chat-App
In der folgenden Tabelle wird erläutert, wie Sie die Einstellungen für die Google Chat API und das Google Workspace Marketplace SDK basierend auf der Zielgruppe Ihrer Chat-App konfigurieren:
| Beabsichtigte App-Nutzer | Authentifizierungsmethode | Google Chat API-Einstellungen | Einstellungen für das Google Workspace Marketplace SDK | Wo wird meine Chat-App veröffentlicht? |
|---|---|---|---|---|
| Ihr kleines Team | Authentifizieren Sie sich als Nutzer oder als Anwendung. | Geben Sie bei der Einstellung Sichtbarkeit Personen oder Google Groups-Gruppen an, die auf die Anwendung zugreifen dürfen.
Wenn für Ihr Google Workspace-Konto Apps auf die Zulassungsliste gesetzt werden müssen, können Sie nur bis zu fünf einzelne E-Mail-Adressen angeben. Google Groups-Gruppen können nicht angegeben werden. |
Sie müssen das Google Workspace Marketplace SDK für Ihre Chat-App nicht konfigurieren. | Teammitglieder können die Chat App in Google Chat finden und verwenden. |
| Ihr großes Team | Authentifizieren Sie sich als Nutzer oder als Anwendung. | Geben Sie in der Einstellung Sichtbarkeit Personen oder Google Groups-Gruppen an, mit denen Sie die Chat-App testen möchten.
Veröffentlichen Sie die Chat-App nach dem Test in Ihrer Google Workspace-Organisation mithilfe der Einstellungen im Google Workspace Marketplace SDK. |
Setzen Sie die Sichtbarkeit der App auf Privat. Wählen Sie unter Installationseinstellungen die Option Einzelperson + Administrator aus. Wenn für Ihr Google Workspace-Konto Apps auf die Zulassungsliste gesetzt werden müssen, bitten Sie einen Administrator, Ihre Chat-App auf die Zulassungsliste zu setzen, damit Nutzer die App finden und verwenden können. Weitere Informationen finden Sie in der Dokumentation für die Google Workspace-Admin-Hilfe unter Nutzern erlauben, Chat-Apps zu installieren. |
Jeder in Ihrer Google Workspace-Organisation kann Ihre Chat-App in Google Chat finden und installieren sowie Ihre App im Google Workspace Marketplace ansehen. Nutzer und Google Workspace-Administratoren können Ihre Anwendung über den Marketplace installieren. |
| Meine Google Workspace-Organisation | Authentifizieren Sie sich als Nutzer oder als Anwendung. | Geben Sie bei der Einstellung Sichtbarkeit Personen oder Google Groups-Gruppen an, um die Chat-Anwendung zu testen.
Veröffentlichen Sie die Chat-App nach dem Test in Ihrer Google Workspace-Organisation mithilfe der Einstellungen im Google Workspace Marketplace SDK. |
Setzen Sie die Sichtbarkeit der App auf Privat. Wählen Sie unter Installationseinstellungen die Option Einzelperson + Administrator aus. |
Jeder in Ihrer Google Workspace-Organisation kann Ihre Chat-App in Google Chat finden und installieren sowie Ihre App im Google Workspace Marketplace ansehen. Nur Google Workspace-Administratoren können Ihre Anwendung aus dem Marketplace installieren. |
| Jeder (öffentliche Chat-App) | Authentifizieren Sie sich als Nutzer oder als Anwendung. | Geben Sie bei der Einstellung Sichtbarkeit Personen oder Google Groups-Gruppen an, um die Chat-Anwendung zu testen.
Veröffentlichen Sie Ihre Chat-App anschließend über die Einstellungen im Google Workspace Marketplace öffentlich. |
Setzen Sie die Sichtbarkeit der App auf Öffentlich. Wählen Sie unter Installationseinstellungen die Option Einzelperson + Administrator aus. |
Jeder Google Workspace-Nutzer kann Ihre Chat-App in Google Chat finden und installieren sowie Ihre Anwendung im Google Workspace Marketplace ansehen. Nur Google Workspace-Administratoren können Ihre Anwendung aus dem Marketplace installieren. |
Google Chat API aktivieren und konfigurieren
Richten Sie in der Google Cloud Console ein Projekt für Ihre Anwendung ein und aktivieren Sie die Google Chat API:
- Verwenden Sie die Schaltfläche unten, um ein neues Projekt zu erstellen oder ein vorhandenes auszuwählen und ihm ein Dienstkonto hinzuzufügen. Weisen Sie dem Dienstkonto die Rolle Projektinhaber zu.
API aktivieren - Speichern Sie den heruntergeladenen JSON-Schlüssel. Ihre Anwendung kann mit diesem Schlüssel Nachrichten authentifizieren, die sie asynchron an Gruppenbereiche sendet.
- Öffnen Sie Ihr Projekt in der . Klicken Sie in der Liste der APIs auf Google Chat API.
- Wählen Sie den Tab Konfiguration aus und geben Sie die Informationen für die Anwendung wie in der folgenden Tabelle beschrieben ein.
Wenn Sie die Anwendungskonfiguration speichern, wird Ihre Anwendung für die angegebenen Nutzer in Ihrer Google Workspace-Organisation verfügbar.
Konfigurationseinstellungen für die Google Chat API
| Feld | Beschreibung |
|---|---|
| App-Name | Der Name, den Nutzer bei der Interaktion mit Ihrer Chat-App verwenden. |
| Avatar-URL | Eine HTTPS-URL, die auf ein quadratisches Bild (z.B. PNG oder JPEG) mit mindestens 128 × 128 Pixeln verweist, das als Avatar für Ihre Chat-App angezeigt wird. |
| Beschreibung | Eine Beschreibung der Funktionen der Chat-App, die unter dem Namen der Chat-App angezeigt wird. |
| Funktionen | Eine Reihe von Feldern, die festlegen, wie die Chat-App mit Nutzern interagieren kann:
|
| Verbindungseinstellungen | Der Endpunkt für die Chat-App. Das ist einer der folgenden:
|
| Slash-Befehle | Befehle, die Nutzern in Google Chat angezeigt werden können. Nutzer können die Hauptaktionen für Ihre Chat-App in Google Chat sehen und eine bestimmte Aktion auswählen, mit der sie interagieren möchten. |
| Linkvorschauen | URL-Muster, die von der Chat App erkannt werden und für die zusätzliche Inhalte bereitgestellt werden, wenn Nutzer Links senden. Weitere Informationen finden Sie unter Vorschaulinks. |
| Sichtbarkeit | Bis zu fünf Personen oder eine oder mehrere Google Groups-Gruppen können Ihre Chat-App sehen und installieren. Verwenden Sie dieses Feld, um Ihre Chat-App zu testen oder die Chat-App für Ihr Team freizugeben. Weitere Informationen finden Sie unter Sichtbarkeit und Veröffentlichungseinstellungen für die Chat-App. |
Berechtigungen für die App-Konfiguration erteilen
Sie können bestimmten Nutzern Zugriff auf die App-Konfigurationsseite gewähren. Verwenden Sie dazu die IAM-Rollen Inhaber von Chat-Apps und Betrachter von Chat-Apps. Nutzer mit diesen Rollen können die Anwendungskonfigurationsseite nicht über das Dashboard APIs & Dienste aufrufen, aber auf die Konfigurationsseite zugreifen, indem sie die Console für ihr Projekt so aufrufen:
https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID
App mit dem Google Workspace Marketplace SDK veröffentlichen
Mit dem Google Workspace Marketplace SDK können Sie Folgendes tun:
- Veröffentlichen Sie Ihre Chat-App und ermöglichen Sie allen Google Chat-Nutzern, die App einem Gruppenbereich hinzuzufügen.
- Veröffentlichen Sie die Chat-App in Ihrer Google Workspace-Organisation.
- Machen Sie Ihre Anwendung für Google Workspace-Administratoren sichtbar, damit diese die App für Nutzer in ihrer Organisation installieren können. Damit Ihre Anwendung für Google Workspace-Administratoren sichtbar ist, muss sie Direktnachrichten senden.
Führen Sie die folgenden Schritte aus, bevor Sie Ihre App mit dem Google Workspace Marketplace SDK veröffentlichen:
- Testen Sie die Chat App, indem Sie sie über Google Chat installieren. Achten Sie darauf, dass Ihre App voll funktionsfähig ist und nicht in Bearbeitung ist.
- Prüfen Sie, ob Ihre App alle Anforderungen für die Veröffentlichung erfüllt. Siehe Überprüfungsbereiche.
- Notieren Sie sich die Versionsnummer Ihrer App. Sie benötigen sie zur Konfiguration des Google Workspace Marketplace SDK.
Wenn Sie zur Veröffentlichung bereit sind, lesen Sie den Artikel Übersicht: Apps veröffentlichen.