このページは Cloud Translation API によって翻訳されました。

複数のリクエストを一度に送信する

Merchant API でバッチリクエストを使用すると、1 回の API 呼び出しで複数のリクエストを送信できます。

バッチリクエストは multipart/mixed コンテンツタイプを使用した、複数の API 呼び出しを含む単一の標準 HTTP リクエストです。メインの HTTP リクエスト内の各パートには、ネストされた HTTP リクエストが含まれます。

API に指定された batchPath にバッチリクエストを送信できます。Merchant API ベータ版の batchPath は batch/{sub-api}/v1beta です。他の API の batchPath については、ディスカバリドキュメントをご覧ください。

リクエストのバッチ処理が必要となるケースの例としては、次のようなものが挙げられます。

API を使い始めたばかりで、アップロードするデータが大量にあります。
アプリがオフライン中にユーザーがデータを変更したため、アプリがローカルデータをサーバーと同期する必要があります。

HTTP バッチ処理についてご不明な点がある場合、またはクライアントライブラリを使用してバッチリクエストを送信する機能をリクエストしたい場合は、フィードバックを送信してください。

バッチリクエストを作成する

Merchant API バッチリクエストの例を次に示します。このリクエストは、商品の地域別の在庫を取得する get リクエストと、同じ商品のローカル在庫を更新する挿入リクエストを組み合わせたものです。

サンプルの形式に厳密に従う必要があります。

https://merchantapi.googleapis.com/batch/{sub-api}/v1beta をベース URL として使用します。
ネストされた各リクエストを区切る境界を指定します。次に例を示します。

-H 'Content-Type: multipart/mixed,boundary=batch_inventory' \
ネストされた各リクエストを境界で区切ります（例: --batch_inventory）。
ネストされた各リクエストの先頭に Content-Type: application/http を含めます。
（省略可）Content-ID を使用して、ネストされた各リクエストに独自の ID でラベルを付けます。例:

Content-ID: <get:online:en:US:123456>.
ネストされた各リクエストのヘッダー、パス、本文の間に空白行を挿入します。ネストされたリクエストに本文がない場合は、次の境界の前に空白行を残します。
ネストされた各リクエストにベース URL を含めないでください。
最終的な境界（例: --batch_inventory–）でメインリクエストを終了します。

curl https://merchantapi.googleapis.com/batch/inventories/v1beta \
-H 'Authorization: Bearer <TOKEN>' \
-H 'Content-Type: multipart/mixed,boundary=batch_inventory' \
--data '
--batch_inventory
Content-Type: application/http
Content-ID: <get:online:en:US:123456>

GET /inventories/v1beta/accounts/123/products/online:en:US:123456/regionalInventories

--batch_inventory
Content-Type: application/http
Content-ID: <post:online:en:US:123456>

POST /inventories/v1beta/accounts/123/products/online:en:US:123456/regionalInventories:insert

{
   "region: "123456",
    "price": {
        "amountMicros": "100000000",
        "currencyCode": "USD"
    }
}
--batch_inventory--
'

指定した順序で呼び出しを実行する必要がある場合は、呼び出しを個別に送信し、最初のリクエストに対するレスポンスを待ってから次のリクエストを送信します。

バッチレスポンスを読み取る

これは、HTTP バッチレスポンスの例です。レスポンスの順序はリクエストの順序と一致しない場合があります。ネストされたレスポンスが属するネストされたリクエストを特定するには、Content-ID を使用します。レスポンスでは、各 Content-ID の先頭に response- が付いています。

--batch_YCE-jYH0pmDrBIHeHhltcpXIMpk0VTzQ
Content-Type: application/http
Content-ID: <response-get:online:en:US:123456>
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Vary: Origin
Vary: X-Origin
Vary: Referer
{}
--batch_YCE-jYH0pmDrBIHeHhltcpXIMpk0VTzQ
Content-Type: application/http
Content-ID: <response-post:online:en:US:123456>
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Vary: Origin
Vary: X-Origin
Vary: Referer
{
  "name": "accounts/123/products/online:en:US:123456/regionalInventories/123456",
  "region": "123456",
  "price": {
    "amountMicros": "100000000",
    "currencyCode": "USD"
  }
}
--batch_YCE-jYH0pmDrBIHeHhltcpXIMpk0VTzQ--
'

複数のリクエストを一度に送信する

バッチ リクエストを作成する

バッチ レスポンスを読み取る

バッチリクエストを作成する

バッチレスポンスを読み取る