In diesem Leitfaden wird beschrieben, wie Sie die Methode list()
für die Message
-Ressource der Google Chat API verwenden, um eine paginatierte, filterbare Liste der Nachrichten in einem Gruppenbereich aufzurufen.
In der Chat API wird eine Chatnachricht durch das
Message
-Ressource
Chat-Nutzer können zwar nur Nachrichten senden, die Text enthalten,
Chat-Apps können viele andere Messaging-Funktionen nutzen, darunter
Anzeige statischer oder interaktiver Benutzeroberflächen, das Erfassen von Informationen
und Nachrichten privat zu übermitteln. Weitere Informationen zur Nachrichtenfunktion
die für die Chat API zur Verfügung stehen, finden Sie in der
Nachrichten in Google Chat
Vorbereitung
Node.js
- Ein Google Workspace-Konto für Unternehmen oder Organisationen mit Zugriff auf Google Chat.
- Richten Sie Ihre Umgebung ein:
- Google Cloud-Projekt erstellen
- Konfigurieren Sie den OAuth-Zustimmungsbildschirm.
- Aktivieren und konfigurieren Sie die Google Chat API mit einem Namen, Symbol und einer Beschreibung für Ihre Chat-App.
- Installieren Sie die Node.js Cloud-Clientbibliothek
-
OAuth-Client-ID-Anmeldedaten für eine Desktopanwendung erstellen Wenn Sie das Beispiel in dieser Anleitung ausführen möchten, speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
client_secrets.json
in Ihrem lokalen Verzeichnis.
- Wählen Sie einen Autorisierungsbereich aus, der die Nutzerauthentifizierung unterstützt.
- Einen Google Chat-Bereich Informationen zum Erstellen mit der Google Chat API finden Sie unter Erstellen Sie einen Gruppenbereich. Eine Anleitung zum Erstellen in Google Chat finden Sie in der Hilfe.
Python
- Unternehmen Google Workspace-Konto mit Zugriff auf Google Chat:
- Richten Sie Ihre Umgebung ein:
- Google Cloud-Projekt erstellen
- Konfigurieren Sie den OAuth-Zustimmungsbildschirm.
- Aktivieren und konfigurieren Sie die Google Chat API mit einem Namen, und eine Beschreibung der Chat App.
- Installieren Sie die Cloud-Clientbibliothek für Python.
-
OAuth-Client-ID-Anmeldedaten für eine Desktopanwendung erstellen Um das Beispiel in diesem
sollten Sie die Anmeldedaten als JSON-Datei mit dem Namen
client_secrets.json
in Ihrem lokales Verzeichnis.
- Wählen Sie einen Autorisierungsbereich aus, der die Nutzerauthentifizierung unterstützt.
- Einen Google Chat-Bereich Informationen zum Erstellen mit der Google Chat API finden Sie unter Gruppenbereich erstellen. Eine Anleitung zum Erstellen in Google Chat finden Sie in der Hilfe.
Java
- Unternehmen Google Workspace-Konto mit Zugriff auf Google Chat:
- Richten Sie Ihre Umgebung ein:
- Google Cloud-Projekt erstellen
- Konfigurieren Sie den OAuth-Zustimmungsbildschirm.
- Aktivieren und konfigurieren Sie die Google Chat API mit einem Namen, Symbol und einer Beschreibung für Ihre Chat-App.
- Installieren Sie die Java-Cloud-Clientbibliothek.
-
Erstellen Sie OAuth-Client-ID-Anmeldedaten für eine Desktopanwendung. Wenn Sie das Beispiel in dieser Anleitung ausführen möchten, speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
client_secrets.json
in Ihrem lokalen Verzeichnis.
- Wählen Sie einen Autorisierungsbereich aus, der die Nutzerauthentifizierung unterstützt.
- Ein Google Chat-Bereich Informationen zum Erstellen mit der Google Chat API finden Sie unter Erstellen Sie einen Gruppenbereich. Eine Anleitung zum Erstellen in Google Chat finden Sie in der Hilfe.
Apps Script
- Unternehmen Google Workspace-Konto mit Zugriff auf Google Chat:
- Richten Sie Ihre Umgebung ein:
- Google Cloud-Projekt erstellen
- Konfigurieren Sie den OAuth-Zustimmungsbildschirm.
- Aktivieren und konfigurieren Sie die Google Chat API mit einem Namen, und eine Beschreibung der Chat App.
- Eigenständiges Apps Script-Projekt erstellen und aktivieren Sie den erweiterten Chatdienst.
- Wählen Sie einen Autorisierungsbereich aus, der die Nutzerauthentifizierung unterstützt.
- Einen Google Chat-Bereich Informationen zum Erstellen mit der Google Chat API finden Sie unter Erstellen Sie einen Gruppenbereich. Eine Anleitung zum Erstellen in Google Chat finden Sie in der Hilfe.
Nachrichten auflisten
So listen Sie Nachrichten auf mit Nutzerauthentifizierung Übergeben Sie in Ihrer Anfrage Folgendes:
- Geben Sie den Autorisierungsbereich
chat.messages.readonly
oderchat.messages
an. - Rufen Sie die Methode
ListMessages()
auf.
Im folgenden Beispiel werden Nachrichten in einem Chatbereich aufgelistet:
Node.js
Python
Java
Apps Script
Wenn Sie dieses Beispiel ausführen möchten, ersetzen Sie SPACE_NAME
durch die ID aus dem Feld name
des Gruppenbereichs. Sie können die ID durch Aufrufen der Methode ListSpaces()
oder aus der URL des Gruppenbereichs abrufen.
Die Chat API gibt eine Fehlermeldung
Liste der Nachrichten
die im angegebenen Bereich gesendet wurden. Wenn die Anfrage keine Nachrichten enthält, enthält der Parameter
Die Chat API-Antwort gibt ein leeres Objekt zurück. Bei Verwendung einer REST/HTTP-Schnittstelle enthält die Antwort ein leeres JSON-Objekt, {}
.
Weitere Informationen
- Nachricht formatieren
- Nachricht löschen
- Details zu einer Nachricht abrufen
- Nachricht aktualisieren
- Nachricht senden: