Loại

Open Cloud đại diện cho các yêu cầu và phản hồi payload như JSON tiêu chuẩn.Các loại JSON tiêu chuẩn là văn bản, giá trị, đối tượng, ma trận, số và chuỗi.Một số loại có những xem xét đặc biệt để đại diện cho các loại dữ liệu cụ thể, được mô tả trong các phần tiếp theo.

Thời gian

Sử dụng RFC 3339, nơi sản phẩm được tạo ra sẽ luôn luôn bị Z-normalized và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khác biệt khác ngoài "Z" cũng được chấp nhận.

Ví dụ thời gian chính xác
{ "timestamp": "1972-01-01T10:00:20.021Z" }

Thời lượng

Sản phẩm được tạo luôn chứa 0, 3, 6 hoặc 9 chữ số thập phân, tùy thuộc vào độ chính xác cần thiết, sau đó là chữ "s" ở cuối.Chấp nhận là bất kỳ số thập phân (cũng không có) miễn là chúng phù hợp với độ chính xác nano-giây và chữ "s" là bắt buộc.Phạm vi phải từ -315,576,000,000 đến 315,576,000,000 giây, bao gồm cả.

Ví dụ thời gian
{
  "duration-9": "1.000340012s",
  "duration-0": "1s"
}

Bảng baytes

Dữ liệu bayt được mã hóa thành một chuỗi bằng cách sử dụng mã hóa cơ sở 64 tiêu chuẩn với các khoảng trống.Cả tiêu chuẩn hoặc mã hóa base64 an toàn URL với hoặc không có lớp lót được hỗ trợ.

Ví dụ các bayt
{
  "bytes": "YWJjMTIzIT8kKiYoKSctRbLx+"
}

Mặt nạ lĩnh vực

Một FieldMask là một chuỗi mô tả các trường để thực hiện khi tạo yêu cầu.Để xây dựng một mặt nạ trường, bạn xác định tên trường JSON được phân cách bằng dấu phẩy trong một chuỗi.Ví dụ, với tài nguyên sau:

Ví dụ tài nguyên JSON
{
  "foo": {
    "a": "c",
    "b": "d"
  },
  "bar": "x",
  "baz": "y"
}

Nếu bạn muốn xác định một mặt nạ trường để cập nhật các giá trị chỉ của foo.b và bar, mặt nạ trường sẽ trông như: foo.b, bar

Trong Open Cloud, cập nhật các phương pháp hỗ trợ một mặt nạ trường có một tham số tên là updateMask , nơi bạn có thể xác định một mặt nạ trường như một giá trị.

Tiền

Thông thường được sử dụng để định nghĩa một giá, loại Money có mã tiền tệ ba chữ cái (như định nghĩa trong ISO 4217) và một lượng, sử dụng loại Decimal .Ví dụ, bạn có thể đại diện cho một giá $17.99 như thế này:

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

Các sản phẩm Cửa hàng Nhà sáng tạo yêu cầu một exponent của -9, vì vậy giá tương tự trông như thế này:

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

Thập phân

Đại diện cho một số thập phân trong một hình thức tương tự như ghi chú khoa học, với các chữ số đáng kể và một số nhân.

Ví dụ:

• 17

  {"significand": 17, "exponent": 0} hoặc chỉ {"significand": 17}

• -0.005

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

• 33,5 triệu (33,500,000)

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

• 11/8 (1.375)

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

Khi exponent lớn hơn 0, nó đại diện cho số lượng số 0 cuối cùng sau các chữ số quan trọng.Khi exponent nhỏ hơn 0, nó đại diện cho bao nhiêu chữ số quan trọng đến sau dấu phân cách thập phân.Khi exponent là 0, giá trị của Decimal là giá trị của significand .