Listet Nachrichten in einem Gruppenbereich auf, in dem der Anrufer Mitglied ist, einschließlich Nachrichten von blockierten Mitgliedern und Gruppenbereichen. 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 der zurückgegebenen Nachrichten. Der Dienst gibt möglicherweise weniger Nachrichten als dieser Wert zurück. Wenn keine Vorgabe erfolgt, werden höchstens 25 zurückgegeben. Der Maximalwert beträgt 1.000. Wenn Sie einen Wert über 1.000 verwenden, wird er automatisch in „1.000“ geändert. Negative Werte geben den Fehler |
pageToken |
Optional, wenn mit einer vorherigen Abfrage fortgefahren wird. Ein von einem vorherigen Listenaufruf empfangenes Seitentoken. Geben Sie diesen Parameter an, um die nachfolgende Seite abzurufen. Beim Paginieren sollten alle anderen angegebenen Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Die Übergabe verschiedener Werte an die anderen Parameter kann zu unerwarteten Ergebnissen führen. |
filter |
Ein Abfragefilter. Sie können Nachrichten nach Datum ( Um Nachrichten nach dem Erstellungsdatum zu filtern, geben Sie die Wenn Sie nach Thread filtern möchten, geben Sie die Verwenden Sie den Operator Die folgenden Abfragen sind beispielsweise gültig:
Ungültige Abfragen werden vom Server mit dem Fehler |
orderBy |
Optional, wenn mit einer vorherigen Abfrage fortgefahren wird. Die Reihenfolge der Nachrichtenliste. Geben Sie einen Wert an, der nach einem Sortiervorgang sortiert werden soll. Gültige Werte für Sortiervorgänge sind:
Die Standardsortierung ist |
showDeleted |
Gibt an, ob gelöschte Nachrichten einbezogen werden sollen. Zu den gelöschten Nachrichten gehören der Zeitpunkt der Löschung und Metadaten zum Löschen. Der Nachrichteninhalt ist jedoch nicht mehr 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.