このページでは、API の移行を計画する際のガイダンスを提供します。
次に、移行に必要な手順の概要を説明します。
移行の計画
Content API for Shopping のメソッドを Merchant API のメソッドにマッピングします。
Merchant API に必要な新しいメソッドとリソースを明確に理解するうえで、非常に役立ちます。
移行に適用される最も重要な変更を理解します。
移行に役立つ次のリソースを確認して、覚えておくことをおすすめします。
- Content API からの移行の概要: Merchant API で注意すべき主な変更点について説明します。
- サブ API 固有の移行ガイド: 必要なサブ API 固有の移行ガイドを確認します。新しいフィールド マッピングなどの重要な情報が記載されています。例については、プロダクト管理を移行するをご覧ください。
- Merchant API リファレンスでは、Merchant API のリソースとメソッドの詳細を確認できます。
- クイックスタート ガイドでは、Merchant API をすぐに使用してアカウントを作成し、サンプル商品をアップロードする方法について説明します。
- 機能固有のガイド: 新機能の実装や詳細な説明については、ナビゲーションに表示される機能ガイドをご覧ください。
移行して実装する予定のサブ API を特定します。
次の 2 つを決定します。
- 移行する必要がある Merchant API の機能
- 実装する新機能
この作業が完了したら、作業量と、取り組むべきサブ API の優先順位リストを決定できます。
すべて、または可能な限り移行することをおすすめします。重要度と複雑さにより、コンテンツ API の実装全体を最初に移行できない場合は、次のサブ API を優先します。
移行手順
デベロッパーとして登録する Merchant API を使用するには、Google Cloud プロジェクトとメインの Merchant Center アカウントの間にリンクを作成する必要があります。この登録は 1 回限りのもので、Merchant API で使用するすべての Google Cloud プロジェクトで必要です。プロセス全体については、こちらをご覧ください。
さまざまな方法をテストして、立ち上げを支援します。基本的なテストを行うには、Google APIs Explorer を使用することをおすすめします。
Merchant API のリクエスト URL の形式は次のとおりです。
https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}…コードサンプルとクライアント ライブラリを活用する。
実装時間を短縮し、gRPC のメリットを享受するには、クライアント ライブラリとコードサンプルを使用します。
ガイドにはコードサンプルのスニペットも埋め込まれています。たとえば、商品を追加するをご覧ください。
シンプルなユーザー ジャーニーをテストします。
移行を予定しているすべてのサブ API と機能で、次の目標を達成するためにユーザー ジャーニー テストを実施します。
- 移行したリソースと呼び出しのレスポンス結果が正しい。
- エラー率が低いままです。
ロールアウトを計画する
次のアプローチをおすすめします。
- サブ API またはメソッドを一度に 1 つずつ実装します。
- 一度にビジネスの小さなセグメントにのみ実装します。
- 常に問題が発生していないかモニタリングします。
移行を実装する
新しいリソースとエンドポイントを使用してコーディングを行う。
リリースプランの初期テストと開発が完了したら、Merchant API をワークフローに統合します。
モニタリング。
潜在的な問題に対処する準備をします。