In diesem Abschnitt werden häufige Probleme beschrieben, die beim Erstellen und Testen von Chat-Apps auftreten können.
Eine Kartenmitteilung, ein Dialogfeld oder eine Linkvorschau wird nicht gerendert oder funktioniert nicht wie erwartet
Hilfe bei der Fehlerbehebung bei Karten finden Sie unter Kartenfehler beheben.
App reagiert nicht
Wenn Sie der Chat-App eine Nachricht senden und die Antwort „App reagiert nicht“ erhalten, prüfen Sie die Konfiguration der Chat-App:
Klicken Sie in der Google Cloud Console auf das Menü > Weitere Produkte > Google Workspace > Produktbibliothek > Google Chat API > Verwalten > Konfiguration.
Prüfen Sie unter App-Status, ob Aktiv – für Nutzer verfügbar ausgewählt ist.
Prüfen Sie unter Interaktive Funktionen, ob die Einstellungen für die Funktionen Ihrer App geeignet sind. Wenn Ihre Chat-App mit Nutzern interagiert, müssen Sie Interaktive Funktionen aktivieren 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.
- Prüfen Sie unter Verbindungseinstellungen, ob die HTTP-Endpunkt-URL, die Bereitstellungs-ID des Apps Script-Projekts, der Themenname von Cloud Pub/Sub oder der Dialogflow-Agent richtig festgelegt und bereitgestellt ist.
- Prüfen Sie unter Sichtbarkeit, ob 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, prüfen Sie die Google Workspace Marketplace-Einstellungen.
Klicken Sie auf Speichern.
Versuchen Sie noch einmal, der App eine Nachricht zu senden.
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 entwickeln oder die Chat API verwenden möchten, benötigen Sie ein Google Workspace-Konto.
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 ein Google Workspace-Administrator Nutzern nicht erlaubt, das Chatprotokoll zu aktivieren oder zu deaktivieren, kann es vorkommen, dass Nutzer einem Gruppenbereich nicht beitreten können oder daraus entfernt werden. Das liegt dann an einem Konflikt zwischen einer Einstellung auf Nutzerebene, die das Aktivieren oder Deaktivieren des Chatprotokolls erzwingt, und einem Gruppenbereich, der die erzwungene Einstellung auf Organisationsebene übernimmt.
Wenn beispielsweise für einen Nutzer die Chatprotokolleinstellung „Aktiviert“ erzwungen wird und für einen Gruppenbereich die Chatprotokolleinstellung „Deaktiviert“ erzwungen wird, kann der Nutzer dem Gruppenbereich möglicherweise nicht beitreten. Außerdem wird der Nutzer möglicherweise aus dem Gruppenbereich entfernt, wenn er vor dem Konflikt beigetreten ist und nach dem Konflikt eine Nachricht im Gruppenbereich postet.
In diesem und anderen Szenarien, in denen es zu Konflikten zwischen den Einstellungen für das Chatprotokoll kommt, kann es sein, dass die Chat API keine Mitgliedschaft erstellen kann. Wenn eine Nachricht mit Nutzerauthentifizierung erstellt wird, kann es sein, dass der authentifizierte Nutzer mit einer in Konflikt stehenden Einstellung für das Chatprotokoll aus dem Projektbereich entfernt wird.
Weitere Informationen finden Sie in der Google Workspace-Admin-Hilfe unter Nutzer können aus Projektbereichen ausgeschlossen werden.
Fehlerbehebung beim erweiterten Chat-Dienst in Google Apps Script
Weitere Informationen finden Sie auf der Apps Script-Seite zum erweiterten Chatdienst.
Nutzer können einem Gruppenbereich keine Chat-App hinzufügen
Wenn Nutzer beim Versuch, einem Bereich eine Chat-App hinzuzufügen, die Fehlermeldung This organization's administrator must allow users to install this Chat app erhalten, kann das folgende Ursachen haben:
- Die Organisation hat Chat-Apps deaktiviert.
- Die Organisation hat diese spezielle Chat-App nicht auf die Zulassungsliste der Organisation gesetzt.
Wenn ein Nutzer diese Fehlermeldung erhält, wenn er versucht, mit einer Chat-App zu interagieren, kann das daran liegen, dass die Organisation Zugriff auf eine untergeordnete Organisationseinheit gewährt hat, ohne ihn für die übergeordnete Organisationseinheit zu aktivieren.
Informationen zur Behebung 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 als Chat-App authentifizieren, erhalten Sie möglicherweise den folgenden Fehler:
<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 für die 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, Ihrer Chat-App die Genehmigung zu erteilen.
Wenn Sie diesen Fehler in der Logik Ihrer Chat-App behandeln, sollten Sie eine Nachricht senden, in der Sie darauf hinweisen, dass die Chat-App die Genehmigung des Administrators benötigt, um die angeforderte Aktion auszuführen, z. B.:
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 Administratorgenehmigung erforderlich ist, sollten Sie diese Methode stattdessen verwenden. Informationen dazu, welche Autorisierungsbereiche von einer Methode unterstützt werden, finden Sie unter Google Chat-Apps und Google Chat API-Anfragen authentifizieren und autorisieren.
Fehler in Cloud Functions beheben
Wenn die Chat-App mit Cloud Functions implementiert wurde und nicht funktioniert, können Sie das Problem mithilfe der folgenden Abschnitte beheben.
Cloud Functions-Logs prüfen
Prüfen Sie zuerst die Cloud Functions-Logs auf Fehler.
Wechseln Sie in der Google Cloud Console zur Seite Cloud Functions:
Suchen Sie zum Öffnen der Logs nach der Cloud Functions-Funktion Ihrer Chat-App und klicken Sie dann auf Aktionen anzeigen > Logs ansehen.
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 Log-Code in Ihre Cloud Functions-Funktion einfügen. Weitere Informationen finden Sie unter Cloud Functions-Logs aufrufen und schreiben.
Fehler in Cloud Functions-Funktionen prüfen
Neben den Logs können auch Fehler gemeldet werden, die während der Ausführung einer Cloud Functions-Funktion aufgetreten sind.
Wechseln Sie in der Google Cloud 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
Beim Erstellen einer Chat-App mit Cloud Functions können die folgenden Fehler auftreten.
Die Funktion „ChatApp“ in der Region REGION_NAME im Projekt PROJECT_NAME ist bereits vorhanden.
Beim Bereitstellen einer Cloud Functions-Funktion erhalten Sie möglicherweise den Fehler Function
ChatApp in region REGION_NAME in project PROJECT_NAME already
exists. Diese Meldung bedeutet, dass eine andere Cloud Functions-Funktion denselben Namen hat wie die Funktion, die Sie bereitstellen. Ändern Sie den Namen und stellen Sie die Funktion noch einmal bereit. Prüfen Sie, ob die Chat-App die Trigger-URL für Ihre Cloud Functions-Funktion und nicht die Trigger-URL der vorhandenen Cloud Functions-Funktion verwendet.
Mindestens ein in der Richtlinie genannter Nutzer gehört nicht zu einem zulässigen Kunden.
Beim Bereitstellen einer Cloud-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 Sie diesen Fehler erhalten und dann die Chat-App verwenden, wird eine Fehlermeldung angezeigt, dass die App nicht reagiert, weil Google Chat den Server, auf dem die Cloud-Funktion gehostet wird, nicht erreichen kann. Diese Meldung bedeutet, dass ein Nutzer mit dem Namen „allUsers“ nicht berechtigt ist, die Cloud Functions-Funktion aufzurufen.
Wenn Sie „allUsers“ die Rolle „Cloud Functions-Aufrufer“ zuweisen, ist die Cloud-Funktion, die die App unterstützt, öffentlich verfügbar und ohne Authentifizierung zugänglich. Informationen zum Zuweisen einer Rolle finden Sie unter Einzelne Rolle zuweisen.
Dieser Fehler kann darauf hindeuten, dass das Google Cloud-Projekt auf eine Domain beschränkt ist. Weitere Informationen zu Einschränkungen für Domaineinschränkungen finden Sie unter Identitäten nach Domain einschränken.
Um dieses Problem zu beheben, prüfen Sie, ob Ihre Cloud Functions-Funktion nicht authentifizierte Aufrufe zulässt. Informationen dazu, wie Sie nicht authentifizierte Aufrufe für eine vorhandene Cloud-Funktion zulassen, finden Sie unter Öffentlichen (nicht authentifizierten) Zugriff gewähren.