Merchant API の概要

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

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

Merchant API は、大規模または複雑な Merchant Center アカウントを管理できます。 主な用途としては、次のようなものがあります。

  • アカウント管理の自動化
  • 商品管理の自動化
  • 在庫管理の自動化
  • パフォーマンスと市場の分析情報に関するレポート管理の自動化

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 による認証

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

アカウントと商品の識別子

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}

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

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

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

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

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

たとえば、次のリクエストは、create a region for 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 のリファレンス ドキュメントをご覧ください。

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 のヘルプをご覧ください。

フィードバックを送信

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

次のステップ

前へ
Latest updates
次へ
Design