Google Chat API konfigurieren

Für jede von Ihnen erstellte Google Chat-Anwendung ist ein eigenes Google Cloud-Projekt mit aktivierter und konfigurierter Chat API erforderlich. 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 verwenden, wenn sie mit Ihrer Chat-App interagieren.
    • Avatar-URL: Eine HTTPS-URL, die auf ein quadratisches Bild (z. B. PNG oder JPEG) verweist und mindestens 128 × 128 Pixel groß ist und als Avatar für Ihre Chat-App angezeigt wird.
    • Beschreibung: Eine Beschreibung des Zwecks der Chat-App. Sie wird unter dem Namen der Chat-App angezeigt.

  3. Klicken Sie zum Aktivieren der interaktiven Funktionen auf die Ein/Aus-Schaltfläche Interaktive Funktionen aktivieren, damit Nutzer mit Ihrer Chat-App interagieren können. Verwenden Sie die folgende Tabelle, um die Konfiguration abzuschließen:

    Field Beschreibung
    Funktionalität Eine Reihe von Feldern, über die festgelegt wird, wie die Chat-App mit Nutzern interagieren kann:
    • 1:1-Nachrichten empfangen: Nutzer können die Chat App direkt in Google Chat finden und ihnen Nachrichten senden.
    • Gruppenbereichen und Gruppenunterhaltungen beitreten: Nutzer können die Chat App zu Gruppenbereichen und Gruppenunterhaltungen hinzufügen.
    Verbindungseinstellungen Der Endpunkt für die Chat-App, der einer der folgenden ist:
    • App-URL: Ein HTTPS-Endpunkt, der die Implementierung der Chat-App hostet.
    • 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 bei einer Dialogflow-Integration. Weitere Informationen finden Sie unter 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 Hauptaktionen der Chat-App in Google Chat sehen und eine bestimmte Aktion auswählen, mit der sie interagieren möchten. Weitere Informationen finden Sie unter Slash-Befehle als Chat-App beantworten.
    Linkvorschauen URL-Muster, die von der Chat-App erkannt 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-Gruppen, die Ihre Chat-App aufrufen und installieren können. Verwenden Sie dieses Feld, um Ihre Chat-App zu testen oder für Ihr Team freizugeben. Weitere Informationen finden Sie unter Sichtbarkeit und Veröffentlichungseinstellungen für Ihre Chat-App.

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

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

Anderen Personen die Berechtigung erteilen, eine Chat-App zu konfigurieren

Sie können bestimmten Nutzern Zugriff auf die Konfigurationsseite der Chat-App gewähren. Verwenden Sie die IAM-Rollen Inhaber von Chat-Apps und Betrachter von Chat-Apps. Nutzer mit diesen Rollen können die Konfigurationsseite der Chat-App nicht über das Dashboard APIs und Dienste aufrufen. Sie können die Konfigurationsseite aber aufrufen, indem sie in der Google Cloud Console das Host-Cloud-Projekt der Chat-App wie folgt aufrufen:

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, in dem die Chat-App gehostet wird.