類型和格式摘要
參數和結構定義的 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 (含)。 |