このページでは、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 をワークフローに統合します。
モニタリングする。
発生する可能性のある問題に対処する準備をします。