Merchant API のスタートガイド

始める前に、Cloud プロジェクトで Merchant API を有効にします。

Merchant API を使用する方法は次のとおりです。

クライアント ライブラリの使用

Merchant API は複数のサブ API で構成されています。

各サブ API には、使い始めるのに役立つコードサンプルクライアント ライブラリがあります。

Content API for Shopping をすでに使用している場合は、Content API for Shopping の互換性をご覧ください。

リクエストの送信

Merchant API は、識別に ID ではなくリソース名を使用します。商品のリソース名の例は accounts/123/products/online~en~US~sku123 です。ここで、123 はアカウントの一意の識別子、online~en~US~sku123 は商品の一意の識別子です。

リソースを操作するには、次の形式の URL にリクエストを送信します。

https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}

たとえば、次のリクエストはリージョン インベントリを削除します。

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123/products/online~en~US~sku123/regionalInventories/456

新しいリソースを作成するには、親リソースのリソース名と次の URL を使用します。

POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}

たとえば、account/123 の新しいリージョンを作成するには、次のようにします。

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123/regions

特定のサービスの詳細については、Merchant API のリファレンス ドキュメントをご覧ください。

gRPC または REST を使用する

Merchant API は gRPCREST をサポートしています。Merchant API を呼び出す方法は次の 2 つです。

gRPC(推奨) REST
  1. リクエストの本文をプロトコル バッファとして作成します。
  2. HTTP/2 を使用してリクエスト本文をサーバーに送信します。
  3. レスポンスをプロトコル バッファにシリアル化解除します。
  4. 結果を解釈します。
  1. リクエストの本文を JSON オブジェクトとして作成します。
  2. HTTP 1.1 を使用してサーバーに送信します。
  3. レスポンスを JSON オブジェクトとして逆シリアル化します。
  4. 結果を解釈する。

ヘルプ

サポートの利用については、Merchant API に関するヘルプをご覧ください。

フィードバックを送信

ベータ版期間は、一般提供のリリース前にフィードバックを収集して対応する機会となります。フィードバックを送信するには、次のいずれかを行います。

  • API の機能: フィードバック フォームを送信する
  • ドキュメント: ページ内の高評価アイコンと [フィードバックを送信] ボタンを使用します。
  • サンプルとライブラリ: GitHub の [新しい問題] ボタンを使用します。

各タスクの実装後に一般的なフィードバックを送信するには、フィードバック フォームを使用します。