このページでは、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}…コードサンプルとクライアント ライブラリを活用します。
実装時間を短縮し、gRPC のメリットを享受するには、クライアント ライブラリとコードサンプルを使用します。
ガイドにはコード サンプル スニペットが含まれています。例については、プロダクトを追加するをご覧ください。
シンプルなユーザー ジャーニーをテストします。
移行を予定しているすべてのサブ API と機能に対して、次の目標を掲げてユーザー ジャーニー テストを実施します。
- 移行したリソースと呼び出しで、正しいレスポンス結果が得られる。
- エラー率は低いままです。
ロールアウトを計画する
次のアプローチをおすすめします。
- 一度に 1 つのサブ API またはメソッドを実装します。
- 一度にビジネスの小さなセグメントにのみ実装します。
- 常に問題をモニタリングします。
移行を実装する
新しいリソースとエンドポイントを使用してコーディングに取り組む。
初期テストとリリース計画の作成が完了したら、Merchant API をワークフローに統合します。
モニタリング。
潜在的な問題に対処する準備をします。