Tür ve biçim özeti

Parametreler ve şemalardaki type ve format özellikleri, mülkün veri türünü belirlemek için kullanılabilir. type özelliği, JSON isteklerinde ve yanıtlarında gönderilen özelliğin türünü belirtir (JSON, küçük bir veri türü grubunu destekler, ayrıntılar için json.org'a bakın). format özelliği, temel tür hakkında ek bilgiler sağlar. Tesislerin her zaman type özelliği olabilir ancak bazılarının format mülkü de olabilir.

Örneğin, 64 bitlik bir tam sayı JSON'de temsil edilemez (çünkü JavaScript ve JSON desteği, 2^53'e kadar olan tam sayılardır). Bu nedenle, 64 bitlik bir tam sayı, JSON isteklerinde/yanıtlarında bir dize olarak temsil edilmelidir. Bu durumda, type özelliği"string"; ancak format özelliğinin 64 bit tam sayı olduğunu belirtmek için"quot;int64"`; olarak ayarlanır.

JSON Şeması spesifikasyonu, format özelliği için zaten bir ortak değer grubu tanımlar. Google API Discovery Hizmeti, bu değerlerden bazılarını destekler ve başkalarını da tanımlar. Google API'leri Discovery Hizmeti tarafından desteklenen type ve format değerlerinin tam listesi aşağıda özetlenmiştir.

Değer yaz Biçim değeri Anlamı
any Tesisin herhangi bir türü olabilir. JSON Şeması spesifikasyonu tarafından tanımlanmıştır.
array Değerlerden oluşan bir JavaScript dizisi. items özelliği, dizi değerlerinin şemasını belirtir. JSON Şeması spesifikasyonu tarafından tanımlanır.
boolean "true" veya &false; yanlış`.olan bir boole değeri. JSON Şeması spesifikasyonu tarafından tanımlanır.
integer int32 32 bit imzalı tam sayı. En az -2.147.483.648, maksimum 2.147.483.647 (dahil) bir değere sahiptir.
integer uint32 32 bitlik imzasız bir tam sayı. Minimum değeri 0, maksimum değeri ise 4.294.967.295 (dahil)dir.
number double Çift hassasiyetli 64 bit IEEE 754 kayan nokta.
number float Tek hassasiyetli 32 bit IEEE 754 kayan nokta.
object Bir JavaScript nesnesi. JSON Şeması spesifikasyonu tarafından tanımlanır.
string İsteğe bağlı bir dize. JSON Şeması spesifikasyonu tarafından tanımlanır.
string byte URL ve dosya adı açısından güvenli bir alfabeyle (bazen "web-safe" veya "base64url&quot" olarak da adlandırılır) dolgulu, base64 kodlu bir bayt dizesi. RFC4648 tarafından tanımlanıyor.
string date YYYY-AA-GG biçiminde bir RFC3339 tarihi. JSON Şeması spesifikasyonunda tanımlanır.
string date-time UTC saat diliminde bir RFC3339 zaman damgası. Bu, yyyy-AA-ggTSS:dd:ss.SSSZ biçimindedir. Milisaniye bölümü (".SSS") isteğe bağlıdır. JSON Şeması spesifikasyonunda tanımlanır.
string google-datetime UTC saat diliminde bir RFC3339 zaman damgası. Bu, yyyy-AA-ggTSS:dd:ss.SSSZ biçimindedir. Milisaniye bölümü (".SSS") isteğe bağlıdır.
string google-duration Bir dize son ek olarak (saniye olarak gösterilir) biter ve öncesinde nanosaniye, kesirli saniye olarak ifade edilir. Nokta işareti her zaman virgül olarak kullanılır, nokta olarak kullanılmaz.
string google-fieldmask Alan adlarının virgülle ayrıldığı bir dize. Alan adları, alt değnek adlandırma kurallarında temsil edilir.
string int64 64 bit imzalı tam sayı. En az -9.223.372.036.854.775.808, maksimum 9.223.372.036.854.775.807 (dahil) değere sahiptir.
string uint64 64 bit imzasız bir tam sayı. En düşük 0, maksimum (2^64)-1 (dahil) değerine sahiptir.