Typ und Formatzusammenfassung
Mit den Properties type
und format
für Parameter und Schemas kann der Datentyp der Property ermittelt werden. Das Attribut type
gibt den Typ des Attributs an, wenn es in JSON-Anfragen und -Antworten gesendet wird (JSON unterstützt einen kleinen Satz von Datentypen, siehe json.org für weitere Informationen). Die Property format
bietet zusätzliche Informationen zum zugrunde liegenden Typ. Properties haben immer die Property type
, einige können aber auch die Property format
haben.
Eine 64-Bit-Ganzzahl kann beispielsweise nicht in JSON dargestellt werden, da JavaScript und JSON Ganzzahlen bis 2^53 unterstützen. Daher muss eine 64-Bit-Ganzzahl in JSON-Anfragen/-Antworten als String dargestellt werden. Die Property type
wird also auf "string" gesetzt, die Property format
wird aber auf "int64" gesetzt, um anzugeben, dass es sich um eine 64-Bit-Ganzzahl handelt.
In der JSON-Schemaspezifikation werden bereits einige allgemeine Werte für die Property format
definiert. Der Google APIs Discovery Service unterstützt einige dieser Werte und definiert auch andere. Eine vollständige Liste der vom Google APIs Discovery Service unterstützten Werte für type
und format
finden Sie unten.
Typwert | Formatwert | Bedeutung |
---|---|---|
any |
|
Die Property kann einen beliebigen Typ haben. Definiert durch die JSON-Schemaspezifikation. |
array |
|
Ein JavaScript-Array mit Werten. Das Attribut items gibt das Schema für die Arraywerte an. Definiert durch die JSON-Schemaspezifikation. |
boolean |
|
Ein boolescher Wert, entweder "true" oder "false" Definiert durch die JSON-Schemaspezifikation. |
integer |
int32 |
Eine 32-Bit-Ganzzahl mit Vorzeichen. Der Mindestwert beträgt -2.147.483.648 und der Maximalwert 2.147.483.647 (einschließlich). |
integer |
uint32 |
Eine vorzeichenlose 32-Bit-Ganzzahl. Er hat einen Mindestwert von 0 und einen Höchstwert von 4.294.967.295 (einschließlich). |
number |
double |
IEEE 754-Gleitkomma mit doppelter Genauigkeit. |
number |
float |
IEEE 754-Gleitkommazahl mit 32 Bit mit einfacher Genauigkeit. |
object |
|
Ein JavaScript-Objekt. Definiert durch die JSON-Schemaspezifikation. |
string |
|
Beliebiger String. Definiert durch die JSON-Schemaspezifikation. |
string |
byte |
Ein aufgefüllter, base64-codierter String aus Byte, der mit einem URL- und Dateinamen-sicheren Alphabet codiert ist. Dieser String wird manchmal auch als &webt-sicher oder "base64url" bezeichnet. Definiert durch RFC4648. |
string |
date |
Ein RFC3339-Datum im Format JJJJ-MM-TT. Definiert in der JSON-Schemaspezifikation. |
string |
date-time |
Ein RFC3339-Zeitstempel in UTC-Zeit. Er hat das Format jjjj-MM-ttTHH:mm:ss.SSSZ. Der Millisekundenteil (".SSS") ist optional. Definiert in der JSON-Schemaspezifikation. |
string |
google-datetime |
Ein RFC3339-Zeitstempel in UTC-Zeit. Er hat das Format jjjj-MM-ttTHH:mm:ss.SSSZ. Der Millisekundenteil (".SSS") ist optional. |
string |
google-duration |
Ein String endet mit dem Suffix „s"“, das für Sekunden steht, und ihm wird die Anzahl der Sekunden vorangestellt, wobei Nanosekunden als Sekundenbruchteile dargestellt sind. Der Punkt wird immer als Dezimalpunkt verwendet, kein Komma. |
string |
google-fieldmask |
Ein String, bei dem Feldnamen durch ein Komma getrennt sind. Feldnamen werden in Namenskonventionen mit niedrigeren Kamelen dargestellt. |
string |
int64 |
Eine 64-Bit-Ganzzahl mit Vorzeichen. Der Mindestwert ist -9.223.372.036.854.775.808, der Höchstwert 9.223.372.036.854.775.807 (einschließlich). |
string |
uint64 |
Eine 64-Bit-Ganzzahl ohne Vorzeichen. Er hat einen Mindestwert von 0 und einen Höchstwert von (2^64)-1 (einschließlich). |