Merchant API の概要

このページでは、Merchant API の概要と、Merchant Center でアカウント、商品、在庫の管理に関連するさまざまなワークフローを自動化する方法について説明します。

Merchant API を使用すると、より多くのユーザーにリーチし、Google のさまざまなサービスに商品を掲載できます。Merchant API を使用すると、大規模または複雑な Merchant Center アカウントを管理できます。一般的なユースケースは次のとおりです。

  • アカウント管理の自動化
  • 商品管理の自動化
  • 広告在庫の自動管理
  • カスタム レポートの作成

Merchant API を使用すると、複数のデータソースを作成して管理できるため、商品、プロモーション、レビューに関する情報をより適切に整理できます。Merchant API を使用すると、ファイルや自動フィードなどの他の商品データのアップロード方法を補完する方法で商品を管理できます。

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

小売店は、ショッピング広告と無料リスティングのポリシーを遵守する責任があります。Google ショッピングは、これらのポリシーに違反するコンテンツや行為が認められた場合、これらのポリシーを適用し、適切に対応する権限を有します。

Merchant API の新機能

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

詳細については、Merchant API ベータ版で導入された新機能をご覧ください。

始める前に

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

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

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

Merchant API による認証

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

アカウント ID と商品 ID

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

リクエスト URL の形式

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

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

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

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

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123456/products/online~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/v1beta/accounts/123456/regions?regionId=WA HTTP/1.1

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

特定のサービスの詳細については、Merchant 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 リポジトリで問題を作成します。

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

次のステップ

次へ
デザイン