รูปแบบ

Open Cloud เป็นตัวแทนคำขอและตอบกลับเป็น JSON มาตรฐาน ตัวแทนประเภท JSON มีข้อควรพิจารณาพิเศษสำหรับการแทนที่ข้อมูลประเภทต่างๆ ที่อธิบายในส่วนต่อไปนี้

เวลาที่แนบมา

ใช้ RFC 3339 โดยการออก力จะถูกปกติอยู่เสมอและใช้ตัวเลขทศนะ 0, 3, 6 หรือ 9 ตัว ตัวเลขทศนะอื่นนอกจาก "Z" ยังได้รับการรองรับ

ตัวอย่างเวลาที่แน่นอน
{ "timestamp": "1972-01-01T10:00:20.021Z" }

ระยะเวลา

การออก力ที่สร้างขึ้นจะมี 0, 3, 6 หรือ 9 ตัวอย่างที่มีความนิ่งต้องการ ติดตั้งด้วยชื่อ "s" ตามด้วยความนิ่งต้องการ ตัวอย่างนี้จะ

ตัวอย่างระยะเวลา
{
  "duration-9": "1.000340012s",
  "duration-0": "1s"
}

ไบท์

ข้อมูลไบท์จะถูกเข้ารหัสเป็นสตริงโดยใช้การเข้ารหัส base64 ด้วย paddings หรือไม่มี paddings ก็ได้ รองรับทั้งหมดตั้งแต่ตัวอักษรมาตรฐานไปจนถึง base64 ที่ปลอดภัยทางอินเทอร์เน็ต

ตัวอย่างบาท
{
  "bytes": "YWJjMTIzIT8kKiYoKSctRbLx+"
}

หน้ากาก

FieldMask เป็นสตริงที่อธิบายสนามที่จะดำเนินการเมื่อสร้างคำขอ เพื่อสร้าง Mask สนาม คุณจะระบุชื่อสนาม JSON ด้วยคอมมาจำกัดในสตริง โดยให้ตัวอย่างด้านล่าง:

ตัวอย่างทรัพยากร JSON
{
  "foo": {
    "a": "c",
    "b": "d"
  },
  "bar": "x",
  "baz": "y"
}

หากคุณต้องการระบุหน้ากากข้อมูลเพื่อปรับปรุงค่าของเฉพาะ foo.b และ bar หน้ากากข้อมูลจะดูเหมือน: foo.b, bar

ใน Open Cloud คุณสามารถปรับปรุงวิธีการที่สนับสนุนหน้ากากฟิลด์มีพารามิเตอร์ที่มีชื่อว่า updateMask โดยคุณสามารถระบุหน้ากากฟิลด์เป็นค่าได้

เงิน

โดยทั่วไปใช้เพื่อกำหนดราคา, Money ชนิดมีรหัสเงินสามตัว (ตามที่กำหนดใน ISO 4217) และปริมาณ, ซึ่งใช้ Decimal พิมพ์

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

ตัวอักษร

แทนตัวเลขทศนะในรูปแบบที่คล้ายกับเครื่องคำนวณทางวิทยาศาสตร์ด้วยตัวเลขที่มีค่ามากและตัวเร่ง

ตัวอย่าง:

• 17

  {"significand": 17, "exponent": 0} หรือเพียง {"significand": 17}

• 0.005

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

• 33.5 ล้าน (33,500,000)

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

• 11/8 (1.375)

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

เมื่อ exponent ใหญ่กว่า 0 มันจะ表示เป็นจำนวนของศูนย์หลังจุลภาคหลังจากตัวเลขที่สำคัญ เมื่อ exponent น้อยกว่า 0