開啟雲朵代表要求和回應載入為 標準 JSON。 標準 JSON 類型包括文字、值、對象、陣列、數據和字串。 一些類型有特殊考慮代表特定類型的資料,這在下一個部分中討論。
時戳
使用 RFC 3339,生成的輸出將永遠為 Z 正常化,並使用 0、3、6 或 9 位分數位。除了 "Z" 之外的偏移也是可以接受的。
示例時戳
{ "timestamp": "1972-01-01T10:00:20.021Z" }
時效
生成的輸出總是包含 0、3、6 或 9 個小數位,這取決於所需的精度,並且以「s」後綴以「秒」,接受任何小數位 (也不包含任何) ,只要它們能夠準確地落在 nano-秒 精度和「s」後綴。範圍必須是 -315,576,000,000 至
範例持續時間
{
"duration-9": "1.000340012s",
"duration-0": "1s"
}
位元
石頭資料以字串的形式寫入,並使用標準 base64 編碼以及 paddings 來表示。 支持盡管標準或 URL 安全的 base64 編碼或沒有 paddings 的情況。
範例位元
{
"bytes": "YWJjMTIzIT8kKiYoKSctRbLx+"
}
字符面
FieldMask 是一個描述要在作出請邀請時處理的字段的串。要建造 FieldMask ,您將字串中的字符串分隔為空格。例如:
範例 JSON 資源
{
"foo": {
"a": "c",
"b": "d"
},
"bar": "x",
"baz": "y"
}
如果您想要指定一個值 foo.b 和 bar 的值,值面具將會像: foo.b, bar
在開放雲端中,更新方法,包括 updateMask 參數,可以指定一個值作為 Field Mask 。
金錢
一般用於定義價格,Money 類型有三個字母貨幣代碼 (按照 ISO 4217 所定義) 和數量,這使用 Decimal 輸入。舉例來說,一個名為 $17.99 的創作者商店產品看起來像這樣:
"myPrice": {
"currencyCode": "USD",
"quantity": {
"significand": 1799,
"exponent": -2
}
}
十六進制
代表一個十六進制數字,與科學記號相似,包括重要的數位和指數。
例子:
17
{"significand": 17, "exponent": 0} 或只是 {"significand": 17}
0.005
{"significand": -5, "exponent": -3}
33.5 百萬(33,500,000)
{"significand": 335, "exponent": 5}
11/8 (1.375)
{"significand": 1375, "exponent": -3}
當 exponent 大於 0 時,代表零後的零位數。當 exponent 小於 0 時,代表零後的零位數。當 exponent 為 0 時,代表 1> Decimal1> 的值是 4> significand4> 的值。