Tóm tắt về loại và định dạng
Bạn có thể dùng thuộc tính type và format trên các tham số và giản đồ để xác định loại dữ liệu của thuộc tính. Thuộc tính type cho biết loại của thuộc tính khi thuộc tính này được gửi trong các yêu cầu và phản hồi JSON (JSON hỗ trợ một tập hợp nhỏ các loại dữ liệu, hãy xem json.org để biết thông tin chi tiết). Thuộc tính format cung cấp thêm thông tin về loại cơ bản đó. Các tài sản sẽ luôn có một tài sản type, nhưng một số tài sản cũng có thể có một tài sản format.
Ví dụ: một số nguyên 64 bit không thể được biểu thị trong JSON (vì JavaScript và số nguyên hỗ trợ JSON lên đến 2^53). Do đó, một số nguyên 64 bit phải được biểu thị dưới dạng một chuỗi trong các yêu cầu/phản hồi JSON. Vì vậy, thuộc tính type sẽ được đặt thành "string" nhưng thuộc tính format sẽ được đặt thành "int64" để cho biết đây là một số nguyên 64 bit.
Thông số giản đồ JSON đã xác định một tập hợp giá trị chung cho thuộc tính format. Dịch vụ khám phá của các API của Google hỗ trợ một số giá trị này và cũng xác định các giá trị khác. Dưới đây là danh sách đầy đủ các giá trị type và format được Dịch vụ khám phá của Google API hỗ trợ.
| Loại giá trị | Giá trị định dạng | Ý nghĩa |
|---|---|---|
any |
|
Cơ sở lưu trú có thể có bất kỳ loại nào. Được xác định theo quy cách JSON Schema. |
array |
|
Một mảng các giá trị JavaScript. Thuộc tính items cho biết giản đồ cho các giá trị mảng. Được xác định bởi thông số giản đồ JSON. |
boolean |
|
Giá trị boolean, "true" hoặc "false" Được xác định bởi thông số giản đồ JSON. |
integer |
int32 |
Số nguyên có dấu 32 bit. Nó có giá trị tối thiểu là -2.147.483.648 và giá trị tối đa là 2.147.483.647 (bao gồm cả). |
integer |
uint32 |
Số nguyên 32 bit không dấu. Nó có giá trị tối thiểu là 0 và giá trị tối đa là 4.294.967.295 (bao gồm cả). |
number |
double |
Dấu phẩy động IEEE 754 có độ chính xác gấp đôi 64 bit. |
number |
float |
Dấu phẩy động IEEE 754 có độ chính xác đơn 32 bit. |
object |
|
Đối tượng JavaScript. Được xác định bởi thông số giản đồ JSON. |
string |
|
Một chuỗi tuỳ ý. Được xác định bởi thông số giản đồ JSON. |
string |
byte |
Một chuỗi byte được mã hóa base64 đệm, được mã hóa bằng URL và bảng chữ cái an toàn của tên tệp (đôi khi được gọi là "web-safe" hoặc "base64url"). Được xác định theo RFC4648. |
string |
date |
Ngày RFC3339 ở định dạng YYYY-MM-DD. Được xác định trong thông số giản đồ JSON. |
string |
date-time |
Dấu thời gian RFC3339 theo giờ UTC. Thông tin này ở định dạng yyyy-MM-ddTHH:mm:ss.SSSZ. Phần mili giây (".SSS") là không bắt buộc. Được xác định trong thông số giản đồ JSON. |
string |
google-datetime |
Dấu thời gian RFC3339 theo giờ UTC. Thông tin này ở định dạng yyyy-MM-ddTHH:mm:ss.SSSZ. Phần mili giây (".SSS") là không bắt buộc. |
string |
google-duration |
Một chuỗi kết thúc ở hậu tố "s" (tính bằng giây) và đứng sau số giây, với nano giây được biểu thị bằng giây phân số. Dấu chấm luôn được dùng làm dấu thập phân, không phải dấu phẩy. |
string |
google-fieldmask |
Một chuỗi mà tên trường được phân tách bằng dấu phẩy. Tên trường được thể hiện trong các quy ước đặt tên theo quy tắc lạc đà hơn. |
string |
int64 |
Số nguyên có dấu 64 bit. Nó có giá trị tối thiểu là -9.223.372.036.854.775.808 và giá trị tối đa là 9.223.372.036.854.775.807 (bao gồm). |
string |
uint64 |
Số nguyên 64 bit chưa ký. Nó có giá trị tối thiểu là 0 và giá trị tối đa là (2^64)-1 (bao gồm cả 2 giá trị đó). |