Ringkasan 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 yang mendasari. Properti akan selalu memiliki properti type, tetapi beberapa mungkin juga memiliki properti format.

Misalnya, bilangan bulat 64-bit tidak dapat ditampilkan dalam JSON (karena JavaScript dan JSON mendukung bilangan bulat hingga 2^53). Oleh karena itu, bilangan bulat 64-bit harus dinyatakan sebagai string dalam permintaan/respons JSON. Jadi, properti type akan disetel ke "string", tetapi properti format akan disetel ke "int64" untuk menunjukkan bahwa bilangan bulat tersebut adalah 64-bit.

Spesifikasi Skema JSON sudah menentukan kumpulan nilai umum untuk properti format. Layanan Penemuan Google API mendukung beberapa nilai ini, dan menentukan yang lainnya juga. Daftar lengkap nilai type dan format yang didukung oleh Layanan Discovery Google API dirangkum di bawah.

Nilai jenis Nilai format Arti
any Properti tersebut 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, baik "true" atau "false". Ditentukan oleh spesifikasi Skema JSON.
integer int32 Bilangan bulat 32-bit yang telah ditandai. Ini memiliki nilai minimum -2.147.483.648 dan nilai maksimum 2.147.483.647 (inklusif).
integer uint32 Bilangan bulat 32-bit yang tidak ditandatangani. Ini memiliki nilai minimum 0 dan nilai maksimum 4.294.967.295 (inklusif).
number double Titik mengambang IEEE 754 64-bit presisi ganda.
number float Titik mengambang 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 berenkode base64 dan 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. Ditetapkan dalam spesifikasi Skema JSON.
string date-time Stempel waktu RFC3339 dalam waktu UTC. Ini dalam format yyyy-MM-ddTHH:mm:ss.SSSZ. Bagian milidetik (".SSS") bersifat opsional. Ditetapkan dalam spesifikasi Skema JSON.
string google-datetime Stempel waktu RFC3339 dalam waktu UTC. Ini dalam format yyyy-MM-ddTHH:mm:ss.SSSZ. Bagian milidetik (".SSS") bersifat opsional.
string google-duration String berakhiran akhiran "s" (menunjukkan detik) dan didahului dengan jumlah detik, dengan nanodetik yang dinyatakan sebagai detik pecahan. Titik selalu digunakan sebagai titik desimal, bukan koma.
string google-fieldmask String dengan nama kolom yang dipisahkan oleh koma. Nama kolom diwakili dalam konvensi penamaan unta yang lebih rendah.
string int64 Bilangan bulat 64-bit yang telah ditandai. Nilai minimumnya adalah -9,223,372,036,854,775,808 serta nilai maksimum 9,223,372,036,854,775,807 (inklusif).
string uint64 Bilangan bulat 64-bit yang belum ditandatangani. Nilai minimumnya adalah 0 dan nilai maksimum (2^64)-1 (inklusif).