Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
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.
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).
[null,null,["Cập nhật lần gần đây nhất: 2025-07-27 UTC."],[[["\u003cp\u003eThe \u003ccode\u003etype\u003c/code\u003e property defines the data type in JSON, while the \u003ccode\u003eformat\u003c/code\u003e property provides additional context about the underlying type.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003etype\u003c/code\u003e is always present, but \u003ccode\u003eformat\u003c/code\u003e is optional and offers further data type details.\u003c/p\u003e\n"],["\u003cp\u003eGoogle APIs Discovery Service supports standard JSON Schema formats and defines its own for specific Google data types.\u003c/p\u003e\n"],["\u003cp\u003eClient libraries may use language-specific types to represent these types and formats for better integration.\u003c/p\u003e\n"],["\u003cp\u003eThe table comprehensively lists all supported \u003ccode\u003etype\u003c/code\u003e and \u003ccode\u003eformat\u003c/code\u003e values used by the Google APIs Discovery Service.\u003c/p\u003e\n"]]],[],null,["# Type and format\n\nThe `type` and `format` properties on parameters and schemas can be used\nto determine the data type of the property. The `type` property indicates the type of\nthe property when its sent in JSON requests and responses (JSON supports a small set of data\ntypes, see [json.org](https://json.org) for details). The `format`\nproperty provides additional information about the underlying type. Properties will always have\na `type` property, but some may also have a `format` property.\n\n\nFor example, a 64-bit integer cannot be represented in JSON (since JavaScript and JSON support\nintegers up to 2\\^53). Therefore, a 64-bit integer must be represented as a string in JSON\nrequests/responses. So the `type` property will be set to \"string\", but the\n`format` property will be set to \"int64\" to indicate that it is a 64-bit integer.\n\n\nThe JSON Schema spec already [defines a set of common\nvalues](https://tools.ietf.org/html/draft-zyp-json-schema-03#section-5.23) for the `format` property. The Google APIs Discovery Service supports some\nof these values, and defines others as well. The full list of `type` and\n`format` values supported by Google APIs Discovery Service is summarized below.\n| **Note:** The [client libraries](https://developers.google.com/api-client-library/) that we automatically generate from an API's discovery document sometimes use language-idiomatic types for these types and formats. For example: A 64-bit integer is represented as type `string` in JSON requests and responses, but our generated Java client library uses the Java `long` type.\n\n| Type value | Format value | Meaning |\n| `any` | | The property may have any type. Defined by the [JSON Schema spec](https://tools.ietf.org/html/draft-zyp-json-schema-03). |\n| `any` | `google.protobuf.Value` | The property has the JSON representation of the type of [google.protobuf.Value](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/struct.proto). |\n| `array` | | A JavaScript array of values. The `items` property indicates the schema for the array values. Defined by the JSON Schema spec. |\n| `array` | `google.protobuf.ListValue` | The property has the JSON representation of the type of [google.protobuf.ListValue](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/struct.proto). |\n| `boolean` | | A boolean value, either \"true\" or \"false\". Defined by the JSON Schema spec. |\n| `integer` | `int32` | A 32-bit signed integer. It has a minimum value of -2,147,483,648 and a maximum value of 2,147,483,647 (inclusive). |\n| `integer` | `uint32` | A 32-bit unsigned integer. It has a minimum value of 0 and a maximum value of 4,294,967,295 (inclusive). |\n| `number` | `double` | A double-precision 64-bit IEEE 754 floating point. |\n| `number` | `float` | A single-precision 32-bit IEEE 754 floating point. |\n| `object` | | A JavaScript object. Defined by the JSON Schema spec. |\n| `object` | `google.protobuf.Struct` | The property has the JSON representation of the type of [google.protobuf.Struct](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/struct.proto). |\n| `object` | `google.protobuf.Any` | The property has the JSON representation of the type of [google.protobuf.Any](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/any.proto). |\n| `string` | | An arbitrary string. Defined by the JSON Schema spec. |\n| `string` | `byte` | A padded, base64-encoded string of bytes, encoded with a URL and filename safe alphabet (sometimes referred to as \"web-safe\" or \"base64url\"). Defined by [RFC4648](https://tools.ietf.org/html/rfc4648). |\n| `string` | `date` | An RFC3339 date in the format YYYY-MM-DD. Defined in the JSON Schema spec. |\n| `string` | `date-time` | An RFC3339 timestamp in UTC time. This in the format of yyyy-MM-ddTHH:mm:ss.SSSZ. The milliseconds portion (\".SSS\") is optional. Defined in the JSON Schema spec. |\n| `string` | `google-datetime` | An RFC3339 timestamp in UTC time. This in the format of yyyy-MM-ddTHH:mm:ss.SSSZ. The milliseconds portion (\".SSS\") is optional. |\n| `string` | `google-duration` | A string ends in the suffix \"s\" (indicating seconds) and is preceded by the number of seconds, with nanoseconds expressed as fractional seconds. The period is always used as the decimal point, not a comma. |\n| `string` | `google-fieldmask` | A string where field names are separated by a comma. Field names are represented in lower-camel naming conventions. |\n| `string` | `int64` | A 64-bit signed integer. It has a minimum value of -9,223,372,036,854,775,808 and a maximum value of 9,223,372,036,854,775,807 (inclusive). |\n| `string` | `uint64` | A 64-bit unsigned integer. It has a minimum value of 0 and a maximum value of (2\\^64)-1 (inclusive). |\n|------------|-----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|"]]
