Các loại

*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.

Open Cloud đại diện cho các tải trọng yêu cầu và phản hồi dưới dạng JSON tiêu chuẩn. Các loại JSON tiêu chuẩn là văn bản, giá trị, đối tượng, mảng, số và chuỗi. Một số loại có những cân nhắc đặc biệt để đại diện cho các loại dữ liệu cụ thể, điều này được mô tả trong các phần sau.

Dấu thời gian

Sử dụng RFC 3339, nơi đầu ra được tạo ra sẽ luôn được chuẩn hóa theo dạng Z và sử dụng 0, 3, 6 hoặc 9 chữ số phân số. Các bù đắp khác ngoài "Z" cũng được chấp nhận.

Ví dụ Dấu thời gian
{ "timestamp": "1972-01-01T10:00:20.021Z" }

Thời gian

Đầu ra được tạo ra luôn chứa 0, 3, 6 hoặc 9 chữ số phân số, tùy thuộc vào độ chính xác yêu cầu, theo sau là hậu tố "s". Các chữ số phân số (có thể không có) được chấp nhận miễn là chúng phù hợp với độ chính xác nano-giây và hậu tố "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ả hai đầu.

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

Bytes

Dữ liệu byte được mã hóa dưới dạng chuỗi sử dụng mã hóa base64 tiêu chuẩn với đệm. Cả mã hóa base64 tiêu chuẩn hoặc an toàn với URL có hoặc không có đệm đều được hỗ trợ.

Ví dụ Bytes
{
  "bytes": "YWJjMTIzIT8kKiYoKSctRbLx+"
}

FieldMask

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

Ví dụ JSON
{
  "foo": {
    "a": "c",
    "b": "d"
  },
  "bar": "x",
  "baz": "y"
}

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

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

Tiền tệ

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


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

Sản phẩm trong Creator Store yêu cầu một exponent là -9, vì vậy giá tương tự trông như thế này:


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

Decimal

Đại diện cho một số thập phân dưới dạng tương tự như ký hiệu khoa học, với các chữ số đáng kể và một số mũ.

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 chữ số 0 ở phía sau các chữ số đáng kể. Khi exponent nhỏ hơn 0, nó đại diện cho số lượng chữ số đáng kể nằm sau dấu phẩy thập phân. Khi exponent bằng 0, giá trị của Decimal là giá trị của significand.

Tiếng Việt