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).