このページでは、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 の優先順位リストを決定できます。
可能な限りすべてを移行することをおすすめします。重要度と複雑さのために、Content 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}…Google のコードサンプルとクライアント ライブラリを活用 します。
実装時間を短縮し、 gRPC のメリットを活用するには、クライアント ライブラリとコード サンプルを使用します。
ガイドにはコードサンプルのスニペットも埋め込まれています。例については、商品を追加する をご覧ください。
シンプルなユーザー ジャーニーをテストします。
移行する予定のすべてのサブ API と機能で、次の目標を達成するためにユーザー ジャーニー テストを実施します。
- 移行したリソースと呼び出しのレスポンス結果が正しい。
- エラー率が低い。
ロールアウトの計画
次のアプローチをおすすめします。
- サブ API またはメソッドを 1 つずつ実装する。
- 一度にビジネスの小さなセグメントにのみ実装する。
- 常に問題が発生しないかモニタリングする。
移行を実装する
新しいリソースとエンドポイントを使用してコーディングを行う。
最初のテストとリリース計画の作成が完了したら、Merchant API をワークフローに統合します。
モニタリングする。
潜在的な問題に対処する準備をします。