Argument

Représentation JSON
{
  "name": string,
  "rawText": string,
  "textValue": string,
  "status": {
    object (Status)
  },

  // Union field value can be only one of the following:
  "intValue": string,
  "floatValue": number,
  "boolValue": boolean,
  "datetimeValue": {
    object (DateTime)
  },
  "placeValue": {
    object (Location)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "structuredValue": {
    object
  }
  // End of list of possible types for union field value.
}
Champs
name

string

nom de l'argument fourni pour l'entrée.

rawText

string

Texte brut, typé ou prononcé, fournissant la valeur de l'argument.

textValue

string

Spécifié lorsque le schéma de requête inclut un type $org.schema.type.Text ou que l'entrée attendue comporte un intent intégré: actions.intent.TEXT ou actions.intent.OPTION. Notez que pour l'intent OPTION, nous définissons textValue comme clé d'option. rawText ci-dessus indique le délai brut dans la requête de l'utilisateur.

status

object (Status)

Spécifié lorsqu'une erreur s'est produite lors du calcul de l'argument. Par exemple, l'intent intégré "actions.intent.PLACE" peut renvoyer un état d'erreur si l'utilisateur a refusé l'autorisation d'accéder à la position de son appareil.

Champ d'union value. L'un des éléments suivants est spécifié. value ne peut être qu'un des éléments suivants :
intValue

string (int64 format)

Spécifié lorsque le schéma de requête inclut un type $org.schema.type.Number ou que l'entrée attendue comporte un intent intégré: "assistant.intent.action.NUMBER".

floatValue

number

Spécifiée pour l'intent intégré: "actions.intent.NUMBER"

boolValue

boolean

Spécifié lorsque le schéma de requête inclut un type $org.schema.type.YesNo ou que l'entrée attendue comporte un intent intégré: actions.intent.CONFIRMATION. REMARQUE: Si la valeur booléenne est manquante, elle représente false.

datetimeValue

object (DateTime)

Spécifiée pour l'intent intégré: actions.intent.DATETIME.

placeValue

object (Location)

Spécifié lorsque le schéma de requête inclut un type $org.schema.type.Location ou une entrée attendue ayant un intent intégré: "actions.intent.PLACE".

extension

object

Extension dont le type dépend de l'argument. Par exemple, si le nom de l'argument est SIGN_IN pour l'intent actions.intent.SIGN_IN, cette extension contiendra une valeur SignInValue.

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" }.

structuredValue

object (Struct format)

Spécifié lorsque Google doit transmettre une valeur de données au format JSON.

État

Le type Status définit un modèle d'erreur logique adapté aux différents environnements de programmation, y compris les API REST et RPC. Il est utilisé par le protocole gRPC. Chaque message Status contient trois éléments de données : un code d'erreur, un message d'erreur et les détails de l'erreur.

Pour en savoir plus sur ce modèle d'erreur et sur son utilisation, consultez le Guide de conception d'API.

Représentation JSON
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Champs
code

integer

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

message

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.

details[]

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" }.

DateTime

valeur de l'argument date et heure analysée à partir de l'entrée utilisateur. N'inclut pas les informations sur le fuseau horaire.

Représentation JSON
{
  "date": {
    object (Date)
  },
  "time": {
    object (TimeOfDay)
  }
}
Champs
date

object (Date)

valeur de date

time

object (TimeOfDay)

valeur temporelle

Date

Représente une date du calendrier entière ou partielle, par exemple un anniversaire. L'heure de la journée et le fuseau horaire sont spécifiés ailleurs, ou ne sont pas significatifs. La date est liée au calendrier grégorien proleptique. Elle peut être représentée par :

  • une date complète, avec des valeurs non nulles pour l'année, le mois et le jour ;
  • une valeur pour le mois et le jour, avec une année nulle, par exemple l'anniversaire d'un événement ;
  • une année seule, avec un mois et un jour nuls ;
  • une année et un mois, avec un jour nul, par exemple une date d'expiration de carte de crédit.

Les types associés sont google.type.TimeOfDay et google.protobuf.Timestamp.

Représentation JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Champs
year

integer

Année de la date. Elle doit être comprise entre 1 et 9999, ou égale à 0 si vous spécifiez une date sans année.

month

integer

Mois de l'année. Il doit être compris entre 1 et 12, ou égal à 0 si vous spécifiez une année sans mois ni jour.

day

integer

Jour du mois. Il doit être compris entre 1 et 31, et valide pour l'année et le mois, ou égal à 0 si vous spécifiez une année seule, ou une année et un mois où le jour n'est pas significatif.

TimeOfDay

Représente une heure de la journée. La date et le fuseau horaire sont spécifiés ailleurs, ou ne sont pas significatifs. Une API peut choisir d'autoriser des secondes intercalaires. Les types associés sont google.type.Date et google.protobuf.Timestamp.

Représentation JSON
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Champs
hours

integer

Heure de la journée au format 24 heures. Elle doit être comprise entre 0 à 23. Une API peut choisir d'autoriser la valeur "24:00:00" pour des cas tels que l'heure de fermeture des bureaux.

minutes

integer

Minutes de l'heure de la journée. Elles doivent être comprises entre 0 à 59.

seconds

integer

Secondes de l'heure de la journée. Elles doivent normalement être comprises entre 0 et 59. Une API peut autoriser la valeur 60 si elle autorise les secondes intercalaires.

nanos

integer

Fractions de secondes en nanosecondes. La valeur doit être comprise entre 0 et 999 999 999.