- JSON-Darstellung
- Status
- DateTime
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Datum
- TimeOfDay
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
JSON-Darstellung | |
---|---|
{ "name": string, "rawText": string, "textValue": string, "status": { object ( |
Felder | ||
---|---|---|
name |
Name des für die Eingabe angegebenen Arguments. |
|
rawText |
Der eingetippte oder gesprochene Rohtext, der den Wert für das Argument lieferte. |
|
textValue |
Wird angegeben, wenn das Abfragemuster den Typ |
|
status |
Wird angegeben, wenn bei der Berechnung des Arguments ein Fehler aufgetreten ist. Beispiel: Der integrierte Intent „actions.intent.PLACE“ kann einen Fehlerstatus zurückgeben, wenn der Nutzer die Berechtigung für den Zugriff auf den Gerätestandort verweigert hat. |
|
Union-Feld value . Eine der folgenden Angaben ist angegeben. Für value ist nur einer der folgenden Werte zulässig: |
||
intValue |
Wird angegeben, wenn das Abfragemuster einen $org.schema.type.Number-Typ enthält oder die erwartete Eingabe einen integrierten Intent hat: „assistant.intent.action.NUMBER“. |
|
floatValue |
Für integrierten Intent angegeben: „actions.intent.NUMBER“ |
|
boolValue |
Wird angegeben, wenn das Abfragemuster den Typ |
|
datetimeValue |
Angegeben für den integrierten Intent: |
|
placeValue |
Wird angegeben, wenn das Abfragemuster einen $org.schema.type.Location-Typ enthält oder die erwartete Eingabe einen integrierten Intent hat: „actions.intent.PLACE“. |
|
extension |
Erweiterung, deren Typ vom Argument abhängt. Wenn der Name des Arguments für den Intent Ein Objekt, das Felder eines beliebigen Typs enthält. Ein zusätzliches Feld |
|
structuredValue |
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 |
Der Statuscode, der idealerweise ein ENUM-Wert von |
message |
Eine an Entwickler gerichtete Fehlermeldung, die englischsprachig sein sollte. Jede Fehlermeldung an den Nutzer sollte lokalisiert und im Feld |
details[] |
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 |
Datum/Uhrzeit
Argumentwert für Datum und Uhrzeit, der aus der Nutzereingabe geparst wurde. Enthält keine Zeitzoneninformationen.
JSON-Darstellung | |
---|---|
{ "date": { object ( |
Felder | |
---|---|
date |
Datumswert |
time |
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 |
Jahr des Datums. Es muss zwischen 1 und 9999 liegen oder kann 0 sein, wenn ein Datum ohne Jahresangabe angegeben wird. |
month |
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 |
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 |
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 |
Minuten der Zeitangabe. Muss zwischen 0 und 59 liegen. |
seconds |
Sekunden der Zeitangabe. Muss normalerweise zwischen 0 und 59 liegen. Eine API kann den Wert 60 zulassen, wenn sie Schaltsekunden zulässt. |
nanos |
Sekundenbruchteile in Nanosekunden. Muss zwischen 0 und 999.999.999 liegen. |