Method: projects.locations.brands.sessionRecords.list

Elenca SessionRecord per un determinato brand.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il brand per cui elencare le sessioni di ordine. Formato: projects/{project}/locations/{location}/brands/{brand}

Parametri di query

Parametri
pageSize

integer

Facoltativo. Il numero massimo di record di sessione da restituire. Il servizio può restituire un numero inferiore a questo valore. Se non specificato, verranno restituite al massimo 50 sessioni. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000.
pageToken

string

Facoltativo. Un token di pagina, ricevuto da una chiamata sessionRecords.list precedente. Forniscilo per recuperare la pagina successiva.
filter

string

Facoltativo. Espressione di filtro basata su AIP-160. Questo campo consente di filtrare i record di sessione in base a vari attributi.

Campi di filtro supportati:

  • session_id (String): l'ID della sessione. Operatori: = Esempio: session_id = "session-123"

  • storeId (String): l'ID del datastore. Operatori: =, != Esempio: storeId = "store-123"

  • storeIds (String): un elenco di ID negozio separati da virgole. Operatori: =, !=, : Esempio: storeIds = "store-123,store-456"

  • sessionStartTime (Timestamp): l'ora di inizio della sessione. I timestamp prevedono una stringa formattata RFC-3339 (ad es. 2012-04-21T11:30:00-04:00). Sono supportati gli operatori di scarto da UTC: =, !=,

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

  • outcomeLabel (String): l'etichetta del risultato finale della sessione. Operatori: =, != Esempio: outcomeLabel = "SUCCESS"

  • outcomeGroupLabel (String): l'etichetta del gruppo per il risultato della sessione. Operatori: =, != Esempio: outcomeGroupLabel = "SUCCESS"

  • predictedFailureCategory (String): la categoria di errore prevista per la sessione dall'analisi dell'intervento. Operatori: =, != Esempio: predictedFailureCategory = "Menu"

  • agent_utterances (String): testo pronunciato dall'agente. Operatore: : (ricerca di token/testo completo) Esempio: agent_utterances:"anything else"

  • user_utterances (String): testo pronunciato dall'utente. Operatore: : (ricerca di token/testo completo) Esempio: user_utterances:"burger"

Operatori logici:

le condizioni possono essere combinate utilizzando AND, OR e NOT. È possibile utilizzare le parentesi () per raggruppare le espressioni e controllare l'ordine di valutazione. Esempio: (user_utterances:"help" OR agent_utterances:"issue") AND storeId != "test-store" Esempio: user_utterances:"order" AND sessionStartTime >= "2025-10-03T00:00:00Z"

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per [SessionRecordService.ListSessionRecords][].

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "sessionRecords": [
    {
      object (SessionRecord)
    }
  ],
  "nextPageToken": string
}
Campi
sessionRecords[]

object (SessionRecord)

L'elenco dei record di sessione.
nextPageToken

string

Un token che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la Authentication Overview.