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

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

アカウントと商品の識別情報

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} の部分は省略されます。

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

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}

たとえば、次のリクエストは、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 のサポートを受けるをご覧ください。

フィードバックを送信

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

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

次のステップ

前へ
Latest updates
次へ
Design