Google Chat API konfigurieren

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

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):

<ph type="x-smartling-placeholder">
</ph> In der Google Chat App wird ein Gruppenbereich für einen Nutzer erstellt.
Abbildung 1: Die Attributionsnachricht, wird angezeigt, wenn mit der Methode 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:

  1. Rufen Sie in der Google Cloud Console die Seite der Chat API auf und klicken Sie auf das Seite Konfiguration:

    Zur Konfigurationsseite der Chat API

  2. Geben Sie unter Anwendungsinformationen den App-Namen, die Avatar-URL und Beschreibung.

  3. 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:

  4. 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

  5. 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.

<ph type="x-smartling-placeholder">