ประเภท

*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

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

เวลาที่บันทึก

ใช้ RFC 3339 ที่ผลผลิตที่สร้างขึ้นจะเป็น Z-normalized เสมอและใช้ 0, 3, 6 หรือ 9 ตัวเลขทศนิยม ค่าออฟเซ็ตอื่นนอกเหนือจาก "Z" ยังได้รับการยอมรับ

ตัวอย่างเวลาที่บันทึก

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

ระยะเวลา

เอาต์พุตที่สร้างขึ้นเสมอมีจำนวนเศษส่วน 0, 3, 6 หรือ 9 ตามความถูกต้องที่ต้องการ ตามด้วยคำนำหน้า "s"ยอมรับตัวเลขทศนิยมใดๆ (ไม่มีเลยก็ได้) ตราบใดที่พวกเขาสอดคล้องกับความถูกต้องในระดับนาโนวินาทีและตัวอักษร "s" จำเป็นช่วงต้องอยู่ระหว่าง -315,576,000,000 ถึง 315,576,000,000 วินาที รวมด้วย

ระยะเวลาตัวอย่าง

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

ไบต์

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

ตัวอย่างไบต์

{
"bytes": "YWJjMTIzIT8kKiYoKSctRbLx+"
}

สนามหน้ากาก

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

ทรัพยากร JSON ตัวอย่าง

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

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

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

เงิน

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


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

ผลิตภัณฑ์ร้านค้าผู้สร้างต้องใช้ exponent ของ -9 ดังนั้นราคาเดียวกันจึงดูเหมือนว่า:


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

เลขฐานสิบ

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

ตัวอย่าง:

  • 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 มันแสดงถึงจํานวนหลักที่สําคัญที่มาหลังจุลภาคเมื่อ exponent เป็น 0, ค่าของ Decimal คือค่าของ significand