Argument

JSON-Darstellung
{
  "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.
}
Felder
name

string

Name des Arguments, das für die Eingabe bereitgestellt wird.

rawText

string

Der reine Text, ob eingegeben oder gesprochen, der den Wert für das Argument lieferte.

textValue

string

Wird angegeben, wenn das Abfragemuster den Typ $org.schema.type.Text enthält oder eine erwartete Eingabe einen integrierten Intent hat: actions.intent.TEXT oder actions.intent.OPTION. Für den Intent OPTION legen wir textValue als Optionsschlüssel fest. Mit dem rawText oben wird der Roh-Span in der Nutzerabfrage angegeben.

status

object (Status)

Wird angegeben, wenn bei der Berechnung des Arguments ein Fehler aufgetreten ist. Der integrierte Intent „actions.intent.PLACE“ kann beispielsweise einen Fehlerstatus zurückgeben, wenn der Nutzer den Zugriff auf seinen Gerätestandort verweigert hat.

Union-Feld value. Eine der folgenden Optionen ist angegeben. Für value ist nur einer der folgenden Werte zulässig:
intValue

string (int64 format)

Wird angegeben, wenn das Abfragemuster einen $org.schema.type.Number-Typ enthält oder eine erwartete Eingabe einen integrierten Intent hat: "assistant.intent.action.NUMBER".

floatValue

number

Angegeben für integrierten Intent: "actions.intent.NUMBER"

boolValue

boolean

Wird angegeben, wenn das Abfragemuster den Typ $org.schema.type.YesNo enthält oder eine erwartete Eingabe einen integrierten Intent hat: actions.intent.CONFIRMATION. HINWEIS: Wenn der boolesche Wert fehlt, stellt er false dar.

datetimeValue

object (DateTime)

Angegeben für den integrierten Intent: actions.intent.DATETIME.

placeValue

object (Location)

Wird angegeben, wenn das Abfragemuster einen $org.schema.type.Location-Typ enthält oder eine erwartete Eingabe einen integrierten Intent hat: "actions.intent.PLACE".

extension

object

Erweiterung, deren Typ vom Argument abhängt. Wenn der Argumentname für den Intent actions.intent.SIGN_IN beispielsweise SIGN_IN lautet, enthält die Erweiterung den Wert SignInValue.

Ein Objekt mit Feldern eines beliebigen Typs. Ein zusätzliches Feld "@type" enthält einen URI zur Identifizierung des Typs. Beispiel: { "id": 1234, "@type": "types.example.com/standard/id" }.

structuredValue

object (Struct format)

Wird angegeben, wenn Google einen Datenwert im JSON-Format übergeben muss.

Status

Mit dem Typ Status wird ein logisches Fehlermodell definiert, das für verschiedene Programmierumgebungen wie REST APIs und RPC APIs geeignet ist. Dieses Modell wird von gRPC verwendet. Jede Status-Meldung enthält die folgenden drei Datenelemente: Fehlercode, Fehlermeldung und Fehlerdetails.

Weitere Informationen zu diesem Fehlermodell und zur Arbeit damit finden Sie in der API-Designanleitung.

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

integer

Der Statuscode, der idealerweise ein ENUM-Wert von google.rpc.Code ist.

message

string

Eine an Entwickler gerichtete Fehlermeldung, die englischsprachig sein sollte. Jede Fehlermeldung an den Nutzer sollte lokalisiert und im Feld google.rpc.Status.details gesendet werden. Sie kann auch clientseitig lokalisiert werden.

details[]

object

Eine Auflistung aller Meldungen, die die Fehlerdetails enthalten. Es gibt einen gemeinsamen Satz von Nachrichtentypen, die APIs verwenden können.

Ein Objekt, das Felder eines beliebigen Typs enthält. Ein zusätzliches Feld "@type" enthält einen URI zur Identifizierung des Typs. Beispiel: { "id": 1234, "@type": "types.example.com/standard/id" }.

DateTime

Argumentwert für Datum und Uhrzeit, der aus der Nutzereingabe geparst wurde. Zeitzoneninformationen sind nicht enthalten.

JSON-Darstellung
{
  "date": {
    object (Date)
  },
  "time": {
    object (TimeOfDay)
  }
}
Felder
date

object (Date)

Datumswert

time

object (TimeOfDay)

Zeitwert

Datum

Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Die Uhrzeit und die Zeitzone werden entweder an einer anderen Stelle angegeben oder sind nicht relevant. Das Datum wird relativ zum proleptischen gregorianischen Kalender angegeben. Das kann Folgendes darstellen:

  • Ein ganzes Datum mit Werten für Jahr, Monat und Tag, die nicht 0 sind
  • Einen Monats- und Tageswert mit einem Jahr von 0, z. B. ein Jahrestag
  • Ein Jahr für sich, mit Werten von 0 für Monat und Tag
  • Einen Wert für Jahr und Monat mit einem Tag 0, z. B. ein Ablaufdatum der Kreditkarte

Vergleichbare Typen sind google.type.TimeOfDay und google.protobuf.Timestamp.

JSON-Darstellung
{
  "year": integer,
  "month": integer,
  "day": integer
}
Felder
year

integer

Jahr des Datums. Es muss zwischen 1 und 9999 liegen oder kann 0 sein, wenn ein Datum ohne Jahresangabe angegeben wird.

month

integer

Monat des Jahres. Die Angabe muss zwischen 1 und 12 liegen. Sie kann auch 0 sein, wenn ein Jahr ohne Monat und Tag angegeben wird.

day

integer

Tag des Monats. Die Angabe muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Sie kann auch 0 sein, wenn das Jahr bzw. der Monat angegeben wird, der Tag selbst jedoch nicht von Belang ist.

TimeOfDay

Stellt eine Tageszeit dar. Das Datum und die Zeitzone sind entweder nicht relevant oder werden an anderer Stelle angegeben. Eine API kann Schaltsekunden zulassen. Vergleichbare Typen sind google.type.Date und google.protobuf.Timestamp.

JSON-Darstellung
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Felder
hours

integer

Stunden im 24-Stunden-Format. Sollte zwischen 0 und 23 liegen. Eine API kann den Wert "24:00:00" für Szenarien wie Geschäftsschlusszeit zulassen.

minutes

integer

Minuten der Zeitangabe. Muss zwischen 0 und 59 liegen.

seconds

integer

Sekunden der Zeitangabe. Muss normalerweise zwischen 0 und 59 liegen. Eine API kann den Wert 60 zulassen, wenn sie Schaltsekunden zulässt.

nanos

integer

Sekundenbruchteile in Nanosekunden. Muss zwischen 0 und 999.999.999 liegen.