Google Chat API konfigurieren

Für jede von Ihnen erstellte Google Chat-App ist ein eigenes Google Cloud-Projekt erforderlich, in dem die Chat API aktiviert und konfiguriert ist. Auf dieser Seite erfahren Sie, wie Sie die Chat API konfigurieren.

Voraussetzungen

Chat API konfigurieren

  1. Suchen Sie in der Google Cloud Console nach „Google Chat API“, klicken Sie auf Google Chat API und dann auf Verwalten.

    Zur Chat API

  2. Klicken Sie auf den Tab Konfiguration und geben Sie die folgenden erforderlichen Informationen ein:

    • App-Name: Der Name, den Nutzer bei der Interaktion mit Ihrer Chat-App verwenden.
    • Avatar-URL: Eine HTTPS-URL, die auf ein quadratisches Grafikbild (z. B. PNG oder JPEG) mit mindestens 128 × 128 Pixel verweist und als Avatar für Ihre Chat-App angezeigt wird.
    • Beschreibung: Eine Beschreibung des beabsichtigten Zwecks der Chat-App. Sie wird unter dem Namen der Chat-App angezeigt.

  3. Klicken Sie zum Aktivieren der interaktiven Funktionen auf Interaktive Features aktivieren, damit Nutzer mit Ihrer Chat-App interagieren können, und schließen Sie die Konfiguration anhand der folgenden Tabelle ab:

    Field Beschreibung
    Funktionen Eine Reihe von Feldern, die festlegen, wie die Chat-App mit Nutzern interagieren kann:
    • 1:1-Nachrichten empfangen: Nutzer können die Google Chat App direkt in Google Chat finden und Nachrichten senden.
    • Gruppenbereichen und Gruppenunterhaltungen beitreten: Nutzer können die Chat App Gruppenbereichen und Gruppenunterhaltungen hinzufügen.
    Verbindungseinstellungen Der Endpunkt für die Chat-App. Dies ist einer der folgenden:
    • App-URL: Ein HTTPS-Endpunkt, auf dem die Implementierung der Chat-App gehostet wird.
    • Apps Script-Projekt: Eine Bereitstellungs-ID für ein Apps Script-Projekt, in dem eine Chat-App implementiert ist.
    • Name des Cloud Pub/Sub-Themas: Ein Pub/Sub-Thema, das die Chat-App als Endpunkt abonniert.
    • Dialogflow: Registriert die Chat-App mit einer Dialogflow-Integration. Weitere Informationen finden Sie unter In Dialogflow Google Chat App erstellen, die natürliche Sprache versteht.
    Slash-Befehle Befehle, die Nutzern in Google Chat angezeigt werden können. Damit können Nutzer die wichtigsten Aktionen für Ihre Chat App in Google Chat sehen und eine bestimmte Aktion auswählen, mit der sie interagieren möchten. Weitere Informationen finden Sie unter Als Chat-App auf Slash-Befehle reagieren.
    Linkvorschauen URL-Muster, die die Chat App erkennt und zusätzliche Inhalte bereitstellt, wenn Nutzer Links senden. Weitere Informationen finden Sie unter Vorschaulinks.
    Sichtbarkeit Bis zu 5 Personen oder eine oder mehrere Google-Gruppen, die Ihre Chat App aufrufen und installieren dürfen. Mit diesem Feld können Sie Ihre Chat App testen oder die Chat App für Ihr Team freigeben. Weitere Informationen finden Sie unter Einstellungen für Sichtbarkeit und Veröffentlichung für Ihre Google Chat-App.

  4. Wenn Fehler in Cloud Logging protokolliert werden sollen, wenn die Chat-App einen Fehler zurückgibt, klicken Sie das Kästchen Fehler in Logging protokollieren an. Weitere Informationen finden Sie unter Abfragefehlerlogs für Chat-Apps.

  5. Klicke auf Speichern. Wenn Sie die Konfiguration der Chat-App speichern, ist die Chat-App für die angegebenen Nutzer in Ihrer Google Workspace-Organisation verfügbar.

Anderen Personen die Berechtigung zum Konfigurieren einer Chat-App gewähren

Sie können bestimmten Nutzern Zugriff auf die Konfigurationsseite der Chat-App gewähren. Verwenden Sie die IAM-Rollen Chat-Apps-Inhaber und Chat-Apps-Betrachter. Nutzer mit diesen Rollen können die Konfigurationsseite für Chat-Apps nicht über das Dashboard APIs & Dienste aufrufen. Auf die Konfigurationsseite können sie jedoch in der Google Cloud Console für das Host-Cloud-Projekt der Chat-App folgendermaßen zugreifen:

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-Projekts, das die Chat-App hostet.