Listet Nachrichten in einem Gruppenbereich auf, in dem der Anrufer Mitglied ist, einschließlich Nachrichten von blockierten Mitgliedern und Gruppenbereichen. Wenn Sie Nachrichten aus einem Gruppenbereich auflisten, in dem keine Nachrichten vorhanden sind, ist die Antwort ein leeres Objekt. Bei Verwendung einer REST-/HTTP-Schnittstelle enthält die Antwort ein leeres JSON-Objekt, {}
. Ein Beispiel finden Sie unter Nachrichten auflisten.
Erfordert eine Nutzerauthentifizierung.
HTTP-Anfrage
GET https://chat.googleapis.com/v1/{parent=spaces/*}/messages
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
parent |
Erforderlich. Der Ressourcenname des Gruppenbereichs, aus dem Nachrichten aufgelistet werden sollen. Format: |
Suchparameter
Parameter | |
---|---|
page |
Die maximale Anzahl zurückgegebener Nachrichten. Der Dienst gibt möglicherweise weniger Nachrichten als dieser Wert zurück. Wenn nicht angegeben, werden maximal 25 zurückgegeben. Der Höchstwert ist 1.000. Wenn Sie einen Wert über 1.000 verwenden, wird er automatisch in 1.000 geändert. Bei negativen Werten wird der Fehler |
page |
Optional, wenn die Ausführung von einer vorherigen Abfrage fortgesetzt wird. Ein Seitentoken, das von einem vorherigen Aufruf der Nachrichtenliste empfangen wurde. Geben Sie diesen Parameter an, um die nachfolgende Seite abzurufen. Beim Paginieren müssen alle anderen angegebenen Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Wenn Sie für die anderen Parameter unterschiedliche Werte übergeben, kann das zu unerwarteten Ergebnissen führen. |
filter |
Einen Abfragefilter. Sie können Nachrichten nach Datum ( Wenn Sie Nachrichten nach dem Erstellungsdatum filtern möchten, geben Sie Wenn Sie nach Thread filtern möchten, geben Sie die Verwenden Sie in Ihrer Abfrage den Operator Die folgenden Abfragen sind beispielsweise gültig:
Ungültige Anfragen werden vom Server mit dem Fehler |
order |
Optional, wenn die Ausführung von einer vorherigen Abfrage fortgesetzt wird. Die Reihenfolge der Nachrichtenliste. Geben Sie einen Wert an, nach dem sortiert werden soll. Gültige Werte für Sortiervorgänge:
Die Standardreihenfolge ist |
show |
Gibt an, ob gelöschte Nachrichten berücksichtigt werden sollen. Gelöschte Nachrichten enthalten den gelöschten Zeitraum und Metadaten zum Löschen, der Inhalt der Nachricht ist jedoch nicht verfügbar. |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwortnachricht zum Auflisten von Nachrichten.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"messages": [
{
object ( |
Felder | |
---|---|
messages[] |
Liste der Nachrichten. |
next |
Sie können ein Token als |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.readonly
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.