类型和格式

您可以使用参数和架构的 type 和 format 属性来确定属性的数据类型。type 属性在 JSON 请求和响应中指明属性的类型（JSON 支持一小组数据类型；如需了解详情，请参阅 json.org）。format 属性提供有关底层类型的其他信息。媒体资源始终具有 type 属性，但有些媒体资源可能还具有 format 属性。

例如，64 位整数无法在 JSON 中表示（因为 JavaScript 和 JSON 支持的整数最大为 2^53）。因此，64 位整数必须在 JSON 请求/响应中表示为字符串。因此，type 属性将设置为“字符串”，但 format 属性将设置为“int64”，以指明它是 64 位整数。

JSON 架构规范已为 format 属性定义了一组常用值。Google API Discovery Service 支持其中一些值，并定义了其他值。下面总结了 Google API Discovery Service 支持的 type 和 format 值的完整列表。

注意：我们根据 API 的发现文档自动生成的 客户端库 有时会对这些类型和格式使用语言惯用类型。例如：64 位整数在 JSON 请求和响应中表示为 string 类型，但我们生成的 Java 客户端库使用 Java long 类型。

类型值	格式值	含义
any		该属性可以是任何类型。由 JSON 架构规范定义。
any	google.protobuf.Value	该属性具有 google.protobuf.Value 类型的 JSON 表示形式。
array		一个 JavaScript 值数组。items 属性指示数组值的架构。由 JSON 架构规范定义。
array	google.protobuf.ListValue	该属性具有 google.protobuf.ListValue 类型的 JSON 表示法。
boolean		布尔值，可以是“true”或“false”。由 JSON 架构规范定义。
integer	int32	32 位带符号整数。其最小值为 -2,147,483,648，最大值为 2,147,483,647（含）。
integer	uint32	32 位无符号整数。其最小值为 0，最大值为 4,294,967,295（含）。
number	double	双精度 64 位 IEEE 754 浮点。
number	float	单精度 32 位 IEEE 754 浮点。
object		JavaScript 对象。由 JSON 架构规范定义。
object	google.protobuf.Struct	该属性具有 google.protobuf.Struct 类型的 JSON 表示形式。
object	google.protobuf.Any	该属性的 JSON 表示形式为 google.protobuf.Any 类型。
string		任意字符串。由 JSON 架构规范定义。
string	byte	填充的 base64 编码字节字符串，使用网址和文件名安全字母表（有时称为“网络安全”或“base64url”）进行编码。由 RFC4648 定义。
string	date	RFC3339 日期，格式为 YYYY-MM-DD。在 JSON 架构规范中定义。
string	date-time	采用世界协调时间 (UTC) 的 RFC3339 时间戳。格式为 yyyy-MM-ddTHH:mm:ss.SSSZ。毫秒部分（“.SSS”）是可选的。在 JSON 架构规范中定义。
string	google-datetime	采用世界协调时间 (UTC) 的 RFC3339 时间戳。格式为 yyyy-MM-ddTHH:mm:ss.SSSZ。毫秒部分（“.SSS”）是可选的。
string	google-duration	字符串以后缀“s”（表示秒）结尾，后跟秒，其中纳秒表示小数秒。英文句点始终用作小数点，而不是英文逗号。
string	google-fieldmask	以逗号分隔的字符串名称。字段名称以驼峰式命名规则表示。
string	int64	64 位带符号整数。其最小值为 -9,223,372,036,854,775,808，最大值为 9,223,372,036,854,775,807（含）。
string	uint64	64 位无符号整数。其最小值为 0，最大值为 (2^64)-1（含）。