Amazon E-Commerce Service 4.0
リリースノート 2007-05-14

このリリースノートは、最新バージョンのAmazon E-Commerce Service (ECS)においてリリースされた、2つの新しい機能についてお知らせするものです。なお、今回のリリースで解決された問題はありません。以前のバージョンにおける変更情報につきましては、 http://aws.amazon.com/resources をご参照ください。

Release Date: 2007-05-14
Latest WSDL/API Version: 2007-05-14

新機能

以下の表は、このバージョンにおける新機能の説明となります。

適用ストア

対象項目
新機能
US X ECSがTinyとThumbnailと呼ばれる2種類の画像サイズを返すようになった点

以前は、ECSは Large, Medium, Small, およびSwatchのサイズの画像サイズを返していました。現在、ECSはTinyとThumbnailの画像サイズも返すようになりました。ThumbnailとSmallは同じサイズとなります。Thumbnailはより画像についてのより説明的な要素となりますがSmallも今までの適合性を鑑みて、今後も保持されます。 ImagesとVariationImagesのレスポンスグループがこれらの画像を返します。

CA X
DE X
FR X
JP X
UK X
US X The PromotionDetailsのレスポンスグループが新しい要素のMerchandisingMessageを含むようになった点

MerchandisingMessageの要素はマーチャントから入力された販促テキストを含みます。

CA X
DE X
FR X
JP X
UK X
US   DE, JPおよびUKにおいて、Watchesのsearch indexがItemSearchリクエストで使えるようになった点 DE, JPおよびUKのItemSearchリクエストでWatchesのsearch indexが使えるようになりました。
CA  
DE X
FR  
JP  
UK X
US X BrowseNode IDがAmazon E-Commerce Developer Guideで含まれるようになった点 Amazon E-Commerce Developer Guideは商品カテゴリおよび国別の上位browse node IDを表示する新しい参照セクションを提供します。
CA X
DE X
FR X
JP X
UK X
US X Quantityの要素が文書化された点 この要素はECSの前のバージョンのWSDLに追加され、OffersとOfferFullレスポンスグループのセクションに文書化されています。
CA X
DE X
FR X
JP X
UK X
US X ECS Getting Started Guide が発行された点 The ECS Getting Started Guide はRESTリクエストの実装およびレスポンス処理の方法を紹介しています。これらの実装のサンプルは数多くのプログラミングげ言語で提供されています。更なる情報はhttp://aws.amazon.com/resources.をご覧ください。
CA X
DE X
FR X
JP X
UK X

解決された問題

以下の表は、このバージョンにおける解決された問題の一覧となります。

適用ストア

対象項目
問題と解決
US X いくつかのマーチャントより提供されていた商品画像が返されなかった点

いくつかのマーチャントのCustomer IDとMerchant IDが違っており、この違いが画像が返されない原因でした。この問題は解決されました。

CA  
DE  
FR  
JP  
UK  

既知の問題

以下に記載の事項は、現在ECS4.0においてしばしば見られる不具合についての説明となります。
なお、以下文中にて記載のUSはAmazon.com、UKはAmazon.co.uk、DEはAmazon.de、JPはAmazon.co.jp、FRはAmazon.fr、CAはAmazon.caを指します。

また、「マーチャント」とは、Amazon.comにおいて展開されている、Amazon以外のショップにより商品が提供されるシステムにおける、ショップのことを指します。

問題 内容 発生の状況
ECSがDVD、ビデオおよびいくつかの音楽商品で最初の5人の俳優および監督名のみを返す点 以前は、ECSはDVD、ビデオおよびいくつかの音楽商品で全ての俳優と監督名を返していました。現在は最初の5人の俳優および監督名のみを返しています。 本来よりも少ない数の俳優と監督名が返されます。
JPにおいて、 EANのフィールドが13桁のISBNをサポートしていない点 ISBNは13桁へと以前よりも大きい桁数になりました。現在あるEANのフィールドに13桁のISBNのデータは格納されていますが、ItemSearch で EANのフィールドに13桁のISBNを指定した場合、正しくない結果が返されます。 ItemLookup において、ItemId に13桁 ISBN を指定し、IdTypeパラメータでISBNを指定し、かつsearch indexパラメータにBooksを指定してください。
Browsenodesを使用したItemSearchにおいて、search indexがPetSuppliesの場合、動作の不具合がある点 全てのItemSearchリクエストではsearch indexが必要となります。しかし、Browse nodeのparameterも使用された場合、正しくない結果が返されます  PetSuppliesKitchenのsearch indexの下にあり、Kitchenのsearch indexで正しい結果を返すことができます。 PetSupplies. の代わりにKitchen のsearch indexを使用してください。
BrowseNodeLookup オペレーションにおいて、指定されたbrowse nodeがストアホームのIDであった場合、正しくないトップセラー情報が返される点 この問題は、TopSellers の response group を使用する場合に、下位nodeのいずれかを代わりに指定することで回避することができます。 ストアホームのbrowse node でのトップセラーを確認しようとした際に発生します。
ListFull および ListInfo のresponse group は、TotalItemの数値を正しく返さない場合がある点 この数値の不一致は、responseにおいて、しばしば無効なASINをトータルの値として含んでしまうことにより発生します。 TotalItem の数値をアプリケーションで使用しようとした際、問題が発生することがあります。
ItemSearch の結果として返されるデータが、MaximumPrice およびMinimumPrice で指定された値以外の価格の商品を含む場合がある点 ItemSearch パラメータである MaximumPrice および MinimumPriceは、本来、指定された価格の範囲に返される商品リストを絞り込むべき機能を持っています。しかしながら、これを使用された場合に返される商品が、指定された範囲に合致しないものである場合があります。 MaximumPrice およびMinimumPrice の双方を ItemSearch において使用しようとした際に発生します。
Actor (俳優)またはDirector(監督)データを検索するためのItemSearchリクエストが、同じサーチ結果を返している点 データベースの元データが俳優と監督データを区別していないことにより発生している問題となります。 俳優(Actor)または監督(Director)に対するItemSearch のリクエストを行う際に発生します。
CAおよびEUにおいて、salesrankの値がAmazonサイトに表示される値と一致しない点 ECS と Amazonサイトで提供している salesrank の値に差があることにより発生している問題となります。 salesrank 順に並べ替えられた ItemSearch のリクエストを行う際に発生します。
BrowseNodeInfoを使用した際、全ての上位browse node情報が返されるわけではない点

BrowseNodeLookupにおいてBrowseNodeInfoのresponse groupを利用した際、リクエストにおいて指定されたbrowse nodeの上位および下位nodeの情報を表示することになっています。しかしながら、browse nodeが複数の上位nodeに属している場合、そのうちの1つのnodeしか現状返されません。これにより、Amazonサイトに表示されるbrowse nodeの情報と、ECS経由で表示される情報に差異が見られる場合があります。BrowseNodeInfoは、本来指定されたbrowse nodeが持つ全ての上位および下位nodeの情報を表示され、例えば、以下の例の場合、リクエストの対象となっているSocial Sciencesの上位nodeとして、Booksが表示されるべきで、同時に、全ての存在する下位nodeも表示されるべきです。しかしながら、現状、以下の例では、いくつかの下位browse nodeしか表示されていません。

<Item>
<ASIN>0131856340</ASIN>
-<BrowseNodes>
  -<BrowseNode>
   <BrowseNodeId>11232</BrowseNodeId>
   <Name> Social Sciences</Name>
     -<Ancestors>
      -<BrowseNode>
      <BrowseNodeId>53</BrowseNodeId>
      <Name>Nonfiction</Name>
      -<Ancestors>
       -<BrowseNode>
       <BrowseNodeId>1000</BrowseNodeId>
       <Name>Subjects</Name>
      -<Ancestors>
        -<BrowseNode>
        <BrowseNodeId>283155</BrowseNodeId>
        <Name>Books</Name>
      </BrowseNode>
    </BrowseNode>
  </BrowseNode>
- <Children>
  - <BrowseNode>
      <BrowseNodeId>11233</BrowseNodeId>
      <Name>Anthropology</Name>
    </BrowseNode>
  - <BrowseNode>
      <BrowseNodeId>11242</BrowseNodeId>
      <Name>Archaeology</Name>
    </BrowseNode>
  - <BrowseNode>
      <BrowseNodeId>3048861</BrowseNodeId>
      <Name>Children's Studies</Name>
    </BrowseNode>
  </Children>
</BrowseNodes>

なお、responseに表示される全てのbrowse nodeは、1つの上位nodeしか現状表示しません。例えば、Social Scienceの上位nodeはNonfictionと表示されており、もし他に上位nodeがあった場合でも、Nonfiction以外の上位nodeは表示されていません。

上位のbrowse node情報をBrowsenodeLookup により表示させようとした際に発生することがあります。
salesrank順に並べ替えを指定したItemの順番が正しくない点 ItemSearchを利用し、売れている順番に並べるためにSort=salesrankを指定した場合、一番売れている商品が最初、一番売れていない商品が最後に表示される順番でのリストとなるべきですが、Amazonサイトでのsalesrank情報の変動が頻繁なため、ECSとのsalesrank順位表示が、見かけ上順番どおりに表示されない場合があります。ECSでは、salesrank情報の変動に極力合わせ、Amazonサイトでの現在売れている順番と同じ並び順で商品の表示を返しています
代替手段の一つとして、現状USにおいては、トップ10商品データを取得する際に、TopSellersのresponse groupを利用することが可能で、この場合は、全てのアイテムが順番表示ごと正しく表示されます。
salesrank 順に並べ替えられたItemSearch のリクエストを行う際に発生します。
ItemSearchにおいて、power サーチを利用してsort parameterを指定した場合、sort parameterを指定しなかった場合と別のサーチ結果が表示される場合がある点 同内容のリクエストを、sort parameter の指定ありとなしで2度行った場合、別の結果が表示される場合があります。 ItemSearch において、power サーチを使用した際に発生することがあります。
ItemSearchにおいてpower サーチを利用した場合、pubdate パラメータが正常に動作していない点 このpubdateパラメータは、しばしば指定した値に合致した結果を表示しないケースがあります。 ItemSearch の power サーチにおいて、pubdate を使用した際に発生します。
リストへのアクセス権変更が、24時間経過しないとECSに反映されない場合がある点 ListSearchでは、公開されたリストのみが検索対象となっています。検索の際に使用するsearch indexが24時間ごとに更新されている関係上、ListSearchで得られる結果とListLookupで得られる結果に違いがある(いずれかでは表示されるが、他方では表示されない)場合が、最大24時間にわたり発生する可能性があります。 リストへのアクセス権変更後24時間以内に ListSearch のリクエストを行った際、発生することがあります。
Relevancy rankがblended searchで動作しない点 Relevancy rankは、通常sales rankと関連しています。ただし、現状、ItemSearchにおいてblended searchを行った場合、relevancy rankは正常な値が示されないケースがあります。 ItemSearch リクエストにおいて、SearchIndex を "Blended" と指定し、sort パラメータを relevancy と指定した際に発生することがあります。
商品により、発送可能時期データの更新に通常以上の時間がかかることがある点 商品の発送可能時期情報は、AmazonのサイトとECSに表示されるデータとの間に更新のための時間差があります。それぞれのSearch Indexに含まれるいくつかの商品において、その更新に通常以上の時間がかかることがあります。この更新の時間差により、ItemSearchにおいて、Availability(発送可能時期)パラメータをAvailableにした場合においても、本来は入手不可能なものが表示されてしまう危険性があります。正確な発送可能時期を確認するためには、OfferResponseGroupを利用し、その結果入手可能というデータが表示された場合は、実際にその商品が入手可能であるとご判断いただけます。 レスポンスにおいて、商品の発送可能時期情報 (Availability) を表示させるリクエストを行った際に発生することがあります。
GZIPが動作しない点 XMLのレスポンスが、適切なAccept-Encoding headerがリクエストの際に送信されていても、現状GZIP圧縮ファイルとして返されません。 GZIP圧縮したレスポンスを要求するリクエストを行った際に発生します。
結果が数ページにわたる場合に、ページを進めるに従って総ページ数表示が少ない数になる点 検索結果の最適化による類似する商品のグルーピングは、商品が表示されるまで行われないため、検索結果ページが何度か表示され、グルーピングが行われると、総ページ数が減ることがあります。 アプリケーションやwebサイトにおいて、総ページ数 (TotalPages) 要素を使用しようとした際に発生することがあります。
Relevancy scoreの値が、予期せぬ結果である場合がある点 Relevancy scoreは、単語の表示頻度によって決定されています。このアルゴリズムは、しばしば予期せぬ表示結果をひきおこすことがあります。例えば、”laptop”という言葉がコンピュータの商品カテゴリにおいて最も適切なものと予想していたにもかかわらず、relevancy scoreは、スポーツの商品カテゴリにおいてより高い値を示すことがあります。この場合、”laptop bag”などの商品名をもつ商品群がスポーツの商品に多く存在することなどにより発生します。 relevancy によってソートされたItemSearch の結果を求めるリクエストを行った際に発生することがあります。
ListItemIdに対するvalidationがcart operationにおいて動作しないことがある点. Cart operationにおいて、ListItemIdに対するValidationが動作しない場合があります。ListItemIdがASINに紐づいていない場合は、cart operationは可能となります。 ListItemId を使用したリストから、商品をカートに加えようとした際に発生することがあります。
MerchantIdを利用したサーチ結果の絞込みができない場合がある点(USのみ) MerchantId は、本、ミュージック(クラシック音楽以外)、クラシック音楽、ビデオ、携帯電話、DVD、コミュニティ、ウィッシュリスト、Targetおよび全てのインターナショナルストア(US以外のストア)では使われておりません。このため、上記の商品カテゴリにおいては、MerchantId を使用したサーチ結果の絞込みはできません。もしこれを使用しようとした場合、指定した MerchantId 以外のマーチャントにより販売されている商品が表示されるなどの、予期せぬ結果が表示される可能性があります。 MerchantId を使用してItemSearch を行った際に発生します。.
SellerLookupにおいて、Seller Nameや正しい該当国情報が表示されない場合がある点 SellerLookupの結果が、正しい SellerName 情報または正しい該当国情報 (Location) を表示しない場合があります。 SellerName または Location の値を使用するアプリケーションやWebサイトにおいて発生することがあります。
ItemLookupが、一部のeditorial reviewを表示しない点 ItemLookupは、現状Amazonによって書かれたeditorial reviewのみ表示し、それ以外は表示しません。 他のWebサイトにおいて作成された editorial review は、ItemLookup では返すことはできません。
Feature項目がItemAttributesにおいて表示されない点 ECS 4.0では、ECS 3.0のItemAttributesにおいて表示されていたFeature項目が表示されていません。 ECS 3.0のFeature 項目を使用しているアプリケーションやWebサイトが、ECS 4.0を使用しようとした際に発生します。
PCHardwareのsearch indexを使用したサーチにおいて、結果がhardware商品でない場合がある点(US, DEのみ) ItemSearchにおいて、 PCHardwareのsearch indexを指定した場合、hardware以外の商品も表示されます。なお、このsearch indexは2007年1月現在、USおよびDEのみで使用されています。  
ItemSearchにおいて、Powerパラメータを使用した場合、正しい日付データが表示されない場合がある点 ItemSearchにおいて、正確な日付を指定したサーチをPowerパラメータにおいて使用した場合、正しい結果が出ない場合があります。日付の範囲指定を行った場合は、正しい結果が表示されます。 ItemSearch におけるPower サーチで、正確な日付を指定した際に発生します。.
ListTypeをWeddingRegistryと指定したにもかかわらず、WishListが表示される点 ListLookupを使用する際に、ListType を“WeddingRegistry” と指定した場合、WeddingRegistryおよびWishListのデータが表示されます。これらは、ListId が同一の場合に表示されます。同じListLookupオペレーションを、ListType を“WishList”と指定した場合は、WishListのみが正しく表示されます。 "WeddingRegistry" のListType を指定してListLookup リクエストを作成した際に発生することがあります。
カスタマーレビューが、必ずしもAmazonサイトに表示されるものと同期していない点 サーチ結果において表示されるCustomer Reviewのデータは、Amazonサイトに表示されるレビューと同期していない場合があり、いくつかのレビューが表示されないことがあります。 カスタマーレビューを返すアプリケーションを使用した際に発生することがあります。
一部の商品において、ReleaseDate が表示されない点 DVDなど一部の商品において、ReleaseDate(発売日データ)が表示されない場合があります。このため、発売日順にソートした場合などに、不正な並び順で商品が表示されることがあります。 ReleaseDate 要素を使用するアプリケーションやWebサイトにおいて、発生することがあります。

ItemSearch において、Keywords パラメータとして、クオーテーションで囲んだフレーズによるサーチを行った場合、正しく動作しない場合がある点

ItemSearch の keywords フィールドにおいて、クオーテーションで囲んだフレーズによるサーチは、本来であればフレーズとして全体に合致するもののサーチ結果を表示すべきですが、個別のキーワードとして処理され、フレーズとしては処理されません。例えば、Keywords="the last time" と指定した場合、"the" "last" または "time" に合致する結果ではなく、"the last time" に合致する結果が返されるべきですが、現状そのように処理されないということになります。 ItemSearch リクエストにおいて、フレーズをキーワードに指定した際に発生します。この場合、代わりにTextStream パラメータを使用してください。
inputデータのエンコーディングの初期設定がUTF-8ではない点 JP のみが UTF8 の input データを正しくエンコーディングします。他の国は、LATIN1を初期設定として使用しています。 UTF8 環境で構築されたアプリケーションを使用する際に発生します。
TextStreamを利用したItemSearchは、全てのsearch indexで動作するとは限らない点(USのみ)

TextStreamを利用したItemSearchは、全てのSearchIndexにおいて動作するわけではなく、例えばTools, SoftwareおよびJewelryストアなどでは動作しません。なお、このTextStreamサーチは、2007年1月現在、USのみにて有効です。

TextStream パラメータを使用したアプリケーションやWebサイトにおいて発生します。