Açık Bulut, istek ve yanıt yüklerini standart JSON olarak temsil eder.Standart JSON türleri metin, değerler, nesneler, düzenler, sayılar ve dizilerdir.Bazı tipler, aşağıdaki bölümlerde açıklanan belirli türde verileri temsil etmek için özel düşüncelere sahiptir.
Zaman damgası
RFC 3339'u kullanır, nesne üretilen çıkısı daima Z-normalize edilir ve 0, 3, 6 veya 9 ondalık sayı kullanır. "Z" dışındaki ofsetler de kabul edilir.
Örnek Zaman Damgası
{ "timestamp": "1972-01-01T10:00:20.021Z" }
Süre
Oluşturulan çıktı daima gerekli hassasiyete bağlı olarak 0, 3, 6 veya 9 ondalık sayı içerir, ardından "s" sözcüğü gelir.Kabul edilen kesirli sayılar (ayrıca hiçbiri) nano-saniye hassasiyetine uyduğu sürece ve "s" ekine ihtiyaç duyulduğu sürece kabul edilir.Menzil -315,576,000,000 ila 315,576,000,000 saniye arasında olmalıdır, dahil.
Örnek Süreler
{
"duration-9": "1.000340012s",
"duration-0": "1s"
}
Baytlar
Bayt verileri, aralıklarla birlikte standart base64 kodlaması kullanarak bir dize olarak kodlanır.Ya standart ya da URL'ye güvenli base64 kodlaması, yastıklarla veya yastıksız desteklenir.
Örnek Bytesi
{
"bytes": "YWJjMTIzIT8kKiYoKSctRbLx+"
}
Alan Maskesi
Bir Alan Maskesi, bir talepgönderirken hareket edecek alanları tanımlayan bir dizedir.Bir alan maskesi oluşturmak için, bir diziiçinde virgülle ayrılmış JSON alan adlarını belirtirsiniz.Örneğin, aşağıdaki kaynak verildiğinde:
Örnek JSON kaynağı
{
"foo": {
"a": "c",
"b": "d"
},
"bar": "x",
"baz": "y"
}
Sadece foo.b ve bar değerlerini güncelleştirmek için bir alan maskesi belirtmek istediyseniz, alan maskesi şöyle görünecektir: foo.b, bar
Açık Bulut'ta, bir alan maskesini destekleyen yöntemlerin güncellenmesinde updateMask adlı bir parametre vardır, bir alan maskesi bir değer olarak belirleyebilirsiniz.
Parasız
Genellikle bir fiyat tanımlamak için kullanılan Money türü, ISO 4217'de tanımlanan üç harfli bir para birimi koduna ve bir miktara sahiptir, ki bu da Decimal yazkullanır.Örneğin, şu şekilde $17.99 fiyatını temsil edebilirsiniz:
"myPrice": {
"currencyCode": "USD",
"quantity": {
"significand": 1799,
"exponent": -2
}
}
Yaratıcı Dükkan ürünleri -9'dan bir exponent gerektirir, bu yüzden aynı fiyat şu şekilde görünür:
"myPrice": {
"currencyCode": "USD",
"quantity": {
"significand": 17990000000,
"exponent": -9
}
}
Ondalık
Önemli sayılar ve bir üs ile bilimsel notasyona benzer bir formda ondalık bir sayıyı temsil eder, önemli sayılar ve bir üs.
Örnekler:
17
{"significand": 17, "exponent": 0} veya sadece {"significand": 17}
-0.005
{"significand": -5, "exponent": -3}
33.5 milyon (33,500,000)
{"significand": 335, "exponent": 5}
11/8 (1.375)
{"significand": 1375, "exponent": -3}
When exponent 0'dan büyük olduğunda, önemli sayılardan sonra takip eden sıfır sayısını temsil ederWhen exponent 0'dan az olduğunda, önemli sayıların ondalık noktadan sonra kaç tanesinin geldiğini temsil eder.When exponent 0 olduğunda, Decimal değeri significand değeridir.