タイプ

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

オープンクラウドは、標準の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