Merchant API の設計

Merchant API は、Content API for Shopping のデベロッパーにとって使い慣れたものになるように設計されていますが、よりシンプルで柔軟性があります。Merchant API の設計に関する詳細情報は次のとおりです。

サブ API

Merchant API は、サブ API のコレクションです。サブ API は、関連するサービスとリソースのグループです。この設計により、独自の統合に必要なサブ API のみを使用できます。

Merchant API には次のサブ API が含まれます。

  • アカウント: Merchant Center アカウントを大規模に管理します。
  • コンバージョン: アカウントのコンバージョン ソースを管理します。
  • データソース: 商品のデータソースを表示、管理します。
  • 問題の解決: アカウントに影響する問題を取得し、アプリ内診断ページを作成します。
  • 在庫: Google で店舗や地域ごとに商品をアピールできます。
  • ローカル フィード パートナーシップ: ローカル商品在庫フィードをアップロードします。
  • 通知: 通知の登録を管理します。
  • 注文追跡: 過去の注文追跡データを提供して、配送予定を改善し、配送に関するアノテーションでリスティングを強化します。
  • 商品: 価格や在庫状況などの商品データを管理します。
  • Product Studio: Google Product Studio を使用して、商品画像とテキストの候補を自動的に生成します。
  • プロモーション: プロモーションを作成、管理して、商品のスペシャル オファーを表示します。
  • Quota: アカウントの API 割り当てを確認します。
  • レポート: Google 全体での商品、パフォーマンス、競合状況に関するデータを表示します。
  • レビュー: 商品と販売者のレビューを管理します。

トランスポート

Merchant API のデフォルトのトランスポート メカニズムは gRPC です。REST を使用することもできます。

詳しくは、クイックスタート ガイドをご覧ください。

列挙型

Merchant API の列挙型フィールドでは、今後新しい値が公開される可能性があります。コードは、認識できない値を適切に処理できるように構造化する必要があります。認識できない列挙値の発生をモニタリングし、コードを最新の状態に保つために介入する必要があります。

バージョニング

サブ API は個別にバージョン管理されます。つまり、使用していないサブ API が更新されても、対応は不要です。コードの更新が必要になるのは、使用しているサブ API の新しいバージョンがリリースされた場合のみです。詳しくはバージョニングをご覧ください。

「beta」で終わるバージョンは、変更または削除される可能性があります。