類型和格式摘要

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

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

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

類型值 格式值 意義
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 (含)。