Method: projects.locations.brands.sessionRecords.list

Liste les SessionRecords d'une marque donnée.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Marque pour laquelle lister les sessions de commande. Format: projects/{project}/locations/{location}/brands/{brand}

Paramètres de requête

Paramètres
pageSize

integer

Facultatif. Nombre maximal d'enregistrements de session à afficher. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 sessions au maximum sont renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.
pageToken

string

Facultatif. Jeton de page reçu d'un appel sessionRecords.list précédent. Fournissez-le pour récupérer la page suivante.
filter

string

Facultatif. Expression de filtre basée sur AIP-160. Ce champ permet de filtrer les enregistrements de session en fonction de différents attributs.

Champs de filtre compatibles :

  • session_id (chaîne) : ID de la session. Opérateurs : = Exemple : session_id = "session-123"

  • storeId (chaîne) : ID du magasin. Opérateurs : =, != Exemple : storeId = "store-123"

  • sessionStartTime (code temporel) : heure de début de la session. Les codes temporels attendent une chaîne au format RFC-3339 (par exemple, 2012-04-21T11:30:00-04:00). Les décalages UTC sont acceptés. Opérateurs : =, !=,

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

  • outcomeLabel (chaîne) : libellé final du résultat de la session. Opérateurs : =, != Exemple : outcomeLabel = "SUCCESS"

  • outcomeGroupLabel (chaîne) : libellé de groupe pour le résultat de la session. Opérateurs : =, != Exemple : outcomeGroupLabel = "SUCCESS"

  • predictedFailureCategory (chaîne) : catégorie d'échec prédite pour la session à partir de l'analyse d'intervention. Opérateurs : =, != Exemple : predictedFailureCategory = "Menu"

  • agent_utterances (chaîne) : texte prononcé par l'agent. Opérateur : : (contient le jeton/recherche en texte intégral) Exemple : agent_utterances:"anything else"

  • user_utterances (chaîne) : texte prononcé par l'utilisateur. Opérateur : : (contient le jeton/recherche en texte intégral) Exemple : user_utterances:"burger"

Opérateurs logiques :

Les conditions peuvent être combinées à l'aide de AND, OR et NOT. Les parenthèses () peuvent être utilisées pour regrouper des expressions afin de contrôler l'ordre d'évaluation. Exemple : (user_utterances:"help" OR agent_utterances:"issue") AND storeId != "test-store" Exemple : user_utterances:"order" AND sessionStartTime >= "2025-10-03T00:00:00Z"

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Message de réponse pour [SessionRecordService.ListSessionRecords][].

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "sessionRecords": [
    {
      object (SessionRecord)
    }
  ],
  "nextPageToken": string
}
Champs
sessionRecords[]

object (SessionRecord)

Liste des enregistrements de session.
nextPageToken

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.