Jenis

Open Cloud mewakili request dan response payloads sebagai JSON standar . Jenis JSON standar adalah teks, nilai, objek, array, nomor, dan string. Beberapa jenis memiliki pertimbangan khusus untuk mewakili jenis data tertentu, yang dijelaskan dalam bagian berikut.

Stempel Waktu

Menggunakan RFC 3339, di manaOutput yang dihasilkan akan selalu Z-normalized dan menggunakan 0, 3, 6 atau 9 digit fraksional. Offsets lainnya juga diterima.

Tim戳 contoh
{ "timestamp": "1972-01-01T10:00:20.021Z" }

Durasi

Output yang dihasilkan selalu berisi 0, 3, 6, atau 9 digit fraksional, tergantung pada persyaratan keakuratan, diikuti oleh prefiks "s". Diterima semua digit fraksional (juga tidak ada) asalkan mereka sesuai dengan persyaratan persyaratan nano-detik dan prefiks "s" yang diperlukan. Range harus dimulai dari -315,

Durasi Contoh
{
  "duration-9": "1.000340012s",
  "duration-0": "1s"
}

Baht

Data Byte di-Encoding sebagai string menggunakan peng-Encoding standar base64 dengan pemotongan. Either standard atau URL-safe base64 encoding dengan atau tanpa pemotongan didukung.

Contoh Bytes
{
  "bytes": "YWJjMTIzIT8kKiYoKSctRbLx+"
}

Top Mask

FieldMask adalah string yang menggambarkan field untuk bertindak ketika membuat permintaan. Untuk membangun field mask, Anda spesifikasi nama field JSON yang dibatasi oleh koma dalam string. Misalnya, berdasarkan sumber daya berikut:

Contoh sumber daya JSON
{
  "foo": {
    "a": "c",
    "b": "d"
  },
  "bar": "x",
  "baz": "y"
}

Jika Anda ingin menentukan topeng field untuk menyelesaikan nilai hanya foo.b dan bar, topeng field akan terlihat seperti: foo.b, bar

Di Open Cloud, update methods that support a field mask have a parameter named updateMask , di mana Anda dapat meng指定 masker field sebagai nilai.

Uang

Biasanya digunakan untuk mendefinisikan harga, jenis Money memiliki kode mata uang tiga huruf (seperti yang didefinisikan dalam ISO 4217) dan jumlah, yang menggunakan ketikDecimal. Misalnya, produk Mata Uang $17,99 terlihat seperti ini:

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

Desimal

M mewakili angka desimal dalam bentuk yang mirip dengan notasi ilmiah, dengan angka besar dan eksponens.

Contoh:

• 17

  {"significand": 17, "exponent": 0} atau hanya {"significand": 17}

• 0.005

  {"significand": -5, "exponent": -3}

• 33,5 juta (33,500,000)

  {"significand": 335, "exponent": 5}

• 11/8 (1.375)

  {"significand": 1375, "exponent": -3}

Ketika exponent lebih besar dari 0, mewakili jumlah nol pemotongan setelah angka signifikan. Ketika exponent kurang dari 0, mewakili jumlah digit signifikan yang datang setelah titik desimal. Ketika exponent adal