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 mendasarinya. Properti akan selalu memiliki properti type, tetapi beberapa properti 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 ditetapkan ke "string", tetapi properti format akan ditetapkan ke "int64" untuk menunjukkan bahwa properti tersebut adalah bilangan bulat 64-bit.
Spesifikasi Skema JSON sudah menentukan kumpulan nilai
umum untuk properti format. Layanan Penemuan Google API mendukung beberapa
nilai ini, dan juga menentukan nilai lainnya. Daftar lengkap nilai type dan
format yang didukung oleh Layanan Penemuan Google API diringkas di bawah.
| Nilai jenis | Nilai format | Arti |
|---|---|---|
any |
|
Properti dapat memiliki jenis apa pun. Ditentukan oleh spesifikasi Skema JSON. |
any |
google.protobuf.Value |
Properti memiliki representasi JSON dari jenis google.protobuf.Value. |
array |
|
Array nilai JavaScript. Properti items menunjukkan skema untuk nilai array. Ditentukan oleh spesifikasi Skema JSON.
|
array |
google.protobuf.ListValue |
Properti ini memiliki representasi JSON dari jenis google.protobuf.ListValue. |
boolean |
|
Nilai boolean, bisa "true" atau "false". Ditentukan oleh spesifikasi Skema JSON. |
integer |
int32 |
Bilangan bulat 32-bit bertanda. Bilangan ini memiliki nilai minimum -2.147.483.648 dan nilai maksimum 2.147.483.647 (inklusif). |
integer |
uint32 |
Bilangan bulat 32-bit tanpa tanda. Bilangan 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. |
object |
google.protobuf.Struct |
Properti memiliki representasi JSON dari jenis google.protobuf.Struct. |
object |
google.protobuf.Any |
Properti memiliki representasi JSON dari jenis google.protobuf.Any. |
string |
|
String arbitrer. Ditentukan oleh spesifikasi Skema JSON. |
string |
byte |
String byte dengan padding berenkode base64, yang dienkode dengan URL dan alfabet aman bagi 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. Formatnya adalah 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. Formatnya adalah 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 yang 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 lower-camel. |
string |
int64 |
Bilangan bulat 64-bit bertanda. Nilai 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. Bilangan ini memiliki nilai minimum 0 dan nilai maksimum (2^64)-1 (inklusif). |