Jenis dan format

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