Method: projects.locations.conversations.messages.list

Listet alle Nachrichten für eine bestimmte Unterhaltung auf.

HTTP-Anfrage

GET https://geminidataanalytics.googleapis.com/v1beta/{parent=projects/*/locations/*/conversations/*}/messages

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Pflichtangabe. Die Unterhaltung, unter der Nachrichten aufgeführt werden sollen. Format: projects/{project}/locations/{location}/conversations/{conversationId}

Abfrageparameter

Parameter
pageSize

integer

Optional. Angeforderte Seitengröße. Der Server gibt möglicherweise weniger Elemente als angefordert zurück. Die maximale Seitengröße beträgt 100. Alle größeren Werte werden in 100 umgewandelt. Wenn nichts angegeben ist, legt der Server 50 als geeigneten Standardwert fest.
pageToken

string

Optional. Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll.
filter

string

Optional. Filtert die Ergebnisse. Informationen zur Syntax finden Sie unter AIP-160.

Mit messages.list kann nach folgenden Kriterien gefiltert werden: * createTime (z. B. createTime > "2025-01-28T06:51:56-08:00") * updateTime

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort für das Auflisten von Chatnachrichten.

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "messages": [
    {
      object (StorageMessage)
    }
  ],
  "nextPageToken": string
}
Felder
messages[]

object (StorageMessage)

Die Liste der Chatnachrichten.
nextPageToken

string

Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie unter Authentication Overview.

StorageMessage

Eine gespeicherte Nachricht, die eine Nutzernachricht oder eine Systemnachricht enthält.

JSON-Darstellung 
{
  "messageId": string,
  "message": {
    object (Message)
  }
}
Felder
messageId

string

Der eindeutige Ressourcenname einer Chatnachricht.
message

object (Message)

Der Inhalt der Nachricht.