Method: projects.locations.brands.sessionRecords.list

Listet SessionRecords für eine bestimmte Marke auf.

HTTP-Anfrage

GET https://foodorderingaiagent.googleapis.com/v1beta/{parent=projects/*/locations/*/brands/*}/sessionRecords

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Die Marke, für die Bestellsitzungen aufgelistet werden sollen. Format: projects/{project}/locations/{location}/brands/{brand}

Suchparameter

Parameter
pageSize

integer

Optional. Die maximale Anzahl der zurückzugebenden Sitzungsdatensätze. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 Sitzungen zurückgegeben. Der Höchstwert liegt bei 1.000. Alle Werte darüber werden implizit in 1.000 umgewandelt.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen sessionRecords.list-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.
filter

string

Optional. Filterausdruck basierend auf AIP-160. Mit diesem Feld können Sitzungsdatensätze anhand verschiedener Attribute gefiltert werden.

Unterstützte Filterfelder:

  • session_id (String): Die ID der Sitzung. Operatoren: = Beispiel: session_id = "session-123"

  • storeId (String): Die ID des Geschäfts. Operatoren: =, != Beispiel: storeId = "store-123"

  • sessionStartTime (Zeitstempel): Die Startzeit der Sitzung. Für Zeitstempel ist ein String im RFC 3339-Format erforderlich (z.B. 2012-04-21T11:30:00-04:00). UTC-Offsets werden unterstützt. Operatoren: =, !=,

    , >=, <, <= Beispiel: sessionStartTime >= "2025-10-01T00:00:00Z"

  • outcomeLabel (String): Das endgültige Ergebnislabel der Sitzung. Operatoren: =, != Beispiel: outcomeLabel = "SUCCESS"

  • outcomeGroupLabel (String): Das Gruppenlabel für das Sitzungsergebnis. Operatoren: =, != Beispiel: outcomeGroupLabel = "SUCCESS"

  • predictedFailureCategory (String): Die vorhergesagte Fehlerkategorie für die Sitzung aus der Interventionsanalyse. Operatoren: =, != Beispiel: predictedFailureCategory = "Menu"

  • agent_utterances (String): Vom Agent gesprochener Text. Operator: : (Token-/Volltextsuche) Beispiel: agent_utterances:"anything else"

  • user_utterances (String): Vom Nutzer gesprochener Text. Operator: : (Token-/Volltextsuche) Beispiel: user_utterances:"burger"

Logische Operatoren:

Bedingungen können mit AND, OR und NOT kombiniert werden. Mit Klammern () können Ausdrücke gruppiert werden, um die Reihenfolge der Auswertung zu steuern. Beispiel: (user_utterances:"help" OR agent_utterances:"issue") AND storeId != "test-store" Beispiel: user_utterances:"order" AND sessionStartTime >= "2025-10-03T00:00:00Z"

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für [SessionRecordService.ListSessionRecords][].

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

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

object (SessionRecord)

Die Liste der Sitzungsdatensätze.
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.