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