In diesem Abschnitt werden häufige Probleme beschrieben, die beim Erstellen und Testen von Chat-Apps auftreten können.
Eine Kartennachricht, ein Dialogfeld oder eine Linkvorschau wird nicht wie erwartet gerendert oder funktioniert nicht wie erwartet
Informationen zur Fehlerbehebung bei Kartenfehlern finden Sie unter Fehlerbehebung und Korrektur von Karten.
App reagiert nicht
Wenn Sie der Chat-App eine Nachricht senden und die Antwort „App reagiert nicht“ erhalten, überprüfen Sie die Konfiguration der Chat-App:
Klicken Sie in der Google API Console auf das Menü > APIs und Dienste > Aktivierte APIs und Dienste > Google Chat API > Konfiguration.
Achten Sie darauf, dass unter App-Status die Option Live – für Nutzer verfügbar ausgewählt ist.
Achten Sie darauf, dass die Einstellungen unter Interaktive Funktionen für die Funktionen Ihrer App geeignet sind. Wenn Ihre Chat-App mit Nutzern interagiert, aktivieren Sie Interaktive Funktionen aktivieren:
- Standardmäßig können Apps auf Direktnachrichten von Nutzern antworten.
- Wenn Ihre App auf Nachrichten in Gruppenbereichen und Gruppenchats antwortet, wählen Sie Gruppenbereichen und Gruppenunterhaltungen beitreten aus.
- Achten Sie darauf, dass unter Verbindungseinstellungen die HTTP-Endpunkt-URL, die Bereitstellungs-ID des Apps Script-Projekts, der Themenname von Cloud Pub/Sub oder der Dialogflow-Agent korrekt festgelegt und bereitgestellt ist.
- Achten Sie darauf, dass unter Sichtbarkeit die entsprechenden Nutzer mit einer E‑Mail-Adresse oder einer Gruppe in der Google Workspace-Domain Zugriff auf die App haben. Wenn die App mit dem Google Workspace Marketplace SDK bereitgestellt wird, sind keine Sichtbarkeitseinstellungen erforderlich, da die Google Workspace Marketplace-Einstellungen Vorrang haben.
Wenn die App mit dem Google Workspace Marketplace SDK veröffentlicht wurde, überprüfen Sie die Google Workspace Marketplace-Einstellungen.
Klicken Sie auf Speichern.
Senden Sie der App noch einmal eine Nachricht.
Die Google Chat API ist nur für Google Workspace-Nutzer verfügbar
Beim Konfigurieren der Chat-App wird möglicherweise der Fehler Google Chat API is only available to Google Workspace users angezeigt. Diese Meldung bedeutet, dass das Google-Konto, mit dem Sie die Chat API konfiguriert haben, nicht Teil einer Google Workspace-Organisation ist. Wenn Sie eine
Chat-App erstellen oder die Chat API verwenden möchten, müssen Sie ein
Google Workspace
-Konto verwenden.
Google Chat-Nutzer können Chat-Apps auch ohne Google Workspace-Konto verwenden. Weitere Informationen dazu, wie Nutzer Chat-Apps finden und installieren, finden Sie unter Interaktive Google Chat-Apps erstellen.
Nutzer können aus Projektbereichen ausgeschlossen werden
Wenn beispielsweise für einen Nutzer die Einstellung für das Chatprotokoll erzwungen „aktiviert“ ist und für einen Projektbereich die Einstellung für das Chatprotokoll erzwungen „deaktiviert“ ist, kann dieser Nutzer dem Projektbereich möglicherweise nicht beitreten. Außerdem kann dieser Nutzer aus dem Projektbereich entfernt werden, wenn er vor dem Konflikt beigetreten ist und nach dem Konflikt eine Nachricht im Projektbereich postet.
In diesem und anderen Szenarien, in denen es zu Konflikten zwischen den Protokolleinstellungen kommt, kann die Chat API möglicherweise keine Mitgliedschaft erstellen. Wenn Sie eine Nachricht mit Nutzerauthentifizierung erstellen, wird der authentifizierte Nutzer mit einer in Konflikt stehenden Einstellung für das Chatprotokoll möglicherweise aus dem Projektbereich entfernt.
Weitere Informationen finden Sie im Hilfeartikel Nutzer können aus Projektbereichen ausgeschlossen werden in der Google Workspace-Admin-Hilfe.
Fehlerbehebung beim erweiterten Chat-Dienst in Google Apps Script
Weitere Informationen finden Sie auf der Apps Script-Seite zum erweiterten Chat-Dienst.
Nutzer können einem Projektbereich keine Chat-App hinzufügen
Wenn Nutzer beim Hinzufügen einer Chat-App zu einem Projektbereich die Fehlermeldung
This organization's administrator must allow users to install this Chat app
erhalten, kann dies einen der folgenden Gründe haben:
- Die Organisation hat Chat-Apps deaktiviert.
- Die Organisation hat diese bestimmte Chat-App nicht zur Zulassungsliste der Organisation hinzugefügt.
Wenn ein Nutzer diese Fehlermeldung erhält, wenn er mit einer Chat-App interagieren möchte, kann dies daran liegen, dass die Organisation den Zugriff auf eine untergeordnete Organisationseinheit gewährt hat, ohne ihn für die übergeordnete Organisationseinheit zu aktivieren.
Informationen zum Beheben dieses Problems finden Sie unter Nutzern erlauben, Chat-Apps zu installieren.
Der Administrator muss der App den erforderlichen OAuth-Autorisierungsbereich für diese Aktion gewähren
Wenn Sie sich als Chat-App authentifizieren , wird möglicherweise der folgende Fehler angezeigt:
<HttpError 403 when requesting https://chat.googleapis.com/v1/spaces/{space}?alt=json returned "The administrator must grant the app the required OAuth authorization scope for this action.". Details: "The administrator must grant the app the required OAuth authorization scope for this action.">
Diese Fehlermeldung bedeutet, dass ein Google Workspace-Administrator der Chat-App noch keine einmalige Genehmigung zur Verwendung von Autorisierungsbereichen erteilt hat, die mit dem Namen https://www.googleapis.com/auth/chat.app.* beginnen.
So beheben Sie den Fehler:
- Bitten Sie den Google Workspace-Administrator, Ihre Chat-App zu
genehmigen.
Wenn Sie diesen Fehler in der Logik Ihrer Chat-App behandeln,
ziehen Sie in Betracht, eine Nachricht zu senden, in der Sie darauf hinweisen, dass
die Chat-App die Genehmigung des Administrators benötigt, um
die angeforderte Aktion auszuführen. Beispiel:
To perform this action, I need approval. <https://support.google.com/a?p=chat-app-auth|Learn more>. - Wenn die Chat API-Methode den Autorisierungsbereich
https://www.googleapis.com/auth/chat.botunterstützt, für den keine Genehmigung des Administrators erforderlich ist, können Sie ihn stattdessen verwenden. Informationen dazu, welche Autorisierungsbereiche von einer Methode unterstützt werden, finden Sie unter den Google Chat-Apps und Google Chat API-Anfragen authentifizieren und autorisieren.
Fehlerbehebung bei Cloud Functions-Fehlern
Wenn die Chat-App mit Cloud Functions implementiert wurde und nicht funktioniert, helfen Ihnen die folgenden Abschnitte bei der Fehlerbehebung.
Cloud Functions-Logs prüfen
Prüfen Sie zuerst die Cloud Functions-Logs auf Fehler.
Wechseln Sie in der Google API Console zur Seite „Cloud Functions“:
Suchen Sie die Cloud Functions-Funktion Ihrer Chat-App und klicken Sie auf Weitere Aktionen > Logs ansehen, um die Logs zu öffnen.
Der Log-Explorer wird geöffnet und führt eine Abfrage aus, in der Cloud Functions-Logs, einschließlich Fehler, angezeigt werden.
Wenn die standardmäßig protokollierten Informationen nicht ausreichen, um Fehler in Ihrer App zu beheben, können Sie zusätzlichen Code für die Protokollierung aus Ihrem Cloud Functions-Code hinzufügen. Weitere Informationen finden Sie unter Cloud Functions-Logs aufrufen und schreiben.
Cloud Functions-Fehler prüfen
Neben den Logs kann Cloud Functions auch Fehler melden, die während der Ausführung aufgetreten sind.
Wechseln Sie in der Google API Console zur Seite „Cloud Functions“:
Klicken Sie auf die Cloud Functions-Funktion Ihrer Chat-App.
Auf der Seite „Funktionsdetails“ werden Fehler unter Fehler aufgeführt.
Klicken Sie auf einen Fehler, um weitere Informationen zur Fehlerbehebung zu erhalten.
Häufige Cloud Functions-Fehler beheben
Die folgenden Fehler treten manchmal auf, wenn Sie eine Chat-App mit Cloud Functions erstellen.
Function ChatApp in region REGION_NAME in project PROJECT_NAME already exists
Beim Bereitstellen einer Cloud Functions-Funktion wird möglicherweise der Fehler Function
ChatApp in region REGION_NAME in project PROJECT_NAME already
exists angezeigt. Diese Meldung bedeutet, dass eine andere Cloud Functions-Funktion denselben Namen hat wie die, die Sie bereitstellen. Ändern Sie den Namen und stellen Sie die Funktion noch einmal bereit. Achten Sie darauf, dass die Chat-App die Trigger-URL für Ihre Cloud Functions-Funktion und nicht die Trigger-URL der bereits vorhandenen Cloud Functions-Funktion verwendet.
One or more users named in the policy do not belong to a permitted customer
Beim Bereitstellen einer Cloud Functions-Funktion wird möglicherweise der Fehler The operation
cannot be completed on the function: "One or more users named in the policy do
not belong to a permitted customer." angezeigt. Wenn dieser Fehler auftritt und Sie der
Chat-App eine Nachricht senden, erhalten Sie eine Fehlermeldung, dass die App nicht reagiert, weil Google
Chat den Server, auf dem die Cloud Functions-Funktion gehostet wird, nicht erreichen kann. Diese Meldung bedeutet, dass ein Nutzer mit dem Namen „allUsers“ nicht die Berechtigung hat, die Cloud Functions-Funktion aufzurufen.
Wenn Sie „allUsers“ die Rolle „Cloud Functions-Aufrufer“ zuweisen, ist die Cloud Functions-Funktion, die die App unterstützt, öffentlich verfügbar und kann ohne Authentifizierung aufgerufen werden. Informationen zum Zuweisen einer Rolle finden Sie unter
Einzelne Rolle zuweisen.
Dieser Fehler kann bedeuten, dass das Google Cloud-Projekt auf eine Domain beschränkt ist. Weitere Informationen zu Einschränkungen für die Domaineinschränkung finden Sie unter Identitäten nach Domain einschränken.
Prüfen Sie, ob Ihre Cloud Functions-Funktion nicht authentifizierte Aufrufe zulässt, um dieses Problem zu beheben. Informationen dazu, wie Sie nicht authentifizierte Aufrufe für eine vorhandene Cloud Functions-Funktion zulassen, finden Sie unter Öffentlichen (nicht authentifizierten) Zugriff gewähren.