Türler

*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

Open Cloud, istek ve yanıt yüklerini standart JSON olarak temsil eder. Standart JSON türleri metin, değerler, nesneler, diziler, sayılar ve dizelerdir. Bazı türler, belirli veri türlerini temsil etmek için özel dikkate alınması gereken durumlar içerir ve bunlar aşağıdaki bölümlerde açıklanmaktadır.

Zaman Damgası

RFC 3339 kullanır, burada üretilen çıktı her zaman Z-normalize edilir ve 0, 3, 6 veya 9 ondalık basamak kullanır. "Z" dışındaki offsetler de kabul edilir.

Örnek Zaman Damgası
{ "timestamp": "1972-01-01T10:00:20.021Z" }

Süre

Üretilen çıktı her zaman gereken hassasiyete bağlı olarak 0, 3, 6 veya 9 ondalık basamak içerir, ardından "s" eki gelir. Kabul edilen herhangi bir ondalık basamak (hiçbiri de dahil) nanosecond hassasiyetine uyduğu sürece geçerlidir ve "s" eki gereklidir. Aralık -315,576,000,000 ile 315,576,000,000 saniye arasındadır, dahil.

Örnek Süreler
{
  "duration-9": "1.000340012s",
  "duration-0": "1s"
}

Bayt

Bayt verileri, standart base64 şifrelemesi ile string olarak kodlanmış ve doldurmalara sahip olarak temsil edilir. Ya standart ya da URL güvende base64 kodlaması, doldurmalarla veya doldurmalar olmadan desteklenir.

Örnek Bayt
{
  "bytes": "YWJjMTIzIT8kKiYoKSctRbLx+"
}

Alan Maskesi

Bir Alan Maskesi, bir istekte bulunurken işlem yapacak alanları tanımlayan bir string'dir. Bir alan maskesi oluşturmak için, bir string içinde virgülle ayrılmış JSON alan adlarını belirtirsiniz. Örneğin, aşağıdaki durumda:

Örnek JSON
{
  "foo": {
    "a": "c",
    "b": "d"
  },
  "bar": "x",
  "baz": "y"
}

Sadece foo.b ve bar değerlerini güncellemek için bir alan maske belirtmek isterseniz, alan maskesi şöyle görünür: foo.b, bar

Open Cloud'da, bir alan maskesini destekleyen güncelleme yöntemleri, bir alan maskesini değer olarak belirtebileceğiniz updateMask adında bir parametreye sahiptir.

Para

Genel olarak bir fiyat tanımlamak için kullanılan Para türü, üç harfli bir para birimi koduna (ISO 4217'de tanımlandığı gibi) ve bir miktara sahiptir; bu miktar Decimal türünü kullanır. Örneğin, 17.99$'lık bir fiyat şu şekilde temsil edilebilir:


"myPrice": {
  "currencyCode": "USD",
  "quantity": {
    "significand": 1799,
    "exponent": -2
  }
}

Creator Store ürünleri için -9 değeri gerektiren bir exponent vardır, bu nedenle aynı fiyat şu şekilde görünür:


"myPrice": {
  "currencyCode": "USD",
  "quantity": {
    "significand": 17990000000,
    "exponent": -9
  }
}

Ondalık

Bir decimal sayıyı, önemli basamaklar ve bir üs ile bilimsel gösterim benzeri bir biçimde temsil eder.

Ö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}

exponent 0'dan büyük olduğunda, önemli basamakların ardından gelen sıfırların sayısını temsil eder. exponent 0'dan küçük olduğunda, ondalık noktadan sonra gelen önemli basamakların sayısını temsil eder. exponent 0 olduğunda, Decimal değerinin değeri significand değeridir.

Türkçe