Argument

Rappresentazione 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.
}
Campi
name

string

nome dell'argomento fornito per l'input.

rawText

string

Il testo non elaborato, digitato o pronunciato, che ha fornito il valore per l'argomento.

textValue

string

Specificato quando il pattern di query include un tipo $org.schema.type.Text o l'input previsto ha un intent integrato: actions.intent.TEXT o actions.intent.OPTION. Tieni presente che, per l'intent OPTION, abbiamo impostato textValue come chiave di opzione e rawText sopra indicherà l'intervallo non elaborato nella query dell'utente.

status

object (Status)

Specificato quando si è verificato un errore durante il calcolo dell'argomento. Ad esempio, l'intent integrato "actions.intent.PLACE" può restituire uno stato di errore se l'utente ha negato l'autorizzazione ad accedere alla posizione del proprio dispositivo.

Campo unione value. È specificato uno dei seguenti valori. value può essere solo uno dei seguenti:
intValue

string (int64 format)

Viene specificato quando il pattern di query include un tipo $org.schema.type.Number o l'input previsto ha un intent integrato: "assistant.intent.action.NUMBER".

floatValue

number

Specificato per l'intent integrato: "actions.intent.NUMBER"

boolValue

boolean

Specificato quando il pattern di query include un tipo $org.schema.type.YesNo o l'input previsto ha un intent integrato: actions.intent.CONFIRMATION. NOTA: se il valore booleano non è presente, rappresenta false.

datetimeValue

object (DateTime)

Specificato per l'intent integrato: actions.intent.DATETIME.

placeValue

object (Location)

Viene specificato quando il pattern di query include un tipo $org.schema.type.Location o quando l'input previsto ha un intent integrato: "actions.intent.PLACE".

extension

object

Estensione il cui tipo dipende dall'argomento. Ad esempio, se il nome dell'argomento è SIGN_IN per l'intent actions.intent.SIGN_IN, questa estensione conterrà un valore SignInValue.

Un oggetto che contiene campi di tipo arbitrario. Un campo aggiuntivo "@type" contiene un URI che identifica il tipo. Esempio: { "id": 1234, "@type": "types.example.com/standard/id" }.

structuredValue

object (Struct format)

Specificato quando Google deve trasmettere il valore dei dati in formato JSON.

Stato

Il tipo Status definisce un modello di errore logico adatto a diversi ambienti di programmazione, tra cui API REST e API RPC. È utilizzato da gRPC. Ogni messaggio Status contiene tre dati: codice, messaggio di errore e dettagli dell'errore.

Per saperne di più su questo modello di errore e su come utilizzarlo, consulta la Guida alla progettazione dell'API.

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

integer

Il codice di stato, che deve essere un valore enum pari a google.rpc.Code.

message

string

Un messaggio di errore rivolto agli sviluppatori, che deve essere in inglese. Qualsiasi messaggio di errore rivolto agli utenti deve essere localizzato e inviato nel campo google.rpc.Status.details oppure deve essere localizzato dal client.

details[]

object

Un elenco di messaggi con i dettagli dell'errore. Le API possono utilizzare un insieme comune di tipi di messaggi.

Un oggetto che contiene campi di tipo arbitrario. Un campo aggiuntivo "@type" contiene un URI che identifica il tipo. Esempio: { "id": 1234, "@type": "types.example.com/standard/id" }.

DateTime

valore dell'argomento data e ora analizzato dall'input dell'utente. Non include informazioni sul fuso orario.

Rappresentazione JSON
{
  "date": {
    object (Date)
  },
  "time": {
    object (TimeOfDay)
  }
}
Campi
date

object (Date)

valore data

time

object (TimeOfDay)

valore temporale

Data

Rappresenta una data di calendario intera o parziale, ad esempio un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al Calendario gregoriano prolettico. Ciò può rappresentare:

  • Una data completa, con valori diversi da zero per anno, mese e giorno
  • Un valore mese e giorno, con zero anni, ad esempio un anniversario
  • Un anno a sé stante, con valori pari a zero per mese e giorno
  • Un valore di anno e mese, con un valore pari a zero, ad esempio una data di scadenza della carta di credito

I tipi correlati sono google.type.TimeOfDay e google.protobuf.Timestamp.

Rappresentazione JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer

Anno della data. Deve essere compreso tra 1 e 9999 o 0 se viene specificata una data senza anno.

month

integer

Mese dell'anno. Il valore deve essere compreso tra 1 e 12 o 0 se specifichi un anno senza mese e giorno.

day

integer

Giorno del mese. Deve essere compreso tra 1 e 31 e deve essere valido per l'anno e il mese oppure 0 se specifichi un anno a sé stante o un anno e un mese in cui il giorno non è significativo.

TimeOfDay

Rappresenta un'ora del giorno. La data e il fuso orario non sono significativi o sono specificati altrove. Un'API può scegliere di consentire i secondi intercalari. I tipi correlati sono google.type.Date e google.protobuf.Timestamp.

Rappresentazione JSON
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Campi
hours

integer

Le ore del giorno nel formato 24 ore. Deve essere compreso tra 0 e 23. Un'API può scegliere di consentire il valore "24:00:00" per scenari come l'orario di chiusura dell'attività.

minutes

integer

Minuti dell'ora del giorno. Il valore deve essere compreso tra 0 e 59.

seconds

integer

Secondi di minuti del tempo. Normalmente deve essere compreso tra 0 e 59. Un'API potrebbe consentire il valore 60 se consente i secondi intercalari.

nanos

integer

Frazioni di secondi in nanosecondi. Deve essere compreso tra 0 e 999.999.999.