Method: projects.sendInteraction

string

Obligatoire. Projet testé, indiqué par l'ID du projet Format: projects/{project}

{
  "query": string,
  "type": enum (InputType)
}

string

Contenu de l'entrée envoyée par l'utilisateur.

enum (InputType)

Type de l'entrée.

{
  "surface": enum (Surface),
  "location": {
    object (Location)
  },
  "locale": string,
  "timeZone": string
}

enum (Surface)

Surface utilisée pour interagir avec l'action.

object (Location)

Localisation de l'appareil (latitude, longitude et adresse formatée, par exemple).

string

Paramètres régionaux définis sur l'appareil. Ce format doit être conforme à la norme BCP 47: https://tools.ietf.org/html/bcp47. Exemples: en, en-US, es-419 (d'autres exemples sont disponibles sur la page https://tools.ietf.org/html/bcp47#appendix-A).

string

Fuseau horaire défini sur l'appareil. Ce format doit respecter la base de données des fuseaux horaires de l'IANA, par exemple "America/New_York": https://www.iana.org/time-zones.

{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string
}

object (LatLng)

Coordonnées géographiques. Nécessite l'autorisation [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].

string

Adresse à afficher, par exemple "1600 Amphitheatre Pkwy, Mountain View, CA 94043". Nécessite l'autorisation [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].

string

Code postal. Nécessite l'autorisation [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] ou [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

string

Ville. Nécessite l'autorisation [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] ou [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

{
  "latitude": number,
  "longitude": number
}

number

Latitude en degrés. Elle doit être comprise dans la plage [-90.0, +90.0].

number

Longitude en degrés. Elle doit être comprise dans la plage [-180.0, +180.0].

{
  "text": string,
  "speech": [
    string
  ],
  "canvas": {
    object (Canvas)
  },
  "actionsBuilderPrompt": {
    object (Prompt)
  }
}

string

Réponse vocale envoyée à l'utilisateur sous forme de chaîne simple.

string

Contenu vocal produit par l'action. Cela peut inclure des éléments de balisage tels que SSML.

object (Canvas)

Contenu d'Interactive Canvas.

object (Prompt)

État de l'invite à la fin de la conversation En savoir plus sur l'invite: https://developers.google.com/assistant/conversational/prompts

{
  "url": string,
  "data": [
    value
  ],
  "suppressMic": boolean,
  "enableFullScreen": boolean
}

string

URL de l'application Web de canevas interactif à charger. Si cette règle n'est pas configurée, l'URL du canevas actif actuel sera réutilisée.

value (Value format)

Facultatif. Données JSON à transmettre à la page Web de l'expérience immersive en tant qu'événement. Si le champ "remplacer" dans l'invite associée est défini sur "false", les valeurs de données définies dans cette invite Canvas seront ajoutées après les valeurs de données définies dans les invites Canvas précédentes.

boolean

Facultatif. Valeur par défaut : "false".

boolean

Si la valeur est true, l'application de canevas occupe la totalité de l'écran et n'a pas d'en-tête en haut. Un toast s'affiche également sur l'écran de chargement. Il comprend le nom à afficher de l'action, le nom du développeur et des instructions pour quitter l'action. Valeur par défaut : false.

{
  "append": boolean,
  "override": boolean,
  "firstSimple": {
    object (Simple)
  },
  "content": {
    object (Content)
  },
  "lastSimple": {
    object (Simple)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "link": {
    object (Link)
  },
  "canvas": {
    object (Canvas)
  }
}

boolean

Facultatif. Mode de fusion de ces messages avec les messages précédemment définis. "false" efface tous les messages définis précédemment (premier et dernier élément simple, contenu, lien et canevas de suggestions) et ajoute les messages définis dans cette invite. "true" ajoutera les messages définis dans cette requête à ceux définis dans les réponses précédentes. Définir ce champ sur "true" active également l'ajout à certains champs dans les invites simples, l'invite de suggestion et l'invite Canvas (qui fait partie de l'invite de contenu). Les messages de contenu et de lien seront toujours remplacés s'ils sont définis dans l'invite. La valeur par défaut est "false".

boolean

Facultatif. Mode de fusion de ces messages avec les messages précédemment définis. "true" efface tous les messages précédemment définis (premier et dernier élément simple, contenu, lien et canevas de suggestions) et ajoute les messages définis dans cette invite. "false" ajoute les messages définis dans cette invite à ceux définis dans les réponses précédentes. Si vous laissez ce champ sur "false", vous pouvez également ajouter certains champs dans les invites simples, les invites de suggestions et l'invite Canvas (qui fait partie de l'invite de contenu). Les messages de contenu et de lien sont toujours remplacés s'ils sont définis dans l'invite. La valeur par défaut est "false".

object (Simple)

Facultatif. Première réponse vocale et textuelle.

object (Content)

Facultatif. Contenus (par exemple, une carte, une liste ou un contenu multimédia) à présenter à l'utilisateur.

object (Simple)

Facultatif. Dernière réponse vocale et textuelle.

object (Suggestion)

Facultatif. Suggestions à présenter à l'utilisateur, qui apparaîtront toujours à la fin de la réponse. Si le champ "remplacer" est défini sur "false" dans la requête associée, les titres définis dans ce champ seront ajoutés à ceux définis dans les requêtes de suggestion précédemment définies, et les valeurs en double seront supprimées.

object (Link)

Facultatif. Un chip de suggestion supplémentaire qui peut rediriger vers l'application ou le site associés. Le chip s'affiche avec le titre "Ouvrir " (20 caractères au maximum).

object (Canvas)

Facultatif. Représente une réponse Interactive Canvas à envoyer à l'utilisateur.

{
  "speech": string,
  "text": string
}

string

Facultatif. Représente la voix à énoncer. Il peut s'agir d'un balisage SSML ou d'une synthèse vocale. Si le champ "remplacer" est défini sur "true" dans la requête associée, les voix définies dans ce champ remplacent celles de la requête simple précédente.

string

Texte facultatif à afficher dans la bulle de chat. Si ce champ n'est pas spécifié, le rendu du champ de saisie vocale ci-dessus sera utilisé à l'écran. Limité à 640 caractères. Si le champ "remplacer" de la requête associée est défini sur "true", le texte défini dans ce champ remplace le texte de l'invite simple précédente.

{

  // Union field content can be only one of the following:
  "card": {
    object (Card)
  },
  "image": {
    object (Image)
  },
  "table": {
    object (Table)
  },
  "media": {
    object (Media)
  },
  "canvas": {
    object (Canvas)
  },
  "collection": {
    object (Collection)
  },
  "list": {
    object (List)
  }
  // End of list of possible types for union field content.
}

object (Card)

Une carte basique

object (Image)

Image.

object (Table)

Fiche tableau.

object (Media)

Réponse indiquant un ensemble de contenus multimédias à lire.

object (Canvas)

Réponse à utiliser pour l'expérience de canevas interactif.

object (Collection)

Fiche présentant un ensemble d'options à sélectionner.

object (List)

Fiche présentant une liste d'options à sélectionner.

{
  "title": string,
  "subtitle": string,
  "text": string,
  "image": {
    object (Image)
  },
  "imageFill": enum (ImageFill),
  "button": {
    object (Link)
  }
}

string

Titre général de la fiche. Facultatif.

string

Facultatif.

string

Corps du texte de la fiche. Accepte un ensemble limité de syntaxes Markdown pour la mise en forme. Obligatoire, sauf si une image est présente.

object (Image)

Une hero image pour la fiche. La hauteur est fixée à 192 dp. Facultatif.

enum (ImageFill)

Façon dont l'arrière-plan de l'image sera rempli. Facultatif.

object (Link)

Bouton. Facultatif.

{
  "url": string,
  "alt": string,
  "height": integer,
  "width": integer
}

string

URL source de l'image. Les images peuvent être au format JPG, PNG et GIF (avec ou sans animation). Exemple : https://www.agentx.com/logo.png. Obligatoire.

string

Description textuelle de l'image à utiliser pour l'accessibilité, par exemple les lecteurs d'écran. Obligatoire.

integer

Hauteur de l'image en pixels. Facultatif.

integer

Largeur de l'image en pixels. Facultatif.

{
  "name": string,
  "open": {
    object (OpenUrl)
  }
}

string

Nom du lien

object (OpenUrl)

Que se passe-t-il lorsqu'un utilisateur ouvre le lien ?

{
  "url": string,
  "hint": enum (UrlHint)
}

string

Champ d'URL, qui peut correspondre à: - URL http/https pour ouvrir une page Web ou une application associée à une application

enum (UrlHint)

Indique une indication concernant le type d'URL.

{
  "title": string,
  "subtitle": string,
  "image": {
    object (Image)
  },
  "columns": [
    {
      object (TableColumn)
    }
  ],
  "rows": [
    {
      object (TableRow)
    }
  ],
  "button": {
    object (Link)
  }
}

string

Titre général du tableau. Facultatif, mais doit être défini si "sous-titre" est défini.

string

Sous-titre de la table. Facultatif.

object (Image)

Image associée au tableau. Facultatif.

object (TableColumn)

En-têtes et alignement des colonnes.

object (TableRow)

Données de ligne de la table. L'affichage des trois premières lignes est garanti, mais d'autres peuvent être coupées sur certaines surfaces. Effectuez un test avec le simulateur afin d'identifier les lignes qui seront affichées pour une surface donnée. Sur les surfaces compatibles avec la fonctionnalité WEB_browser, vous pouvez rediriger l'utilisateur vers une page Web contenant plus de données.

object (Link)

Bouton.

{
  "header": string,
  "align": enum (HorizontalAlignment)
}

string

Texte de l'en-tête de la colonne.

enum (HorizontalAlignment)

Alignement horizontal du contenu par rapport à la colonne. Si aucune valeur n'est spécifiée, le contenu sera aligné sur le bord avant.

{
  "cells": [
    {
      object (TableCell)
    }
  ],
  "divider": boolean
}

object (TableCell)

Cellules sur cette ligne. L'affichage des trois premières cellules est garanti, mais d'autres peuvent être coupées sur certaines surfaces. Effectuez un test avec le simulateur pour identifier les cellules qui seront affichées pour une surface donnée.

boolean

Indique si un séparateur doit être présent après chaque ligne.

{
  "text": string
}

string

Contenu textuel de la cellule.

{
  "mediaType": enum (MediaType),
  "startOffset": string,
  "optionalMediaControls": [
    enum (OptionalMediaControls)
  ],
  "mediaObjects": [
    {
      object (MediaObject)
    }
  ]
}

enum (MediaType)

Type de contenu.

string (Duration format)

Décalage de début du premier objet multimédia.

Durée en secondes avec neuf chiffres au maximum après la virgule. Se termine par "s". Example : "3.5s".

enum (OptionalMediaControls)

Types de commandes multimédias facultatifs compatibles avec cette session de réponse multimédia. Si cette règle est définie, la demande sera envoyée aux 3p lorsqu'un événement multimédia spécifique se produit. Si cette règle n'est pas configurée, 3p doit tout de même gérer deux types de contrôle par défaut : FINISHED (Terminé) et FAILED (ÉCHEC).

object (MediaObject)

Liste des objets Media

{
  "name": string,
  "description": string,
  "url": string,
  "image": {
    object (MediaImage)
  }
}

string

Nom de cet objet multimédia.

string

Description de cet objet multimédia.

string

URL pointant vers le contenu multimédia.

object (MediaImage)

Image à afficher avec la fiche multimédia.

{

  // Union field image can be only one of the following:
  "large": {
    object (Image)
  },
  "icon": {
    object (Image)
  }
  // End of list of possible types for union field image.
}

object (Image)

Une grande image, comme la couverture de l'album, etc.

object (Image)

Une petite icône d'image affichée à droite du titre Elle est redimensionnée au format 36 x 36 dp.

{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (CollectionItem)
    }
  ],
  "imageFill": enum (ImageFill)
}

string

Titre de la collection. Facultatif.

string

Sous-titre de la collection. Facultatif.

object (CollectionItem)

min: 2 max: 10

enum (ImageFill)

Mode de remplissage des arrière-plans des images des éléments de la collection. Facultatif.

{
  "key": string
}

string

Obligatoire. Clé NLU correspondant au nom de clé d'entrée dans le type associé.

{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (ListItem)
    }
  ]
}

string

Titre de la liste. Facultatif.

string

Sous-titre de la liste. Facultatif.

object (ListItem)

min: 2 max: 30

{
  "key": string
}

string

Obligatoire. Clé NLU correspondant au nom de clé d'entrée dans le type associé.

{
  "title": string
}

string

Obligatoire. Texte affiché dans le chip de suggestion. Lorsque l'utilisateur appuie dessus, ce texte est republié dans la conversation, comme si l'utilisateur l'avait saisi. Chaque titre doit être unique parmi les chips de suggestion. 25 caractères max.

{
  "actionsBuilderEvents": [
    {
      object (ExecutionEvent)
    }
  ]
}

object (ExecutionEvent)

Liste des événements avec des détails sur le traitement de la conversation tout au long des étapes du modèle d'interaction Actions Builder Renseigné pour les applications Actions Builder et SDK Actions uniquement.

{
  "eventTime": string,
  "executionState": {
    object (ExecutionState)
  },
  "status": {
    object (Status)
  },
  "warningMessages": [
    string
  ],

  // Union field EventData can be only one of the following:
  "userInput": {
    object (UserConversationInput)
  },
  "intentMatch": {
    object (IntentMatch)
  },
  "conditionsEvaluated": {
    object (ConditionsEvaluated)
  },
  "onSceneEnter": {
    object (OnSceneEnter)
  },
  "webhookRequest": {
    object (WebhookRequest)
  },
  "webhookResponse": {
    object (WebhookResponse)
  },
  "webhookInitiatedTransition": {
    object (WebhookInitiatedTransition)
  },
  "slotMatch": {
    object (SlotMatch)
  },
  "slotRequested": {
    object (SlotRequested)
  },
  "slotValidated": {
    object (SlotValidated)
  },
  "formFilled": {
    object (FormFilled)
  },
  "waitingUserInput": {
    object (WaitingForUserInput)
  },
  "endConversation": {
    object (EndConversation)
  }
  // End of list of possible types for union field EventData.
}

string (Timestamp format)

Code temporel du moment où l'événement s'est produit.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

object (ExecutionState)

État de l'exécution au cours de cet événement.

object (Status)

État résultant de l'étape d'exécution particulière.

string

Liste des avertissements générés lors de l'exécution de cet événement. Les avertissements sont des conseils destinés au développeur lors de la demande de conversation. Ces erreurs sont généralement non critiques et n'interrompent pas l'exécution de la requête. Par exemple, un avertissement peut être généré lorsque le webhook tente de remplacer un type personnalisé qui n'existe pas. Les erreurs sont signalées en tant que code d'état "Échec", mais des avertissements peuvent être présents même si l'état est "OK".

object (UserConversationInput)

Événement de gestion des entrées utilisateur.

object (IntentMatch)

Événement de correspondance d'intent.

object (ConditionsEvaluated)

Événement d'évaluation de l'état.

object (OnSceneEnter)

Événement d'exécution OnSceneEnter.

object (WebhookRequest)

Événement de distribution des requêtes de webhook.

object (WebhookResponse)

Événement de réception de réponse de webhook.

object (WebhookInitiatedTransition)

Événement de transition initié par le webhook.

object (SlotMatch)

Événement de correspondance d'espace publicitaire.

object (SlotRequested)

Événement qui demande un emplacement.

object (SlotValidated)

Événement de validation d'emplacement.

object (FormFilled)

Événement de remplissage de formulaire.

object (WaitingForUserInput)

Événement de type "En attente d'une saisie par l'utilisateur".

object (EndConversation)

Événement de fin de conversation

{
  "currentSceneId": string,
  "sessionStorage": {
    object
  },
  "slots": {
    object (Slots)
  },
  "promptQueue": [
    {
      object (Prompt)
    }
  ],
  "userStorage": {
    object
  },
  "householdStorage": {
    object
  }
}

string

ID de la scène active.

object (Struct format)

État de l'espace de stockage de la session: https://developers.google.com/assistant/conversational/storage-session

object (Slots)

État du remplissage des emplacements, le cas échéant: https://developers.google.com/assistant/conversational/scenes#slot_filling

object (Prompt)

File d'attente des invites: https://developers.google.com/assistant/conversational/prompts

object (Struct format)

État de l'espace de stockage utilisateur: https://developers.google.com/assistant/conversational/storage-user

object (Struct format)

État de l'espace de stockage de la maison: https://developers.google.com/assistant/conversational/storage-home

{
  "status": enum (SlotFillingStatus),
  "slots": {
    string: {
      object (Slot)
    },
    ...
  }
}

enum (SlotFillingStatus)

État actuel du remplissage d'emplacements.

map (key: string, value: object (Slot))

Emplacements associés à la scène actuelle.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

{
  "mode": enum (SlotMode),
  "status": enum (SlotStatus),
  "value": value,
  "updated": boolean,
  "prompt": {
    object (Prompt)
  }
}

enum (SlotMode)

Mode de l'emplacement (obligatoire ou facultatif). Peut être défini par le développeur.

enum (SlotStatus)

État de l'emplacement.

value (Value format)

Valeur de l'emplacement. La modification de cette valeur dans la réponse modifiera la valeur du remplissage d'emplacements.

boolean

Indique si la valeur de la position a été collectée lors du dernier virage. Ce champ est en lecture seule.

object (Prompt)

Facultatif. Cette invite est envoyée à l'utilisateur si nécessaire pour remplir un emplacement requis. Cette invite remplace celle définie dans la console. Ce champ n'est pas inclus dans la requête de webhook.

{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}

integer

Code d'état, qui doit être une valeur d'énumération de google.rpc.Code.

string

Message d'erreur destiné au développeur, qui doit être en anglais. Tout message d'erreur destiné aux utilisateurs doit être localisé et envoyé dans le champ google.rpc.Status.details, ou localisé par le client.

object

Liste de messages comportant les détails de l'erreur. Il existe un ensemble commun de types de message utilisable par les API.

Objet contenant des champs d'un type arbitraire. Un champ supplémentaire "@type" contient un URI identifiant le type. Exemple : { "id": 1234, "@type": "types.example.com/standard/id" }.

{
  "type": string,
  "originalQuery": string
}

string

Type d'entrée utilisateur. (par exemple, clavier, voix, commandes tactiles, etc.)

string

Texte d'origine saisi par l'utilisateur.

{
  "intentId": string,
  "intentParameters": {
    string: {
      object (IntentParameterValue)
    },
    ...
  },
  "handler": string,
  "nextSceneId": string
}

string

ID de l'intent ayant déclenché cette interaction.

map (key: string, value: object (IntentParameterValue))

Paramètres d'intent ayant déclenché cette interaction.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

string

Nom du gestionnaire associé à cette interaction.

string

Scène vers laquelle cette interaction mène.

{
  "failedConditions": [
    {
      object (Condition)
    }
  ],
  "successCondition": {
    object (Condition)
  }
}

object (Condition)

Liste des conditions évaluées comme "false".

object (Condition)

Première condition évaluée comme étant "true", le cas échéant.

{
  "expression": string,
  "handler": string,
  "nextSceneId": string
}

string

Expression spécifiée dans cette condition.

string

Nom du gestionnaire spécifié dans la condition évaluée.

string

Scène de destination spécifiée dans la condition évaluée.

{
  "handler": string
}

string

Nom du gestionnaire spécifié dans l'événement onSceneEnter.

{
  "requestJson": string
}

string

Charge utile de la requête de webhook.

{
  "responseJson": string
}

string

Charge utile de la réponse du webhook.

{
  "nextSceneId": string
}

string

ID de la scène vers laquelle la transition mène.

{
  "nluParameters": {
    string: {
      object (IntentParameterValue)
    },
    ...
  }
}

map (key: string, value: object (IntentParameterValue))

Paramètres extraits de l'entrée utilisateur par la NLU.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

{
  "slot": string,
  "prompt": {
    object (Prompt)
  }
}

string

Nom de l'espace demandé.

object (Prompt)

Invite d'emplacement.