Merchant API の概要

Merchant API を使用すると、次のことが可能になります。

  • Google でのビジネスと商品の表示方法を管理します。
  • データ、分析情報、独自の機能にプログラムでアクセスできます。
  • Google でビジネスを拡大し、より多くのユーザーにリーチしましょう。

Merchant API を使用すると、大規模または複雑な Merchant Center アカウントを管理できます。一般的なユースケースは次のとおりです。

  • アカウント管理の自動化
  • 商品管理の自動化
  • 広告在庫の自動管理
  • パフォーマンスとマーケット インサイトに関するレポート管理の自動化

Merchant API を使用すると、複数のデータソースを作成して管理できるため、商品、プロモーション、レビューに関する情報をより効率的に整理できます。Merchant API を使用すると、ファイルや自動フィードなどの他の商品データ アップロード方法を補完する形で商品を管理できます。また、Merchant API では、複数の個別のリクエストを並行して実行することもできます。

Merchant API は、Content API for Shopping を再設計したものです。複数のサブ API で構成されています。

Merchant API の新機能

Merchant API にアップグレードする理由は次のとおりです。

始める前に

Merchant API リクエストを実行するには、以下が必要です。

  • Merchant Center アカウント: データのクエリ、更新、アップロードを行うアカウントです。このアカウントで商品と在庫を管理するために必要な権限があることを確認してください。

  • Google Cloud プロジェクト: アカウントへの API アクセス権を取得するために使用されます。

  • Merchant Center アカウントから Google Cloud プロジェクトへのリンク。デベロッパー登録メソッドを呼び出してリンクを作成します。このアカウントとユーザーは、API 統合、アンケート、最適化案に関する連絡に使用されます。

  • デベロッパーとして登録して、Merchant Center アカウントを Google Cloud プロジェクトにリンクします。API デベロッパー ロールを持つユーザーは、サービスに関する重要なお知らせ、デベロッパー アンケート、最適化案など、API 関連の通知を受け取ります。

Merchant API による認証

認証には次のオプションを使用できます。

アカウント ID と商品 ID

Merchant API では、識別子として ID ではなくリソース名を使用します。商品のリソース名の例としては、accounts/123456/products/en~US~sku123 があります。ここで、123456 はアカウントの固有識別子、en~US~sku123 は商品の固有識別子です。

リクエスト URL の形式

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

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

list や get などの標準メソッドでは、:{METHOD} 部分は省略されます。

たとえば、次のリクエストは地域在庫を削除します。

DELETE https://merchantapi.googleapis.com/inventories/v1/accounts/123456/products/en~US~sku123/regionalInventories/456

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

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

たとえば、次のリクエストは、accounts/123456 のリージョンを作成する方法を示しています。

POST https://merchantapi.googleapis.com/accounts/v1/accounts/123456/regions?regionId=WA HTTP/1.1

{
  "displayName": "Washington",
  "name": "Washington",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98039",
        "end": "98118"
      }
    ],
    "regionCode": "US"
  }
}

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

Merchant API の使用を開始する

Merchant API の仕組みを簡単に確認し、サンプル商品のアップロードを試すには、Merchant API のスタートガイドをご覧ください。

gRPC または REST を使用する

Merchant API は gRPC と REST をサポートしています。Merchant API 呼び出しを行うには、次の 2 つの方法があります。

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

クライアント ライブラリとコードサンプルを使用する

各サブ API には、すぐに利用を開始できるようにクライアント ライブラリが用意されています。コードサンプルは、Java、PHP、Python でのコード作成に役立ちます。詳細については、Merchant API のサンプルをご覧ください。

ヘルプ

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

フィードバックを送信

フィードバックを送信するには、次のいずれかを送信します。

  • API 機能: フィードバック フォームの [問題 / 質問の内容] セクションで [フィードバックを送信] オプションを選択します。
  • ドキュメント: ページ内の高評価 / 低評価ボタンと [フィードバックを送信] ボタンを使用します。
  • サンプルとライブラリ: コードサンプルの GitHub リポジトリで問題を報告します。

次のステップ

次へ
Merchant API terms and conditions