Properti type
dan format
pada parameter dan skema dapat digunakan
untuk menentukan jenis data properti. Properti type
menunjukkan jenis properti saat dikirim dalam permintaan dan respons JSON (JSON mendukung sekumpulan kecil jenis data, lihat json.org untuk mengetahui detailnya). Properti format
memberikan informasi tambahan tentang jenis pokok. Properti akan selalu memiliki
properti type
, tetapi beberapa mungkin juga memiliki properti format
.
Misalnya, bilangan bulat 64-bit tidak dapat direpresentasikan dalam JSON (karena JavaScript dan JSON mendukung bilangan bulat hingga 2^53). Oleh karena itu, bilangan bulat 64-bit harus direpresentasikan sebagai string dalam permintaan/respons JSON. Jadi, properti type
akan disetel ke "string", tetapi properti
format
akan disetel ke "int64" untuk menunjukkan bahwa properti tersebut merupakan bilangan bulat 64-bit.
Spesifikasi Skema JSON sudah menentukan kumpulan nilai umum untuk properti format
. Layanan Penemuan Google API mendukung sebagian nilai ini, dan juga menentukan nilai lainnya. Daftar lengkap nilai type
dan
format
yang didukung oleh Google API Discovery Service dirangkum di bawah ini.
Nilai jenis | Nilai format | Arti |
---|---|---|
any |
|
Properti dapat memiliki jenis apa pun. Ditentukan oleh spesifikasi Skema JSON. |
array |
|
Array nilai JavaScript. Properti items menunjukkan skema untuk nilai array. Ditentukan oleh spesifikasi Skema JSON.
|
boolean |
|
Nilai boolean, bisa "true" atau "false". Ditentukan oleh spesifikasi Skema JSON. |
integer |
int32 |
Bilangan bulat 32-bit bertanda. Ini memiliki nilai minimum -2.147.483.648 dan nilai maksimum 2.147.483.647 (inklusif). |
integer |
uint32 |
Bilangan bulat 32-bit tanpa tanda. Ini memiliki nilai minimum 0 dan nilai maksimum 4.294.967.295 (inklusif). |
number |
double |
Floating point IEEE 754 64-bit presisi ganda. |
number |
float |
Floating point IEEE 754 32-bit presisi tunggal. |
object |
|
Objek JavaScript. Ditentukan oleh spesifikasi Skema JSON. |
string |
|
String arbitrer. Ditentukan oleh spesifikasi Skema JSON. |
string |
byte |
String byte dengan padding berenkode base64, yang dienkode dengan URL dan alfabet aman untuk nama file (terkadang disebut sebagai "web-safe" atau "base64url"). Ditentukan oleh RFC4648. |
string |
date |
Tanggal RFC3339 dalam format YYYY-MM-DD. Ditentukan dalam spesifikasi Skema JSON. |
string |
date-time |
Stempel waktu RFC3339 dalam waktu UTC. Dalam format yyyy-MM-ddTHH:mm:ss.SSSZ. Bagian milidetik (".SSS") bersifat opsional. Ditentukan dalam spesifikasi Skema JSON. |
string |
google-datetime |
Stempel waktu RFC3339 dalam waktu UTC. Dalam format yyyy-MM-ddTHH:mm:ss.SSSZ. Bagian milidetik (".SSS") bersifat opsional. |
string |
google-duration |
String diakhiri dengan akhiran "s" (menunjukkan detik) dan didahului dengan jumlah detik, dengan nanodetik dinyatakan sebagai detik pecahan. Titik selalu digunakan sebagai titik desimal, bukan koma. |
string |
google-fieldmask |
String dengan nama kolom yang dipisahkan dengan koma. Nama kolom direpresentasikan dalam konvensi penamaan camel yang lebih rendah. |
string |
int64 |
Bilangan bulat 64-bit bertanda. Ini memiliki nilai minimum -9.223.372.036.854.775.808 dan nilai maksimum 9.223.372.036.854.775.807 (inklusif). |
string |
uint64 |
Bilangan bulat 64-bit tanpa tanda. Ini memiliki nilai minimum 0 dan nilai maksimum (2^64)-1 (inklusif). |