Loại và định dạng

Bạn có thể sử dụng các thuộc tính type và format trên các tham số và giản đồ để xác định kiểu dữ liệu của thuộc tính. Thuộc tính type cho biết loại thuộc tính khi thuộc tính đó đượ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ó thuộc tính type, nhưng một số tài sản cũng có thể có thuộc tính format.

Ví dụ: số nguyên 64 bit không thể được biểu thị trong JSON (vì JavaScript và JSON hỗ trợ số nguyên lên đến 2^53). Do đó, 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 rằng đó là một số nguyên 64 bit.

Thông số Giản đồ JSON đã xác định một tập hợp các giá trị chung cho thuộc tính format. Google APIs Discovery Service hỗ trợ một số giá trị này và cũng xác định các giá trị khác. Sau đây là danh sách đầy đủ các giá trị type và format mà Dịch vụ Khám phá API của Google hỗ trợ.

Giá trị loại Giá trị định dạng Ý nghĩa
any Thuộc tính này có thể thuộc bất kỳ loại nào. Được xác định theo quy cách Giản đồ JSON.
any google.protobuf.Value Thuộc tính này có biểu diễn JSON của loại google.protobuf.Value.
array Một mảng giá trị JavaScript. Thuộc tính items cho biết giản đồ cho các giá trị mảng. Được xác định theo quy cách Giản đồ JSON.
array google.protobuf.ListValue Thuộc tính này có biểu diễn JSON của loại google.protobuf.ListValue.
boolean Giá trị boolean, "true" hoặc "false". Được xác định theo quy cách Giản đồ JSON.
integer int32 Số nguyên 32 bit có dấu. 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ả hai giá trị này).
integer uint32 Số nguyên 32 bit không dấu. Giá trị tối thiểu là 0 và giá trị tối đa là 4.294.967.295 (bao gồm).
number double Dấu phẩy động IEEE 754 64 bit có độ chính xác gấp đôi.
number float Dấu phẩy động IEEE 754 32 bit có độ chính xác đơn.
object Một đối tượng JavaScript. Được xác định theo quy cách Giản đồ JSON.
object google.protobuf.Struct Thuộc tính này có biểu thị JSON của loại google.protobuf.Struct.
object google.protobuf.Any Thuộc tính này có biểu diễn JSON của loại google.protobuf.Any.
string Một chuỗi tuỳ ý. Được xác định theo quy cách Giản đồ JSON.
string byte Một chuỗi byte được mã hoá base64 có phần đệm, được mã hoá bằng một bảng chữ cái an toàn cho URL và tên tệp (đôi khi được gọi là "an toàn cho web" hoặc "base64url"). Được xác định theo RFC4648.
string date Ngày RFC3339 theo định dạng YYYY-MM-DD. Được xác định trong thông số kỹ thuật về 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ố kỹ thuật về 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 bằng hậu tố "s" (cho biết giây) và đứng trước số giây, với số mili giây được biểu thị dưới dạng số 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 trong đó tên trường được phân tách bằng dấu phẩy. Tên trường được biểu thị theo quy ước đặt tên lower-camel.
string int64 Một số nguyên 64 bit có dấu. 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 Một số nguyên 64 bit chưa ký. Giá trị tối thiểu là 0 và giá trị tối đa là (2^64)-1 (bao gồm).