Für jede Google Chat-App, die Sie erstellen, ist eine eigene Google Cloud-Projekt mit aktivierter und konfigurierter Chat API Diese Seite zeigt Ihnen, wie Sie die Chat API konfigurieren.
Vorbereitung
- Unternehmen Google Workspace-Konto mit Zugriff auf Google Chat:
- Google Cloud-Projekt erstellen
- Konfigurieren Sie den OAuth-Zustimmungsbildschirm.
- Aktivieren Sie die Google Chat API.
Anzeigenamen, Avatar und Beschreibung für die Chat App auswählen
Zum Aufrufen der Chat API müssen Sie eine Google Chat App mit den folgenden Informationen:
| Feld | Beschreibung | Format |
|---|---|---|
| App-Name | Der Anzeigename für die Chat App. | Bis zu 25 alphanumerische Zeichen |
| Avatar-URL | Das Bild, das als das Ihrer Chat-App angezeigt wird Avatar. | Eine HTTPS-URL, die auf ein quadratisches Grafikbild (PNG oder JPEG) verweist. Die empfohlene Größe ist 256 × 256 Pixel oder mehr. |
| Beschreibung | Eine kurze Beschreibung, dass der Zweck der Chat-App. | Bis zu 40 alphanumerische Zeichen |
Der Name, der Avatar und die Beschreibung der Chat-App werden Chat-UI angezeigt wird. Für einige Chat-APIs verwendet Google Chat anhand dieser Informationen Aktionen, die eine Chat-App in Google Chat ausführt.
Wenn Sie beispielsweise die Methode spaces.create() aufrufen,
den Namen der Chat-App in der
Beschreibung der Person, die den Gruppenbereich erstellt hat (siehe folgende Abbildung):
spaces.create() ein
im Namen eines Nutzers.
Nutzer können dies auch sehen oder verwenden, um mit Chat-Apps zu interagieren auf folgende Arten:
- Rufen Sie die Chat-App auf, indem Sie den Namen @erwähnen.
- Suchen und starten Sie eine Direktnachricht mit der Chat App. Im Menü Apps werden in Direktnachrichten Name und Avatar der Chat-App.
- Über die Eingabezeile können Nutzer Chat-Apps durchsuchen und Folgendes sehen: Name, Avatar und Beschreibung.
Chat-App in der Google Cloud Console konfigurieren
Wenn Sie die Details der Chat App haben, öffnen Sie Ihr Cloud-Projekt erstellen und die Chat API konfigurieren:
Rufen Sie in der Google Cloud Console die Seite der Chat API auf und klicken Sie auf das Seite Konfiguration:
Geben Sie unter Anwendungsinformationen den App-Namen, die Avatar-URL und Beschreibung.
Klicken Sie unter „Interaktive Features“ auf die Ein/Aus-Schaltfläche Interaktive Features aktivieren. deaktiviert, um interaktive Funktionen für die Chat-App. Du kannst das später einrichten. Weitere Informationen zu Konfigurieren und Erstellen interaktiver Funktionen, siehe Nutzerinteraktionen empfangen und darauf reagieren:
Optional: Klicken Sie unter Logs das Kästchen Fehler in Logging protokollieren an, um Google Cloud Logging verwenden. Weitere Informationen finden Sie unter Abfragefehlerlogs für Chat-Apps
Klicken Sie auf Speichern.
Anderen Personen die Berechtigung zum Konfigurieren einer Chat-App gewähren
Sie können Bestimmten Nutzern Zugriff gewähren zur Konfigurationsseite der Chat-App. Verwenden Sie die Methode IAM für Chat-App-Inhaber und Chat-Apps-Betrachter Rollen. Nutzer mit diesen Rollen können die Chat-App nicht aufrufen Konfigurationsseite mithilfe der APIs und Dienste, kann aber können Sie über die Google Cloud Console So sieht das Cloud-Hostprojekt der Chat-App aus:
https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID
Dabei ist PROJECT_ID die Projekt-ID des
Google Cloud-Projekt, das die Chat-App hostet.
Weitere Informationen
- Chat-App-Architektur auswählen
- So konfigurieren Sie die Chat-App für interaktive Funktionen: Siehe Nutzerinteraktionen empfangen und beantworten