Nachdem Sie eine Chat-App erstellt haben, können Sie sie veröffentlichen, sodass sie für ausgewählte Personen oder Gruppen, für alle Nutzer in Ihrer Google Workspace-Organisation und für alle Google Chat-Nutzer mit einem Google Workspace-Konto verfügbar ist.
Wie Nutzer Google Chat-Apps finden und verwenden
Nutzer haben verschiedene Möglichkeiten, Chat-Apps zu finden und zu verwenden:
- Apps in Google Chat suchen
- Mit einer App interagieren, die einem Chatbereich hinzugefügt wurde
- Die App wird im Bereich „Direktnachrichten“ erkannt, nachdem ein Google Workspace-Administrator die App in ihrem Namen installiert hat.
Google Chat-Nutzer können eine Direktnachricht mit der App starten oder sie einem Gruppenbereich hinzufügen, indem sie sie aus der Liste der vorgeschlagenen Empfänger auswählen (siehe unten):
Nutzer können die Liste der vorgeschlagenen Empfänger auch @erwähnen, indem sie die Anwendung namentlich erwähnen. Wenn Sie beispielsweise eine App namens „Planer Bot“ veröffentlichen und ein Nutzer in Ihrer Organisation „@sch“ eingibt, wird Ihre Anwendung in Google Chat als eine der Optionen für die automatische Vervollständigung vorgeschlagen.
Alternativ können Google Workspace-Administratoren Chat-Apps im Google Workspace Marketplace finden und Anwendungen für Nutzer in ihrer Organisation installieren. Wenn Administratoren eine Chat-App installieren, wird sie im Bereich für Direktnachrichten der Nutzer angezeigt.
Google Workspace-Administratoren können die Verwendung von Chat-Apps in ihrer Google Workspace-Organisation auch 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 auf die Zulassungsliste zu setzen, damit Nutzer sie finden und verwenden können. Weitere Informationen finden Sie in der Dokumentation der Google Workspace-Admin-Hilfe unter Nutzern erlauben, Chat-Apps zu installieren.
Chat-App mit der Google Cloud Console konfigurieren und veröffentlichen
So veröffentlichen Sie Ihre Chat-App für andere:
- Aktivieren und konfigurieren Sie die Google Chat API. Wenn Sie die API konfigurieren, gewähren Sie anderen Google Chat-Nutzern Zugriff auf die Chat-App zu Testzwecken.
- Veröffentlichen Sie Ihre App mit dem Google Workspace Marketplace SDK. Sie können Ihre Chat-App 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:
. . . .| Ich entwickle eine Chat-App... | Authentifizierungsmethode | Einstellungen für die Google Chat API | Einstellungen für das Google Workspace Marketplace SDK | Wo wird meine Chat-App veröffentlicht? |
|---|---|---|---|---|
| ...Für mein kleines Team | Authentifizieren Sie sich als Nutzer oder Anwendung. | Geben Sie in der Einstellung Sichtbarkeit die Personen und/oder Google Groups an, die auf die App zugreifen dürfen.
Wenn in Ihrem Google Workspace-Konto Anwendungen auf der Zulassungsliste stehen, können Sie bis zu fünf einzelne E-Mail-Adressen angeben. Google Groups können nicht angegeben werden. |
Sie müssen das Google Workspace Marketplace SDK für die Chat App nicht konfigurieren. | Alle Teammitglieder können Ihre Chat-App über Google Chat finden und verwenden. |
| ...für mein großes Team | Authentifizieren Sie sich als Nutzer oder Anwendung. | Geben Sie in der Einstellung Sichtbarkeit die Personen und/oder Google Groups an, die Ihre Chat-App testen sollen.
Veröffentlichen Sie nach dem Testen Ihre Chat-App in der Google Workspace-Organisation und verwenden Sie dazu die Einstellungen im Google Workspace Marketplace SDK. |
Setzen Sie App-Sichtbarkeit auf Privat. Wählen Sie unter Installationseinstellungen die Option Privatperson und Administrator aus. Wenn Ihr Google Workspace-Konto erfordert, dass Apps auf die Zulassungsliste gesetzt werden, 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 der 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 und Ihre App im Google Workspace Marketplace ansehen. Nutzer und Google Workspace-Administratoren können Ihre Anwendung vom Marketplace aus installieren. |
| ...für meine Google Workspace-Organisation | Authentifizieren Sie sich als Nutzer oder Anwendung. | Geben Sie in der Einstellung Sichtbarkeit die Personen und/oder Google Groups an, die Ihre Chat-App testen sollen.
Veröffentlichen Sie nach dem Testen Ihre Chat-App in der Google Workspace-Organisation und verwenden Sie dazu die Einstellungen im Google Workspace Marketplace SDK. |
Setzen Sie App-Sichtbarkeit auf Privat. Wählen Sie unter Installationseinstellungen die Option Privatperson und Administrator aus. |
Jeder in Ihrer Google Workspace-Organisation kann Ihre Chat-App in Google Chat finden und installieren und Ihre App im Google Workspace Marketplace ansehen. Nur Google Workspace-Administratoren können Ihre App vom Marketplace installieren. |
| ...Für alle (öffentliche Chat-App) | Authentifizieren Sie sich als App. | Geben Sie in der Einstellung Sichtbarkeit die Personen und/oder Google Groups an, die die Chat-App testen möchten.
Nach dem Testen veröffentlichen Sie Ihre Chat-App mit den Einstellungen im Google Workspace Marketplace öffentlich. |
Setzen Sie App-Sichtbarkeit auf Öffentlich. Wählen Sie unter Installationseinstellungen die Option Privatperson und Administrator aus. |
Jeder Google Workspace-Nutzer 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 App vom Marketplace installieren. |
Google Chat API aktivieren und konfigurieren
Richten Sie in der Google API 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 ein Dienstkonto hinzuzufügen. Weisen Sie dem Dienstkonto die Rolle Projektinhaber zu.
API aktivieren - Speichern Sie den heruntergeladenen JSON-Schlüssel. Die App kann mit diesem Schlüssel Nachrichten asynchron an Gruppenbereiche authentifizieren.
- Öffnen Sie Ihr Projekt in der API Console. 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 ein, wie in der folgenden Tabelle beschrieben.
Wenn Sie die App-Konfiguration speichern, ist Ihre Anwendung für die angegebenen Nutzer in Ihrer Google Workspace-Organisation verfügbar.
Google Chat API-Konfigurationseinstellungen
| Feld | Beschreibung |
|---|---|
| App-Name | Der Name, den Nutzer für die Interaktion mit Ihrer App verwenden. |
| Avatar-URL | Eine HTTPS-URL, die auf ein quadratisches Grafikbild wie PNG oder JPEG verweist, das mindestens 128 × 128 Pixel groß ist und als Avatar für Ihre App erscheint. |
| Beschreibung | Eine Beschreibung der Funktionen der App, die unter dem Namen der App angezeigt wird. |
| Funktionen | Eine Reihe von Feldern, die bestimmen, welche Ereignisse die App auslösen können:
|
| Verbindungseinstellungen | Der Endpunkt für die App. Dabei kann es sich um einen der folgenden Status handeln:
|
| Slash-Befehle | Befehle, die Nutzern in Google Chat angezeigt werden können. Damit können Nutzer in Google Chat die wichtigsten Aktionen für Ihre App sehen und eine bestimmte Aktion auswählen, mit der sie interagieren möchten. |
| Link-Entfaltung | URL-Muster, die die App erkennt und für die sie zusätzliche Inhalte bereitstellt, wenn Nutzer Links senden. Weitere Informationen finden Sie unter Links aufheben. |
| Sichtbarkeit | Bis zu fünf Personen oder eine oder mehrere Google Groups, die Ihre Chat-App sehen und installieren können. Verwenden Sie dieses Feld, um Ihre App zu testen oder sie für Ihr Team freizugeben. Weitere Informationen finden Sie unter Sichtbarkeit und Veröffentlichung von Einstellungen für die Chat App. |
App-Konfigurationsberechtigungen gewähren
Sie können bestimmten Nutzern Zugriff auf die Konfigurationsseite für die App gewähren. Verwenden Sie dazu die IAM-Rollen Inhaber von Chat-Apps und Chat-Apps-Betrachter. Nutzer mit diesen Rollen können die Dashboard-Seite für Apps nicht über das Dashboard APIs und Dienste aufrufen. Stattdessen können sie die Konfigurationsseite aufrufen, indem sie in der Console zum Projekt gehen:
https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=your-project-id
App mit dem Google Workspace Marketplace SDK veröffentlichen
Das Google Workspace Marketplace SDK bietet folgende Möglichkeiten:
- Veröffentlichen Sie Ihre Anwendung öffentlich und erlauben Sie jedem Google Chat-Nutzer, Ihre Chat-App einem Gruppenbereich hinzuzufügen.
- Veröffentlichen Sie Ihre App in Ihrer Domain.
- Machen Sie Ihre Anwendung für Google Workspace-Administratoren sichtbar, damit sie die App für Nutzer in ihrer Organisation installieren können. Ihre Anwendung muss direkte Nachrichten enthalten, damit sie für Google Workspace-Administratoren sichtbar ist.
Bevor Sie Ihre Anwendung mit dem Google Workspace Marketplace SDK veröffentlichen, gehen Sie so vor:
- Testen Sie die Chat App, indem Sie sie aus Chat installieren. Achten Sie darauf, dass Ihre Anwendung voll funktionsfähig ist und nicht in Bearbeitung ist.
- Prüfen Sie die Publikationsanforderungen und achten Sie darauf, dass Ihre App alle Anforderungen erfüllt. Weitere Informationen
- Notieren Sie sich die Versionsnummer Ihrer App. Sie benötigen diese zum Konfigurieren des Google Workspace Marketplace SDK.
Informationen zur Veröffentlichung finden Sie unter App veröffentlichen.
Chat App deaktivieren
Nachdem Sie die Konfigurationsseite gespeichert haben, wird das Feld „App Status“ (App-Status) angezeigt. Mit diesem Feld können Sie festlegen, ob die Anwendung Live oder Deaktiviert ist.
So deaktivieren Sie eine Chat-App:
- Öffnen Sie die Google Cloud Console.
- Wählen Sie bei Bedarf das Google Cloud-Projekt aus, in dem die Chat-App gehostet wird:
- Klicken Sie neben „Google Cloud“ auf den Drop-down-Pfeil . Ein Dialogfeld mit den aktuellen Projekten wird angezeigt.
- Wählen Sie das Projekt aus, in dem die migrierte Chat-App gehostet wird.
- Klicken Sie auf Öffnen.
- Suchen Sie nach „Google Chat API“ und klicken Sie auf Google Chat API.
- Klicken Sie auf Verwalten.
- Klicken Sie auf Konfiguration.
- Wählen Sie im Abschnitt „App-Status“ die Option Deaktiviert aus.
- Klicken Sie auf Speichern.