オープンクラウドは、標準のJSONとしてリクエストと応答のプロトタイプを表示します。標準のJSON タイプは、テキスト、値、オブジェクト、2>配列2>、5>数値5>、および 8>ストリング8> です。一部のタイプには、特定の種類のデータを表示するための特別な考慮があります。これは、
タイムスタンプ
RFC 3339 を使用し、生成された出力は常に Z 形式になり、0、3、6 または 9 桁の小数字を使用します。「Z」以外のオフセットも許可されています。
タイムスタンプの例
{ "timestamp": "1972-01-01T10:00:20.021Z" }
期間
生成された出力には、精度に応じて 0、3、6、または 9 のフラクション桁が含まれています。「s」の後に付く数字は、ナノ秒の精度と「s」の後に付く数字を含めると、すべて 0 です。範囲は -315,576,000,000 から 315,5
期間の例
{
"duration-9": "1.000340012s",
"duration-0": "1s"
}
バイト
バイトデータは、追加のパッドを使用して標準の base64 エンコードでストリングとしてエンコードされます。標準または URL 安全な base64 エンコードで、またはパッドを使用しないでいる場合がサポートされています。
バイトの例
{
"bytes": "YWJjMTIzIT8kKiYoKSctRbLx+"
}
フィールドマスク
フィールドマスクは、リクエストを処理するときに使用するフィールドの説明です。フィールドマスクを構築するには、以下のリソースを指定します:
JSON リソースの例
{
"foo": {
"a": "c",
"b": "d"
},
"bar": "x",
"baz": "y"
}
bar と bar の値を更新するためのフィールドマスクを指定したい場合は、フィールドマスクは次のようになります: foo.b, bar と 1> foo.b1> の値を更新するフィールドマスクを指定する必要があります。
In Open Cloud では、フィールドマスクをサポートするメソッドを更新すると、updateMask というパラメーターがあり、フィールドマスクを値として指定できます。
マネー
一般的に価格を定義するために使用される Money タイプには、3文字の通貨コード (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}
When exponent は 0 より大きいとき、 exponent は 0 の後ろのゼロの数を表します。When exponent は 0 未満のとき、 1>exponent1> は 0 の後ろの桁の数を表します。When