類型和格式摘要

參數和結構定義的 type 和 format 屬性可用來判斷屬性的資料類型。以 JSON 要求和回應傳送的 type 屬性表示屬性的類型 (JSON 支援少數資料類型)，詳情請參閱 json.org。format 屬性提供基礎類型的其他資訊。屬性一律會有 type 屬性，但部分可能也有 format 屬性。

舉例來說，64 位元整數無法以 JSON 表示 (因為 JavaScript 和 JSON 支援高達 2^53 的整數)。因此，64 位元整數必須表示為 JSON 要求/回應的字串。因此，type 屬性會設為「string」，但 format 屬性會設為「int64」，代表這是 64 位元整數。

JSON 結構定義規格已為 format 屬性定義一組通用值。Google API 探索服務支援部分值，您也可以定義其他值。以下摘要說明 Google API 探索服務支援的 type 和 format 值。

類型值	格式值	意義
any		屬性可以是任何類型。透過 JSON 結構定義規格定義。
array		值的 JavaScript 陣列。items 屬性表示陣列值的結構定義。由 JSON 結構定義規格定義。
boolean		布林值 (「quot;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 結構定義規格定義。
string		任意字串。由 JSON 結構定義規格定義。
string	byte	保留 Base64 編碼的位元組字串，以網址和檔案名稱安全字母編碼 (有時稱為「web-safe」或「base64url」)。由 RFC4648 定義。
string	date	RFC3339 日期，格式為 YYYY-MM-DD。定義於 JSON 結構定義規格。
string	date-time	RFC3339 時間戳記 (世界標準時間)。格式為 yyyy-MM-ddTHH:mm:ss.SSSZ。毫秒部分 (「.SSS」) 為選用部分。定義於 JSON 結構定義規格。
string	google-datetime	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 (含)。