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.

Catatan: Library klien yang kami buat secara otomatis dari dokumen penemuan API terkadang menggunakan jenis idiom bahasa untuk jenis dan format tersebut. Misalnya: Bilangan bulat 64-bit direpresentasikan sebagai jenis string dalam permintaan dan respons JSON, tetapi library klien Java yang dihasilkan menggunakan jenis long Java.

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