Method: projects.locations.brands.sessionRecords.list

Enumera los SessionRecords de una marca determinada.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Es la marca para la que se enumeran las sesiones de pedidos. Formato: projects/{project}/locations/{location}/brands/{brand}

Parámetros de consulta

Parámetros
pageSize

integer

Es opcional. Es la cantidad máxima de registros de sesión que se devolverán. El servicio puede mostrar menos que este valor. Si no se especifica, se devolverán, como máximo, 50 sesiones. El valor máximo es 1,000; valores superiores a 1,000 se convertirán en 1,000.
pageToken

string

Es opcional. Un token de página, recibido desde una llamada sessionRecords.list anterior. Proporciona esto para recuperar la página siguiente.
filter

string

Es opcional. Es una expresión de filtro basada en AIP-160. Este campo permite filtrar los registros de sesión según varios atributos.

Campos de filtro admitidos:

  • session_id (cadena): Es el ID de la sesión. Operadores: = Ejemplo: session_id = "session-123"

  • storeId (cadena): Es el ID de la tienda. Operadores: =, != Ejemplo: storeId = "store-123"

  • sessionStartTime (marca de tiempo): Es la hora de inicio de la sesión. Las marcas de tiempo esperan una cadena con formato RFC-3339 (p.ej., 2012-04-21T11:30:00-04:00). Se admiten los operadores de compensación de UTC: =, !=,

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

  • outcomeLabel (cadena): Es la etiqueta del resultado final de la sesión. Operadores: =, != Ejemplo: outcomeLabel = "SUCCESS"

  • outcomeGroupLabel (cadena): Es la etiqueta del grupo para el resultado de la sesión. Operadores: =, != Ejemplo: outcomeGroupLabel = "SUCCESS"

  • predictedFailureCategory (cadena): Es la categoría de falla prevista para la sesión según el análisis de intervención. Operadores: =, != Ejemplo: predictedFailureCategory = "Menu"

  • agent_utterances (cadena): Es el texto que dice el agente. Operador: : (TIENE token/Búsqueda de texto completo) Ejemplo: agent_utterances:"anything else"

  • user_utterances (cadena): Es el texto que dijo el usuario. Operador: : (TIENE token/Búsqueda de texto completo) Ejemplo: user_utterances:"burger"

Operadores lógicos:

Las condiciones se pueden combinar con AND, OR y NOT. Los paréntesis () se pueden usar para agrupar expresiones y controlar el orden de evaluación. Ejemplo: (user_utterances:"help" OR agent_utterances:"issue") AND storeId != "test-store" Ejemplo: user_utterances:"order" AND sessionStartTime >= "2025-10-03T00:00:00Z"

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es el mensaje de respuesta para [SessionRecordService.ListSessionRecords][].

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "sessionRecords": [
    {
      object (SessionRecord)
    }
  ],
  "nextPageToken": string
}
Campos
sessionRecords[]

object (SessionRecord)

Es la lista de registros de sesión.
nextPageToken

string

Un token, que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

Alcances de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.