PA-API 5.0 (PA-API5) は、最新版のProduct Advertising APIです。サービス終了予定の旧バージョンであるPA-API4からアップグレードされたもので、最新の商品情報にアクセスできるようになります。PA-API 5は現在、米国 (US)、カナダ (CA)、メキシコ (MX)、ブラジル (BR)、英国 (UK)、ドイツ (DE)、スペイン (ES)、フランス (FR)、インド (IN)、イタリア (IT)、アラブ首長国連邦 (AE)、トルコ (TR)、日本 (JP)、シンガポール(SG)、オーストラリア (AU) のマーケットプレイスで利用可能です。新規に追加されたマーケットプレイスでは、PA-API 5のみのサポートとなります。詳細については、地域別資料 (Locale Reference) を参照してください。
PA-API 5にアップグレードすることで最新の機能が使えるようになるからです。PA-API 4で利用できる主要な機能はもちろんのこと、PA-API 5では、Amazonの商品に追加された新しい機能も利用できます。このような新しい機能によって、お客様にもっと良いショッピングエクスペリエンスをお届けできるようになります。PA-API 5には、開発者がAPIを簡単に導入してアプリケーションやサイトを開発するまでの時間を短縮できるような新しいサポート機能があります。今後行われる商品の機能強化は、PA-API 5でのみ利用できるようになります。新しい各機能の詳細については、下記の質問やマニュアルを参照してください。PA-API 4は、サポートが廃止されつつあるテクノロジーを基に構築されています。PA-API 4は、2020年3月9日をもって稼働を停止します。その後PA-API 4を使っているすべてのアプリケーションやサイトは、従来のように機能しなくなります。そのため、最新バージョンのPA-APIにアップグレードすることが重要になります。
PA-API 5は、アソシエイト・セントラルのメンバーが商品を宣伝することで紹介料を得られるように設計されたAPIです。次のようなメリットがあります。
世界的規模のAmazon Product Advertising API (PA-API 5) やウェブサービスを利用し、メンバーが自身のサイトを通じてAmazonで購入できる商品を宣伝することで、メンバーのサイトやソーシャルメディアの投稿から収益を増やすことができるようになります。
その通りです。PA-API 4をすでに使用している場合は、PA-API 5を使ってサイトまたはアプリケーションを更新し、すべてのPA-API 4 APIコールをPA-API 5 APIコールに置き換えなければなりません。参考のために、PA-API 4 APIコールをPA-API 5 APIコールにマッピングさせるための簡単な表を移行ガイドの中で紹介しています。
PA-API 5へのアップグレードにかかる労力と時間は、お持ちのサイトやアプリケーションの複雑さに応じて増減するため、この質問に正確にお答えすることはできかねます。PA-API 4からPA-API 5にアップグレードするにあたり、主なアプリケーションに変更を加えるのに3~4週間かかるものと想定しています。テストや展開に必要な時間は、個々の導入環境によって異なります。2020年3月9日までのアップグレード期間中は、PA-API 4とPA-API 5双方へのアクセスが可能です。導入を円滑に進めるため、トラブルシューティング用の資料も用意しました。また、このFAQに記載されたEメールアドレス宛にお問合せいただくこともできます。
認証情報が2017年9月30日以降に発行されたものであれば、これ以上の手続きは必要ありません。認証情報が発行されたのが2017年9月29日以前であれば、アソシエイト・セントラルのPA-APIのページにアクセスして、「今すぐ移行する (migrate now)」をクリックしてください。このリンクをクリックすると、お持ちの認証情報がPA-API 5で使えるものに更新されます。必ずメインユーザー (所有者) のアカウントからログインしてください。詳細は、アカウントの移行を参照してください。引き続きPA-APIを使うことができるように、既存の認証情報ストアと設定ファイルのすべてを更新しておいてください。
PA-APIをテストする一番簡単な方法は、アソシエイト・セントラルのアカウント認証情報ページをご覧いただくことです。必ずメインユーザー (所有者) のアカウントからログインしてください。
PA-API 5 Scratchpadを使って、お持ちの認証情報とPA-API 5との互換性を確認してください。「ツアーを始める (Start Tour)」のオプションでScratchpadの使い方を見てください。質問がある場合は、Scratchpadのユーザーガイドのセクションを確認してください。
「AccessDeniedAwsUsers」のコードで「AccessDeniedException」が表示される場合は、アソシエイト・セントラルのPA-APIタブにアクセスして、お持ちの認証情報を移行してください。
上の例外が表示されない場合は、Scratchpadを使ってPA-API 5の機能を試してみてください。
アプリケーションの開発作業中にアプリケーションのデバッグをする必要がある場合は、Scratchpadを使ってAPIの反応を確かめることができます。「その他のヘルプ」に関連した質問に詳細があります。
はい。新しい認証情報でPA-API 4にアクセスすることができます。2020年3月9日にサービスが停止するまでPA-API 4にアクセスすることができます。PA-API 4が使える間は古い認証情報を引き続き使うこともできますが、新旧の2つの認証情報を同時に管理するのではなく、すべてのバージョンのPA-APIで新しい認証情報を使うことをお勧めします。
PA-API 5にアップグレードした後は、PA-API 5とPA-API 4の両方を使うことができます。こうすることでアップグレード中に両方のシステムを並行して使うことができるため、ダウンタイムの発生をなくすことができます。2020年3月9日にPA-API 4は稼働停止となり、その後は使うことはできません。PA-API 5は引き続き最新の認証情報で使うことができます。
はい。PA-API 5への移行後も同じ エフィシェンシー・ガイドラインと条件が適用されます。
Amazonアソシエイト・セントラルプログラムに登録済みで、アカウントの承認が完了している方は、PA-APIへのアクセスをリクエストすることができます。アソシエイト・セントラルから認証情報を受け取った後は、その情報を使ってPA-API 5を呼び出すことができます。より詳しい情報は PA-APIの登録を参照してください。
古い認証情報はPA-API 4のサービス停止までご利用いただけます。
サービス停止までの間、新しい認証情報でPA-API 4にアクセスすることができます。
PA-API 4へのリクエストのサインには引き続き既存のAWS署名バージョン2を利用することができ、新旧いずれの認証情報でも使用できます。ただしPA-API 5へのリクエストのサインには、AWS署名バージョン4によるサインが必要です。リクエストのサインを代行してくれるPA-API 5へのリクエストは、PA-API 5のSDKを使って行うことができます。
PA-API 5では、メインユーザー (EメールID) である所有者が複数のマーケットプレイスで承認されたストアを所有している場合、日本以外のマーケットプレイスであればどこでも単一の認証情報を使ってアクセスすることができます。日本向けには、日本のアソシエイト・セントラルページで作成できる日本のマーケットプレイス専用の認証情報が別途必要になります。異なるEメールIDを用いて複数のマーケットプレイスにアソシエイトとして登録している場合は、各マーケットプレイスごとの認証情報を作成する必要があります。
ItemLookup、ItemSearch、SimilarityLookup、CartCreate、CartAdd、CartGet、CartModify、CartClearを使用中の場合はPA-API 4を、これ以外の場合はPA-API 5を使っています。応答がXML形式の場合はPA-API 4を、JSON形式の場合はPA-API 5を使っています。外部あるいはサードパーティーによるソフトウェアやプラグインを使用している場合は、それぞれのプロバイダーにお問い合わせください。
この件は現在対応中です。アップロードは近日中に実施予定です。
Power Searchはサポートが廃止されつつあるテクノロジーであるため、PA-API 5ではサポートされません。
PA-API 5では、複数のGetItems API用商品IDや複数のGetBrowseNodes API用BrowseNode IDをそれぞれ最大10件まで指定することができます。
PA-API 5 ScratchpadのロゴからProduct Advertising API 5.0の情報を確認できます。次のリンクからScratchpadにアクセスしてください。PA API 5 Scratchpad、PA API 4 Scratchpad
アソシエイト・セントラル Webサイトに移動してください。ストアのメインユーザー (所有者) のEメールIDでログインしてください。ナビゲーションバーから「ツール > Product Advertising API」の順に選択してください。「認証情報の管理」セクションから認証情報の移行を行ってください。認証情報が作成されたらAmazon Product Advertising API 5.0 Scratchpadでの使用を開始してください。
PA-API 5へのアクセスは、承認されたストアのメインユーザー (所有者) によってのみ可能です。参加/移行ボタンが無効である、または認証情報の作成や追加ボタンが無効となっている場合は、ストアが承認され、ストアのメインユーザーがアソシエイト・セントラルにログインしていることを確認してください。
はい。アソシエイト・セントラルへの移行をお願いします。
アソシエイト・セントラルへのログイン時に、ストアの「支払い方法の変更」や「税務審査」のページにアクセスすることができれば、そのアカウントはストアのメインユーザー (所有者) のものです。
アソシエイト・セントラル Webサイトからカスタマーサポートに連絡してください。
はい。アトリビューションはそれぞれのPA-APIで機能します。現在PA-API 5のデータにはリンクタイプレポートが表示されませんが。近日中に追加予定です。
PA-API 5では、Cart APIのサポートが廃止されています。「カートに追加」フォームを使用してください。
外部識別子 (UPC/EAN/ISBN) の検索 セクションで詳細を確認してください。
質問やコメント等がある場合は、次の方法でサポートを受けることができます。
資料には数多くのPA-API 5の使用例が記載されています。
エラーコードとメッセージについては、エラーハンドリング (Error Handling) をご確認ください。
リクエストの例、コードのサンプルを作るには、Amazon Product Advertising API 5.0 Scratchpadの使い方 (Using the Amazon Product Advertising API 5.0 Scratchpad) をご確認ください。
依然として不明な点がある場合は、アソシエイト・セントラルのメインページにある一覧に記載された方法でサポートをリクエストしてください。 - https://affiliate-program.amazon.co.uk/