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 dell'argomento.

textValue

string

Specificato quando il pattern di query include un tipo di $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, impostiamo textValue come chiave di opzione, mentre 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 suo dispositivo.

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

string (int64 format)

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 di $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)

Specificato quando il pattern di query include un tipo $org.schema.type.Location o un 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 trasferire 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 tipi di dati: codice, messaggio di errore e dettagli dell'errore.

Per ulteriori informazioni su questo modello di errore e su come utilizzarlo, consulta la Guida alla progettazione delle API.

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

integer

Il codice di stato, che deve essere un valore enum di 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 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 di 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 di anno, mese e giorno diversi da zero
  • Un valore di mese e giorno, con un anno pari a zero, ad esempio un anniversario
  • Un anno autonomo, con valori di giorni e mesi pari a zero
  • Il valore di un anno e un mese, con zero giorni, ad esempio la data di scadenza di una 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 di data. Il valore deve essere compreso tra 1 e 9999 oppure 0 se si specifica una data senza anno.

month

integer

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

day

integer

Giorno del mese. Deve essere compreso tra 1 e 31 ed essere valido per l'anno e il mese oppure 0 se specifichi un anno da solo 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. Il valore 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 di un'attività.

minutes

integer

Minuti di 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. Il valore deve essere compreso tra 0 e 999.999.999.