Product Advertising API (PA-API) 5.0は現行のProduct Advertising API 4.0を完全にリニューアルしたバージョンです。4.0よりもシステムに組み込みやすく軽量で、シンプルかつ高速に動作します。またAmazonサイトのユーザーエクスペリンスを向上する新しい機能も備わっています。
本移行ガイドでは、Product Advertising API 4.0を組み込んだ既存のアプリケーションをProduct Advertising API 5.0に移行するための手順を説明します。
Product Advertising API 5.0 (PA-API 5.0) はハイレベルでの次の新しい機能を提供します。
PA-API 4.0とPA-API 5.0の詳細な違いについては、PA-API 5.0ガイドの新項目 (What's New in PA-API 5.0 Guide) を参照してください。
PA-API 4.0とPA-API 5.0間のマッピングに関する詳細については、5.0へのPA-API 4.0のマッピング (PA-API 4.0 to 5.0 Mappings) を参照してください。
以下のフローチャートは、ハイレベルでのPA-API 4.0からPA-API 5.0への移行をチェックリストにしたものです。
上に記載されたステップごとの詳細を下記に示します。
現在お持ちのAWS認証情報 (AWSアクセスキーとAWSシークレットキー) は PA-API 5.0では使えません。現在AWSの認証情報をお持ちの場合は、アカウントを移行してから新しい認証情報を作ることができます。詳細については、AWSアカウントからのPA-APIアカウントの移行 (Migrating your PA-API Account from your AWS Account) を参照してください。
古いAWS認証情報をお持ちで、PA-API 5.0を試す際に次のようなエラーが表示される場合は (エラーのスクリーンショットがPA-API 5.0 Scratchpadのものであることに注目)、お使いのAWSアカウントからPA-APIアカウントを移行しなければならないことがあります。
なお、AWSからの認証情報の移行がすでに完了済みで、新しい認証情報 (AWSのものではない) をお持ちの場合は、それ以上の対応は必要ありません。
Product Advertising API 5.0への移行を始める前に、PA-API 5.0 Scratchpadを使って試してみてください。
PA-API 5.0 Scratchpadツールは、Product Advertising APIに向けてリクエストを送信し、レスポンスを取得するのに使うことができるツールです。Scratchpadは複数の言語ごとにサンプルコードを返すため、Product Advertising APIの動作を理解し、簡単に導入するための助けとなります。
詳細については、Scratchpadの使い方 (Using Scratchpad Guide) を参照してください。
導入を簡単にするため、Product Advertising API 5.0は主要な言語で複雑な設定なしに使えるSDKを備えています。SDKを利用することにより、リクエストのサイン、APIリクエストのシリアライゼーション、APIレスポンスのデシリアライゼーションがシンプルになります。
サポートされているSDKでPA-API 5.0を導入するか、別の方法として、SDKを使わずにバニラ実装をすることもできます。移行にあたっては、PA-APIをコールする部分とPA-APIレスポンスを変換する部分のみを、お使いのアプリケーションの使いたいフォーマットで変更するだけで良い場合があります。