Product Advertising API の仕様変更について


概要

Product Advertising APIにおいて提供される機能が商品の宣伝を行う目的と関連性があるものとするため、2011年10月26日を発効日とするAPIの仕様変更を行います。本ガイドは変更内容についての説明、お客様のウェブサイトやアプリケーションへの影響および、何らかの変更が必要となった場合のヘルプを記載しています。

新しいProduct Advertising API記述言語(WSDL)は、こちらから入手いただけます。旧バージョンのWSDLを使用したアプリケーションは、2011年10月26日までは動作しますが、全ての旧バージョンのサポートは、2012年2月22日に終了する予定です。ご自身のアプリケーションを引き続き動作させるには、この期日までに最新バージョンのWSDLへのアップグレードをお願いいたします。


Product Advertising API の仕様変更に関する詳細

以下の変更が2011年10月26日に適用されます:

Associate Tag パラメータ: 全てのAPIへのリクエストにおいて、有効なAssociate Tagを含めていただくことが必要となります。有効なAssociate Tagを含まない全てのリクエストはエラーとなり、エラーメッセージが表示されます。Associate Tagパラメータの詳細については、開発者ガイド をご参照ください。

Seller オペレーション: SellerLookup, SellerListingLookup および SellerListingSearch オペレーションは廃止されます。これらのオペレーションに関連するリクエストは全てエラーとなり、エラーメッセージが表示されます。

ItemPage パラメータ: ItemSearch オペレーションにおいて、ItemPage パラメータの最大値は従来の400から10に変更となります。”All”サーチインデックスにおける最大値は、引き続き5ページとなります。新しい要素である“MoreSearchResults” が ItemSearch のレスポンスに加えられます。これは、ItemPage の上限数を超える結果をカスタマーが確認したい場合に、Amazon ウェブサイトへ誘導するためのリンクを含んだものです。10を超える ItemPage の結果はエラーとなり、対応するエラーメッセージが表示されます。

ItemAttributes レスポンスグループ: 商品の宣伝に密接に関連していない一部のItemAttributes 要素は廃止されます。変更後にサポートされる項目の一覧については、最新の WSDL をご確認ください。

Offers: オファー要素は、最も頻繁に使用されるケースに集約されます。変更後は、MerchantId とコンディションの組み合わせを何度もテストして、最も適切なオファーの組み合わせについて迷う必要はなくなります。

  • OfferPageパラメータのサポートは終了し、リクエストは処理されません。
  • 新しい要素である “MoreOffers” が Offers レスポンスグループに追加されます。ここには、Amazonのオファーページへのリンクが含まれます。
  • 以下の表は、Offers レスポンスグループにおける API の各入力パラメータに対する挙動についてまとめたものです。

  • 以下の表は、Variationsレスポンスグループにおける挙動についてまとめたものです。
  • Offers レスポンスグループ内の、商品宣伝と関連性の薄い項目は削除されます:
    • Merchant ID, Merchant Location
    • Total Feedback Pages, Total Feedback, Average Rating
    • Exchange ID
    • Quantity
    • Sub Condition, Condition Note, Will Ship Expedited/International
    • Quantity Restriction, Sales Restriction
    • ISPU Store Address, Store Hours
    • IsFulfilledByAmazon, IsMAPViolated, MAP Policy

お客様のアプリケーションへの影響

廃止されるオペレーションおよびAssociate Tag要件以外の上記の全ての変更は対応可能な範囲で下位互換できるよう設定しています。なお、以下の点にご留意ください:

  • 本変更により、新規に追加される必須パラメータはありません。
  • しかしながら、追加された新しい要素の仕様を希望される場合、スキーマの 2011-08-01 バージョンを使用いただく必要があります。
  • 廃止を予定している多くの要素は、スキーマにおいて「オプション」として扱われているものです。ご使用のアプリケーションが、オプションの要素を正しく処理している場合、特にアプリケーションに変更を加えていただく必要はありません。
  • お客様のアプリケーションが、現在有効なAssociate Tagを含めずにAPIにアクセスされている場合、リクエストは処理されなくなります。アプリケーションに必要な変更を加え、全てのリクエストにAssociate Tagを含めるようにしてください。

お客様のアプリケーションが Offers または Variations を使用されている場合、以下の項目が適用される場合があります:

  • お客様のアプリケーションが、MerchantId を厳密に使用する設定でない場合、デフォルトの挙動は、商品に Amazon のオファーが存在しない場合でもオファーデータを返す仕様に変更となります。Amazon のオファーおよびバリエーションのみを取得したい場合は、MerchantId=Amazon と指定することが可能です。
  • アプリケーションに複雑な Offer 選定ロジック(例えば、MerchantId, Condition または OfferPage パラメータを使用している、など)がある場合、API コールからこれらのパラメータを削除されることを推奨します。API は、自動的に商品に最も関連性の高いオファーを検索して返します。OfferSummary レスポンスグループを使用すると、商品に対して各コンディションとにいくつのオファーが存在するかが確認でき、MoreOffers リンクを使用することで、カスタマーを Amazon に送客することができます。
  • もしお客様のアプリケーションが MerchantId パラメータを使用して Variation を選択する仕様の場合、API コールからこれらのパラメータを削除されることを推奨します。デフォルトで API は全てのバリエーションと各バリエーション内の最善のオファーを返すようになります。
  • もし、OfferPage パラメータを使用して複数のオファーページデータを取得するロジックを設定されている場合、この機能は削除いただくこととなります。

お客様のアプリケーションが ItemSearch を使用されている場合、以下の項目が適用される場合があります:

  • アプリケーションが Merchants サーチインデックスを使用されている場合、こちらの使用を中止いただくこととなります。
  • アプリケーションが10ページ以上の検索結果を取得する仕様の場合、代わりに、Amazon のウェブサイトに誘導する MoreSearchResults リンクを使用いただくこととなります。