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 ohne Nachrichten auflisten, ist die Antwort ein leeres Objekt. Wenn Sie eine REST/HTTP-Schnittstelle verwenden, 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 | |
---|---|
pageSize |
Die maximale Anzahl zurückgegebener Nachrichten. Der Dienst gibt möglicherweise weniger Nachrichten als dieser Wert zurück. Wenn keine Angabe gemacht wird, werden höchstens 25 zurückgegeben. Der Höchstwert beträgt 1.000. Wenn Sie einen höheren Wert als 1.000 verwenden, wird er automatisch in 1.000 geändert. Bei negativen Werten wird der Fehler |
pageToken |
Optional, wenn die Pausierung von einer vorherigen Abfrage aufgehoben 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. Die Übergabe unterschiedlicher Werte an die anderen Parameter kann zu unerwarteten Ergebnissen führen. |
filter |
Einen Abfragefilter. Du kannst Nachrichten nach Datum ( Wenn Sie Nachrichten nach dem Erstellungsdatum filtern möchten, geben Sie Geben Sie Verwenden Sie in Ihrer Abfrage den Operator Die folgenden Abfragen sind beispielsweise gültig:
Ungültige Anfragen werden vom Server mit dem Fehler |
orderBy |
Optional, wenn die Pausierung von einer vorherigen Abfrage aufgehoben wird. Die Reihenfolge der Nachrichtenliste. Geben Sie einen Wert für die Sortierung über einen Sortiervorgang an. Gültige Werte für Sortiervorgänge sind:
Die Standardsortierung ist |
showDeleted |
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. |
nextPageToken |
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.