2004年10月13日

Amazon E-Commerce Service 4.0（和訳）Migration Guide

Migration Guide
移行（バージョンアップ）ガイド


If you are an existing Amazon Web Services (AWS) 2.0 or 3.0 developer, you can use this guide to understand how to migrate your AWS applications to Amazon E-Commerce Service (ECS) 4.0. This guide will provide information about migrating requests and obtaining the desired information in your responses.
もしあなたが、既存のAmazon Web Services (AWS) 2.0 又は3.0の開発者ならば、アプリケーションをAmazon E-Commerce Service (ECS) 4.0にアップグレードする方法を理解するために、このガイドを読むと良い。このガイドはリクエストの移行とレスポンスの中から希望する情報を取り出す方法について書かれています。

※訳注：このガイドは既存のアプリケーションをECS4.0にバージョンアップさせるための補助となるガイドです。新規開発者は読み飛ばしても良いかというと、最後のResponse Typeは読んでおいたほうがためになるとおもいます。

Before you migrate to ECS 4.0, here are a few things to consider:
ECS4.0に移行する前に、下記のいくつかの事に注意してください。:

  • ECS 4.0 is not backwards compatible with versions 2.0 and 3.0. The Amazon Web Services team chose to create an all new API for ECS 4.0 that is more usable and consistent. Functionally, ECS 4.0 is essentially the same as AWS 2.0 and 3.0; you will be able to retrieve all the same information. However, you'll access the information through a different set of request types or "operations."
    ECS 4.0 は既存の2.0、3.0とは下位互換性が全くありません。私たちアマゾンウェブサービスの開発チームは、 使いやすく首尾一貫したIFにするために、すべてのAPIを一新しました。ECS4.0は論理上、AWS 2.0 ,3.0と同等の機能を備えています。今まで、取得することができた情報と同等の情報は、ECS4.0でも取得することができます。しかし、それのためには今までと異なる命令セットを利用しなければなりません。

  • ECS 4.0 was designed in a way that will allow Amazon to add more features over time. Limitations in versions 2.0 and 3.0 do not permit Amazon to expand the APIs in a flexible manner. Features in 4.0, such as Response Groups and Service Versioning, make the new API much more extensible.
    ECS 4.0 はアマゾンが将来的により多くの機能を追加できるように設計しています。既存の2.0,3.0ではこの部分に制約があり、自在にAPIを拡張していくことが困難でした。しかし、4.0のResponse Groups とService Versioningという特徴は、新しいAPIを自在に追加できるようになっています。

    ※訳注（意訳）：既存の2.0,3.0というAPIでは設計が綺麗ではなかったため、柔軟に拡張することがとても困難な状況でした。そこで、ECS,4.0ではResponse Groups とService Versioningという概念を取り入れることにより、新しいAPIを自在に拡張できるようになりました。しかし、このため、IFが一新され、既存の2.0,3.0のAPIとは完全に互換性がなくなりました。

  • Migration to ECS 4.0 is suggested, but not required. Amazon does not plan to deprecate AWS 3.0 for the foreseeable future. If you are using AWS 2.0, we recommend that you at least upgrade to AWS 3.0. The differences between 2.0 and 3.0 are minimal. You can upgrade your REST requests by replacing "2" in your requests with "3". For example, For SOAP, you can migrate by rebuilding your application using the AWS 3.0 WSDL, which located at http://soap.amazon.com/schemas3/AmazonWebServices.wsdl for the US. The 3.0 WSDLs for UK/DE and JP are located at http://soap-eu.amazon.com/schemas3/AmazonWebServices.wsdl and http://soap.amazon.co.jp/schemas3/AmazonWebServices.wsdl, respectively.
    ECS 4.0への移行はなるべくなら、したほうが良いと思いますが、絶対ではありません。現時点では、アマゾンはAWS3.0を使うことに対して問題となる要素は無いと考えています。しかしながら、あなたが使っているのがAWS2.0ならばAWS3.0へ移行することを強くお勧めします。AWS2.0と3.0の差分はほとんどありません。RESTリクエストの２と３を入れ替えるだけでアップグレードできるはずです。たとえば、SOAPアプリケーションならばAWS 3.0 WSDLを使ってアプリケーションをコンパイルし直すだけで済むはずです。このファイルはUSならばhttp://soap.amazon.com/schemas3/AmazonWebServices.wsdl にUK DE JPならばhttp://soap-eu.amazon.com/schemas3/AmazonWebServices.wsdlhttp://soap.amazon.co.jp/schemas3/AmazonWebServices.wsdl,に置いてあります。.

To try out the sample requests in this guide, you will need to register for an Amazon Web Services Subscription ID at http://www.amazon.com/gp/aws/registration/registration-form.html.
このサンプルにあるアプリケーションを試すためには、以下のURLでアマゾンウェブサービスに登録しSubscription IDを取得する必要があります。http://www.amazon.com/gp/aws/registration/registration-form.html.

This migration guide uses REST requests to demonstrate how to migrate to ECS 4.0. SOAP requests may be migrated to the same ECS operations described below. Additionally, only AWS 3.0 requests are included in this guide. Everything that applies to AWS 3.0 requests applies to AWS 2.0 as well.
この移行ガイドにある、ECS4.0にどのようにアップグレードしたらよいかサンプルはRESTリクエストを使って書かれています。SOAPリクエストを移行する場合も下記にあるRESTリクエストの場合とほぼ同様になります。また、ガイド中のサンプルはすべてAWS 3.0で書かれていますが、すべてのリクエストはAWS 2.0と同様です。

※訳注(意訳)：この移行ガイドのサンプルはすべて、AWS 3.0のRESTリクエストからECS 4.0のRESTリクエストへの移行という形で書かれています。SOAPの移行の場合も下記の移行とほぼ同じ手順で移行できますし、移行元がAWS 2.0の場合も同様の手順で移行できます。

Request Types
リクエストタイプ

For each request type that was available in AWS 2.0 and 3.0, we have provided equivalent requests (or operations) in Amazon E-Commerce Service 4.0.
AWS 2.0,3.0に存在していたリクエストタイプをアマゾンECS4.0のリクエストを使って書き直したサンプルを以下に記述します。

Notes:
注意事項:

  • We have included the AssociateTag parameter for all the ECS 4.0 requests below. This is not a required parameter; you may omit it if you are not an Associate.
    私たちは以下の全てのサンプルにアソシエイトで利用するAssociateTagを入れてあります。しかし、あなたが、アソシエイトをしないのであれば、このパラメータは省略可能です。

  • The ECS 4.0 requests for product information below use the Medium response group. Unlike the "lite" response type from 2.0 and 3.0, Medium does not return availability. To get availability information for products sold by Amazon, you must include the Offers, OfferFull, or Large response groups in your request. If you wish to obtain availability information for products sold by other vendors, you must also include MerchantId=All in your requests.
    サンプルのECS 4.0リクエストは response groupにMediumを指定してあります。これはAWS2.0,3.0で指定できた"lite"と異なり在庫状況を含んでいません。アマゾンが販売している商品の在庫状況を取得するためには、Offers, OfferFull,を追加するか、Large をresponse groups として指定してください。もし、アマゾンの他の売り手の在庫（つまりマーケットプレイスのような）を取得したい場合はMerchantId=Allをリクエストに含めてください。

ActorSearch
役者検索（ActorSearchリクエスト）

Use the ItemSearch operation in Amazon E-Commerce Service.
ActorSearchリクエストはECS4.0ではItemSearch オペレーションを使って行います。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ActorSearch=Tom%20Hanks
    &mode=dvd
    &type=lite
    &f=xml
DE 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ActorSearch=Tom%20Hanks
    &mode=dvd-de
    &type=lite
    &f=xml
    &locale=de
JP 
http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ActorSearch=Tom%20Hanks
    &mode=dvd-jp
    &type=lite
    &f=xml
    &locale=jp
UK 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ActorSearch=Tom%20Hanks
    &mode=dvd-uk
    &type=lite
    &f=xml
    &locale=uk
ECS 4.0 request(s):
Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=DVD
    &Actor=Tom%20Hanks
    &ResponseGroup=Medium
DE 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=DVD
    &Actor=Tom%20Hanks
    &ResponseGroup=Medium
JP 
http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=DVD
    &Actor=Tom%20Hanks
    &ResponseGroup=Medium
UK 
http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=DVD
    &Actor=Tom%20Hanks
    &ResponseGroup=Medium

ArtistSearch
アーティスト検索（ArtistSearchリクエスト）

Use the ItemSearch operation in Amazon E-Commerce Service.
ArtistSearchリクエストはECS4.0ではItemSearch オペレーションを使って行います。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ArtistSearch=Rolling%20Stones
    &mode=music
    &type=lite
    &f=xml
DE 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ArtistSearch=Rolling%20Stones
    &mode=music
    &type=lite
    &f=xml
    &locale=de
JP 
http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ArtistSearch=Rolling%20Stones
    &mode=music-jp
    &type=lite
    &f=xml
    &locale=jp
UK 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ArtistSearch=Rolling%20Stones
    &mode=music
    &type=lite
    &f=xml
    &locale=uk
ECS 4.0 request(s):
Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Music
    &Artist=Rolling%20Stones
    &ResponseGroup=Medium
DE 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Music
    &Artist=Rolling%20Stones
    &ResponseGroup=Medium
JP 
http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Music
    &Artist=Rolling%20Stones
    &ResponseGroup=Medium
UK 
http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Music
    &Artist=Rolling%20Stones
    &ResponseGroup=Medium

AsinSearch
Asinコード検索（AsinSearchリクエスト）

Use the ItemLookup operation in Amazon E-Commerce Service.
AsinSearchリクエストはECS4.0ではItemSearch オペレーションを使って行います。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &AsinSearch=0596005423
    &type=lite
    &f=xml
DE 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &AsinSearch=0596005423
    &type=lite
    &f=xml
    &locale=de
JP 
http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &AsinSearch=0596005423
    &type=lite
    &f=xml
    &locale=jp
UK 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &AsinSearch=0596005423
    &type=lite
    &f=xml
    &locale=uk
ECS 4.0 request(s):
Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemLookup
    &ItemId=0596005423
    &ResponseGroup=Medium
DE 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemLookup
    &ItemId=0596005423
    &ResponseGroup=Medium
JP 
http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemLookup
    &ItemId=0596005423
    &ResponseGroup=Medium
UK 
http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemLookup
    &ItemId=0596005423
    &ResponseGroup=Medium

AuthorSearch
著者検索（AuthorSearchリクエスト）

Use the ItemSearch operation in Amazon E-Commerce Service.
AutorSearchリクエストはECS4.0ではItemSearch オペレーションを使って行います。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &AuthorSearch=Shel%20Silverstein
    &mode=books
    &type=lite
    &f=xml
DE 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &AuthorSearch=Shel%20Silverstein
    &mode=books
    &type=lite
    &f=xml
    &locale=de
JP 
http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &AuthorSearch=Shel%20Silverstein
    &mode=books
    &type=lite
    &f=xml
    &locale=jp
UK 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &AuthorSearch=Shel%20Silverstein
    &mode=books
    &type=lite
    &f=xml
    &locale=uk
ECS 4.0 request(s):
Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Books
    &Author=Shel%20Silverstein
    &ResponseGroup=Medium
DE 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Books
    &Author=Shel%20Silverstein
    &ResponseGroup=Medium
JP 
http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Books
    &Author=Shel%20Silverstein
    &ResponseGroup=Medium
UK 
http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Books
    &Author=Shel%20Silverstein
    &ResponseGroup=Medium

BlendedSearch
複合検索（BlendedSearchリクエスト)

Use the ItemSearch operation in Amazon E-Commerce Service.
BlenddedSearchリクエストはECS4.0ではItemSearch オペレーションを使って行います。

AWS 2.0 and 3.0 returned more product groups than are available for ECS 4.0 responses. ECS 4.0 returns items from up to 12 product groups for the US.
AWS 2.0,3.0は多くの商品グループを返しましたが、ECS4.0はUAのために最大１２のグループを返すのみです。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &BlendedSearch=digital
    &type=lite
    &f=xml
DE 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &BlendedSearch=digital
    &type=lite
    &f=xml
    &locale=de
JP 
http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &BlendedSearch=digital
    &type=lite
    &f=xml
    &locale=jp
UK 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &BlendedSearch=digital
    &type=lite
    &f=xml
    &locale=uk
ECS 4.0 request(s):
Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Blended
    &Keywords=digital
    &ResponseGroup=Medium
DE 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Blended
    &Keywords=digital
    &ResponseGroup=Medium
JP 
http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Blended
    &Keywords=digital
    &ResponseGroup=Medium
UK 
http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Blended
    &Keywords=digital
    &ResponseGroup=Medium

BrowseNodeSearch
閲覧箇所検索（BrowseNodeSearchリクエスト）

Use the ItemSearch operation in Amazon E-Commerce Service.
BrowseNodeSearchリクエストはECS4.0ではItemSearch オペレーションを使って行います。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &BrowseNodeSearch=289814
    &mode=kitchen
    &type=lite
    &f=xml
DE 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &BrowseNodeSearch=3429941
    &mode=kitchen-de
    &type=lite
    &f=xml
    &locale=de
JP 
http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &BrowseNodeSearch=3895781
    &mode=kitchen-jp
    &type=lite
    &f=xml
    &locale=jp
UK 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &BrowseNodeSearch=10707831
    &mode=kitchen-uk
    &type=lite
    &f=xml
    &locale=uk
ECS 4.0 request(s):
Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Kitchen
    &BrowseNode=289814
    &ResponseGroup=Medium
DE 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Kitchen
    &BrowseNode=3429941
    &ResponseGroup=Medium
JP 
http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Kitchen
    &BrowseNode=3895781
    &ResponseGroup=Medium
UK 
http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Kitchen
    &BrowseNode=10707831
    &ResponseGroup=Medium

DirectorSearch
監督検索(DirectorSearchリクエスト)

Use the ItemSearch operation in Amazon E-Commerce Service.
DirectorSearchリクエストはECS4.0ではItemSearch オペレーションを使って行います。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &DirectorSearch=Stephen
    &mode=dvd
    &type=lite
    &f=xml
DE 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &DirectorSearch=Stephen
    &mode=dvd-de
    &type=lite
    &f=xml
    &locale=de
JP 
http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &DirectorSearch=Stephen
    &mode=dvd-jp
    &type=lite
    &f=xml
    &locale=jp
UK 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &DirectorSearch=Stephen
    &mode=dvd-uk
    &type=lite
    &f=xml
    &locale=uk
ECS 4.0 request(s):
Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=DVD
    &Director=Stephen 
    &ResponseGroup=Medium
DE 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=DVD
    &Director=Stephen
    &ResponseGroup=Medium
JP 
http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=DVD
    &Director=Stephen
    &ResponseGroup=Medium
UK 
http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=DVD
    &Director=Stephen 
    &ResponseGroup=Medium

ExchangeSearch
マーケットプレイス検索（ExchangeSearchリクエスト）

Use the SellerListingLookup operation in Amazon E-Commerce Service.
ExchangeSearchリクエストはECS4.0ではSellerListingLookup オペレーションを使って行います。

If the requests below do not return product information, it is because the product associated with the Exchange ID in the requests is no longer available on Amazon. You can find a new Exchange ID on Amazon by searching for products from this page: http://s1.amazon.com/exec/varzea/subst/search/fixed-search.html. On the search results page, click through one of the Marketplace results to a product page and copy the Exchange ID from the product page URL. You may access the equivalent page for UK and Germany (just change the domain). This search page is not available for Japan.
下記のリクエストが商品情報を返さない場合は、それはExchangeIDがもはや有効では無くなったからです。あたらしいExchange IDを探すためにアマゾンで検索をしてください。検索はこちらのページからどうぞ。http://s1.amazon.com/exec/varzea/subst/search/fixed-search.html. マーケットプレースでの検索結果の商品から、１つえらんでクリックをして、商品ページに移動して、そこにある、Exchange IDを取得して、下記のサンプルのExchange IDと差し替えてください。UKとGEの場合は上記のURLのドメインを差し替えるだけでマーケットプレースにアクセスできます。日本向けには同様のサービスはありません。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ExchangeSearch=Y01Y5724325Y5991762
    &type=lite
    &f=xml
DE 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ExchangeSearch=Y06Y1097063Y3987736
    &type=lite
    &f=xml
    &locale=de
JP N/A
UK 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ExchangeSearch=Y02Y5428122Y1147650
    &type=lite
    &f=xml
    &locale=uk
ECS 4.0 request(s):
Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=SellerListingLookup
    &IdType=Exchange
    &Id=Y01Y5724325Y5991762
DE 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=SellerListingLookup
    &IdType=Exchange
    &Id=Y06Y1097063Y3987736
JP 
http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=SellerListingLookup
    &IdType=Exchange
    &Id=Y01Y4720792Y1657030
UK 
http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=SellerListingLookup
    &IdType=Exchange
    &Id=Y02Y5428122Y1147650

KeywordSearch
キーワード検索（KeywordSearchリクエスト）

Use the ItemSearch operation in Amazon E-Commerce Service.
KeywordSearchリクエストはECS4.0ではItemSearch オペレーションを使って行います。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &KeywordSearch=zoom
    &mode=photo
    &type=lite
    &f=xml
DE 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &KeywordSearch=zoom
    &mode=photo-de
    &type=lite
    &f=xml
    &locale=de
JP 
http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &KeywordSearch=zoom
    &mode=photo-jp
    &type=lite
    &f=xml
    &locale=jp
UK 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &KeywordSearch=zoom
    &mode=photo-uk
    &type=lite
    &f=xml
    &locale=uk
ECS 4.0 request(s):
Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Photo
    &Keywords=zoom
    &ResponseGroup=Medium
DE 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Photo
    &Keywords=zoom
    &ResponseGroup=Medium
JP 
http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Electronics
    &Keywords=zoom
    &ResponseGroup=Medium
UK 
http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Electronics
    &Keywords=zoom
    &ResponseGroup=Medium

ListManiaSearch
リストマニア検索（ListManiaSearchリクエスト）

Use the ListLookup operation in Amazon E-Commerce Service.
ListManiaSearchリクエストはECS4.0ではItemSearch オペレーションを使って行います。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ListManiaSearch=2AZKKQ1OSDCEI
    &type=lite
    &f=xml
DE 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ListManiaSearch=QP0PXSFUUTON
    &type=lite
    &f=xml
    &locale=de
JP 
http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ListManiaSearch=4591YGFA86K5
    &type=lite
    &f=xml
    &locale=jp
UK 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ListManiaSearch=24T87OWV0V1YT
    &type=lite
    &f=xml
    &locale=uk
ECS 4.0 request(s):
Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ListLookup
    &ListType=Listmania
    &ListId=2AZKKQ1OSDCEI
    &ResponseGroup=ListFull,Medium
DE 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ListLookup
    &ListType=Listmania
    &ListId= QP0PXSFUUTON
    &ResponseGroup=ListFull,Medium
JP 
http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ListLookup
    &ListType=Listmania
    &ListId= 4591YGFA86K5
    &ResponseGroup=ListFull,Medium
UK 
http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ListLookup
    &ListType=Listmania
    &ListId=24T87OWV0V1YT
    &ResponseGroup=ListFull,Medium

ManufacturerSearch
製造社名検索（ManufacturerSearchリクエスト）

Use the ItemSearch operation in Amazon E-Commerce Service.
ManufacturerリクエストはECS4.0ではItemSearch オペレーションを使って行います。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ManufacturerSearch=Dewalt
    &mode=tools
    &type=lite
    &f=xml
DE 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ManufacturerSearch=Dewalt
    &mode=tools-de
    &type=lite
    &f=xml
    &locale=de
JP 
http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ManufacturerSearch=Sony
    &mode=electronics-jp
    &type=lite
    &f=xml
    &locale=jp
UK 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ManufacturerSearch=Dewalt
    &mode=tools-uk
    &type=lite
    &f=xml
    &locale=uk
ECS 4.0 request(s):
Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &Operation=ItemSearch
    &SearchIndex=Tools
    &Manufacturer=Dewalt
    &ResponseGroup=Medium
DE 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &Operation=ItemSearch
    &SearchIndex=Tools
    &Manufacturer=Dewalt
    &ResponseGroup=Medium
JP 
http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Electronics
    &Manufacturer=Sony
    &ResponseGroup=Medium
UK 
http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=DVD
    &Actor=Tom%20Hanks
    &ResponseGroup=Medium

MarketplaceSearch
マーケットプレース検索（MarketplaceSearchリクエスト）

Use the SellerListingSearch operation in Amazon E-Commerce Service.
MarketplaceSearchリクエストはECS4.0ではSellerListingSearch オペレーションを使って行います。

AWS 3.0 request(s):

These AWS 3.0 requests are similar to ECS 4.0's SellerListingSearch with the Keywords parameter.
titledescによるAWS 3.0リクエストはECS4.0ではSellerListingSearchをキーワード検索するのと似ています。

Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &MarketplaceSearch=keyword
    &f=xml
    &type=heavy
    &keyword=bagpipes
    &keyword-search=titledesc
DE 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &MarketplaceSearch=keyword
    &f=xml
    &type=heavy
    &keyword=bagpipes
    &keyword-search=titledesc
    &locale=de
UK 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &MarketplaceSearch=keyword
    &f=xml
    &type=heavy
    &keyword=bagpipes
    &keyword-search=titledesc
    &locale=uk

These AWS 3.0 requests are similar to ECS 4.0's SellerListingSearch with the Title parameter.
titleによるAWS 3.0リクエストはECS4.0ではSellerListingSearchをタイトル検索するのと似ています。

Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &MarketplaceSearch=keyword
    &f=xml
    &type=heavy
    &keyword=how%20to%20play
    &keyword-search=title
DE 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &MarketplaceSearch=keyword
    &f=xml
    &type=heavy
    &keyword=how%20to%20play
    &keyword-search=title
    &locale=de
UK 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &MarketplaceSearch=keyword
    &f=xml
    &type=heavy
    &keyword=how%20to%20play
    &keyword-search=title
    &locale=uk
ECS 4.0 request(s):

SellerListingSearch requests with the Keywords parameter.
上記例上段の例に対応するキーワードによる検索です。

Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=SellerListingSearch
    &Keywords=bagpipes
DE 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &Operation=SellerListingSearch
    &Keywords=bagpipes
UK 
http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &Operation=SellerListingSearch
    &Keywords=bagpipes

SellerListingSearch requests with the Title parameter.
上記例下段の例に対応するタイトルによる検索です。

Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=SellerListingSearch
    &Title=how%20to%20play
DE 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=%5bASSOCIATE_TAG%5d
    &Operation=SellerListingSearch
    &Title=how%20to%20play
UK 
http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=%5bASSOCIATE_TAG%5d
    &Operation=SellerListingSearch
    &Title=how%20to%20play

PowerSearch
パワーサーチ（PowerSearchリクエスト)

Use the ItemSearch operation in Amazon E-Commerce Service.
ManufacturerリクエストはECS4.0ではItemSearch オペレーションを使って行います。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &PowerSearch=pubdate:2003%20subject:dog
    &mode=books
    &type=lite
    &f=xml
DE 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &PowerSearch=pubdate:2003%20subject:history
    &mode=books-de
    &type=lite
    &f=xml
    &locale=de
JP 
http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &PowerSearch=title:luck
    &mode=books-de
    &type=lite
    &f=xml
    &locale=jp
UK 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &PowerSearch=pubdate:2003%20subject:dog
    &mode=books-uk
    &type=lite
    &f=xml
    &locale=uk
ECS 4.0 request(s):
Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Books
    &Power=pubdate:2003%20subject:dog
    &ResponseGroup=Medium
DE 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Books
    &Power=pubdate:2003%20subject:history
    &ResponseGroup=Medium
JP 
http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Books
    &Power=title:luck
    &ResponseGroup=Medium
UK 
http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Books
    &Power=pubdate:2003%20subject:dog
    &ResponseGroup=Medium

SellerSearch
売り手検索（SellerSearchリクエスト）

Use the SellerLookup and SellerListingSearch operations in Amazon E-Commerce Service.
SellerSearchリクエストはECS4.0ではSellerLookup またはSellerListingSearchオペレーションを使って行います。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &SellerSearch=ASYDZOX0HKBSE
    &type=lite
    &f=xml
ECS 4.0 request(s):

Use SellerLookup to get seller profile information, including feedback.
フィードバックを含む売り手プロファイル情報を得るためにはSellerLookupを使います。

Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=SellerLookup
    &SellerId=ASYDZOX0HKBSE

Use SellerListingSearch to get seller product information.
売り手の商品情報を取得するためにはSellerListingSearchを使います。

Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=SellerListingSearch
    &SellerId=ASYDZOX0HKBSE

One step further: Using the multi-operation functionality in ECS 4.0, you can make both of the above ECS requests in one call to Amazon.
さらにECS 4.0のマルチ‐オペレーション機能性を使う事でアマゾンへ 1回のリクエストで上記の両方の結果を得る事もできます。

Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=SellerLookup,SellerListingSearch
    &SellerLookup.1.SellerId=ASYDZOX0HKBSE
    &SellerListingSearch.1.SellerId=ASYDZOX0HKBSE

ShoppingCart (Add)
ショッピングカートへの追加

Use the CartCreate and CartAdd operations in Amazon E-Commerce Service.
ショッピングカートへの追加はECS4.0ではCartCreateとCartAddオペレーションを使って行います。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ShoppingCart=add
    &Asin.0894802046=1
    &f=xml
DE 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ShoppingCart=add
    &Asin. B0000C6DWS =1
    &f=xml
    &locale=de
JP 
http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ShoppingCart=add
    &Asin. B0001X9BMY=1
    &f=xml
    &locale=jp
UK 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ShoppingCart=add
    &Asin. B00004RJLB =1
    &f=xml
    &locale=uk
ECS 4.0 request(s):

Use the CartCreate operation to create the cart and add the initial contents.
ショッピングカートを作って、最初の商品たちを追加するためにはCartCreateオペレーションを使います。

Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=CartCreate
    &Item.1.ASIN=B000067DNF
    &Item.1.Quantity=1
DE 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &Operation=CartCreate
    &Item.1.ASIN=B0000C6DWS
    &Item.1.Quantity=1
JP 
http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &Operation=CartCreate
    &Item.1.ASIN=B0001X9BMY
    &Item.1.Quantity=1
UK 
http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &Operation=CartCreate
    &Item.1.ASIN=B00004RJLB
    &Item.1.Quantity=1

Once the cart is created, use the CartAdd operation to add more items to the cart.
一回ショッピングカートを作成したら、CartAddオペレーションを使って商品を追加します。

Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=CartAdd
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &Item.1.ASIN=0894802046
    &Item.1.Quantity=1
DE 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=CartAdd
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &Item.1.ASIN=B0002UE1MG
    &Item.1.Quantity=1
JP 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=CartAdd
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &Item.1.ASIN=4591081451
    &Item.1.Quantity=1
UK 
http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=CartAdd
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &Item.1.ASIN=B0001ZXA7Y
    &Item.1.Quantity=1

ShoppingCart (clear)
ショッピングカートの全消去

Use the CartClear operation in Amazon E-Commerce Service.
ショッピングカートの全消去はECS4.0ではCartClearオペレーションを使って行います。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ShoppingCart=clear
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &f=xml
DE 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ShoppingCart=clear
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &f=xml
    &locale=de
JP 
http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ShoppingCart=clear
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &f=xml
    &locale=jp
UK 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ShoppingCart=clear
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &f=xml
    &locale=uk
ECS 4.0 request(s):
Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=CartClear
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
DE 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=CartClear
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
JP 
http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=CartClear
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
UK 
http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=CartClear
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]

ShoppingCart (Get)
ショッピングカートの中身を見る

Use the CartGet operation in Amazon E-Commerce Service.
ショッピングカートの中身を見るためにはECS4.0ではCartGetオペレーションを使います。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ShoppingCart=get
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &f=xml
DE 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ShoppingCart=get
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &f=xml
    &locale=de
JP 
http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ShoppingCart=get
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &f=xml
    &locale=jp
UK 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ShoppingCart=get
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &f=xml
    &locale=uk
ECS 4.0 request(s):
Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=CartGet
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
DE 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=CartGet
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
JP 
http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=CartGet
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
UK 
http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=CartGet
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]

ShoppingCart (Modify)
ショッピングカートの修正

Use the CartModify operation in Amazon E-Commerce Service.
ショッピングカートの修正を行うためにはECS4.0ではCartModifyオペレーションを使います。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ShoppingCart=modify
    &Item.[Cart Item ID Here]=3
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &f=xml
DE 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ShoppingCart=modify
    &Item.[Cart Item ID Here]=3
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &f=xml
    &locale=de
JP 
http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ShoppingCart=modify
    &Item.[Cart Item ID Here]=3
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &f=xml
    &locale=jp
UK 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ShoppingCart=modify
    &Item.[Cart Item ID Here]=3
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &f=xml
    &locale=uk
ECS 4.0 request(s):
Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=CartModify
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &Item.1.CartItemId=[Cart Item ID Here]
    &Item.1.Quantity=3
DE 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=CartModify
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &Item.1.CartItemId=[Cart Item ID Here]
    &Item.1.Quantity=3
JP 
http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=CartModify
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &Item.1.CartItemId=[Cart Item ID Here]
    &Item.1.Quantity=3
UK 
http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=CartModify
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &Item.1.CartItemId=[Cart Item ID Here]
    &Item.1.Quantity=3

ShoppingCart (Remove)
ショッピングカート削除

Use the CartModify operation in Amazon E-Commerce Service.
ショッピングカートからアイテムを削除するためには、CartModify オペレーションを使います。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ShoppingCart=remove
    &Item.[Cart Item ID Here]
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &f=xml
DE 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ShoppingCart=remove
    &Item.[Cart Item ID Here]
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &f=xml
    &locale=de
JP 
http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ShoppingCart=remove
    &Item.[Cart Item ID Here]
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &f=xml
    &locale=jp
UK 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &ShoppingCart=remove
    &Item.[Cart Item ID Here]
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &f=xml
    &locale=uk
ECS 4.0 request(s):
Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=CartModify
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &Item.1.CartItemId=[Cart Item ID Here]
    &Item.1.Quantity=0
DE 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=CartModify
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &Item.1.CartItemId=[Cart Item ID Here]
    &Item.1.Quantity=0
JP 
http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=CartModify
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &Item.1.CartItemId=[Cart Item ID Here]
    &Item.1.Quantity=0
UK 
http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=CartModify
    &CartId=[Your Cart ID Here]
    &HMAC=[Your HMAC Here]
    &Item.1.CartItemId=[Cart Item ID Here]
    &Item.1.Quantity=0

SimilaritySearch
類似品検索（SimilaritySearchリクエスト）

Use the SimilarityLookup operation in Amazon E-Commerce Service.
SimilaritySearchリクエストはECS4.0ではSimilarityLookupオペレーションを使って行います。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &SimilaritySearch=B00005N7P3
    &type=lite
    &f=xml
DE 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &SimilaritySearch=B0002TJNXE
    &type=lite
    &f=xml
    &locale=de
JP 
http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &SimilaritySearch=4569636624
    &type=lite
    &f=xml
    &locale=jp
UK 
http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &SimilaritySearch=B00009PB6N
    &type=lite
    &f=xml
    &locale=uk
ECS 4.0 request(s):
Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=SimilarityLookup
    &ItemId=B00005N7P3
    &ResponseGroup=Medium
DE 
http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=SimilarityLookup
    &ItemId= B0002TJNXE
    &ResponseGroup=Medium
JP 
http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &Operation=SimilarityLookup
    &ItemId=4569636624
    &ResponseGroup=Medium
UK 
http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=SimilarityLookup
    &ItemId= B00009PB6N
    &ResponseGroup=Medium

TextStreamSearch
テキスト検索（TextStreamSearchリクエスト)

Use the ItemSearch operation in Amazon E-Commerce Service.
TextStreamSearchリクエストはECS4.0ではItemSearchオペレーションを使って行います。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &TextStreamSearch=fast%20food%20is%20good%20and%20bad
    &mode=books
    &type=lite
    &f=xml
ECS 4.0 request(s):
Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemSearch
    &SearchIndex=Books
    &TextStream=fast%20food%20is%20good%20and%20bad
    &ResponseGroup=Medium

UpcSearch
UPC(音楽コード検索）（UpcSearchリクエスト）

Use the ItemLookup operation in Amazon E-Commerce Service.
UpcSearchリクエストはECS4.0ではItemSearchオペレーションを使って行います。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &UpcSearch=097360650549
    &mode=dvd
    &type=lite
    &f=xml
ECS 4.0 request(s):
Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ItemLookup
    &IdType=UPC
    &ItemId=097360650549
    &SearchIndex=DVD
    &ResponseGroup=Medium

WishlistSearch
ウィッシュリスト検索（WishぃｓｔSearchリクエスト）

Use the ListLookup operation in Amazon E-Commerce Service.
WishlistSearchリクエストはECS4.0ではListLookupオペレーションを使って行います。

AWS 3.0 request(s):
Locale Request
US 
http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here]
    &t=[Your Associate Tag Here]
    &WishlistSearch=2AT7V3BAJ69DX
    &type=lite
    &f=xml
ECS 4.0 request(s):
Locale Request
US 
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
    &SubscriptionId=[Your Subscription ID Here]
    &AssociateTag=[Your Associate Tag Here]
    &Operation=ListLookup
    &ListType=WishList
    &ListId=2AT7V3BAJ69DX
    &ResponseGroup=ListFull,Medium

Response Types
応答タイプ

In AWS 2.0 and 3.0, AWS developers were able to request a "lite" response or a "heavy" response for every request type. This basically gave you access to "less" or "more" data. Many developers saw these options as limiting and inflexible. Amazon E-Commerce Service 4.0 introduces the concept of Response Groups, which are logical groups of XML elements that can optionally be selected in operation requests.
AWS 2.0,3.0ではAWSの開発者はリクエストに応答の種類として"lite"か"heavy"をつけていた。しかし、基本的にこのオプションにより得られる情報は少なすぎるか、多すぎであったため、多くの開発者はこれを、限定的で自由度が無いとおもっていました。.ECS 4.0ではリクエスト時にXML エレメントを任意に指定できるResponse Groups,という論理的な概念を導入しました。

For example, if you are using the ItemSearch operation to search for products, you can use the SalesRank response group to retrieve only the SalesRank element for all the products in the response. Alternatively, you could ask for the Small response group, which returns several elements, including the product's title, product group, manufacturer, and Amazon detail page URL.
たとえば、あなたが、SalesRankを取得すためだけに、ItemSearchオペレーションを行うのであれば、response groupにSalesRankだけを指定する事で、SalesRankだけを取得できる。他にも、商品タイトル、グループ、メーカー、及び、詳細ページのURLなどの他のいくつかのエレメントを得たければ、 response groupにSmallを指定してItemSearchオペレーションを行う事で取得できる。

Response groups may contain a single element, multiple related elements, or multiple elements and one or more other response groups. Response groups that contain other response groups are called parent response groups.
Response groupsは１つのエレメントを含む物と、１つで複数のエレメントを含むものを指定する事も出来るし、それらを複数個、組み合わせて指定する事も出来る。 １つで他のいくつかのエレメントを返す応答グループは親応答グループと呼ぶ。

For products, the "lite" response type in AWS 2.0 and 3.0 roughly falls in between the Small and Medium response groups in Amazon E-Commerce Service 4.0; Small contains fewer elements than "lite", while Medium contains more elements than "lite". The "heavy" response type from AWS 2.0 and 3.0 maps roughly to Large in Amazon E-Commerce Service 4.0; Large actually contains more information than "heavy". Large is the biggest available response group for product information, and since Amazon E-Commerce Service 4.0 returns more information than was ever available in AWS 2.0 or 3.0, this is a big response group!
AWS2.0､3.0の"lite"はアマゾンECS4.0では、だいたい Small とMediumの間に存在する。Smallは"little"よりも含まれるエレメントが少ないし、Mediumは”lille”よりも多くのエレメントを含む。AWS2.0,3.0でいうところの"hevy"は、おおよそアマゾンECS4.0ではだいたい、Largeと同じぐらいである。ただし、Largeは正確には"heavy"よりも多くの内容を含んでいる。LargeはアマゾンECS4.0が返す商品情報グループの中では最大のものである。これはAWS2.0,3.0の商品情報よりもはるかに多い。Largeは本当に大きいのである。

Whereas the response types in AWS 2.0 and 3.0 were inflexible, the response groups available in Amazon E-Commerce Service 4.0 give developers much more flexibility to customize responses and get only what they want. Additionally, response groups were designed in a way that allows the AWS team to add response groups as necessary. If we find that the current set of groups does not allow developers to get just what they want, we have the ability to add new groups over time. If you have a response group idea, please feel free to post it on the AWS discussion board at http://forums.prospero.com/am-assocdevxml.
AWS2.0,3.0では応答タイプが自由度が無かったのに対して、アマゾンECS 4.0ではresponse groupsによって、開発者が自由に応答をカスタマイズして望む項目だけを取得する事が出来るようになった。そして、必要ならば、AWS チームがレスポンスを自在に追加できるように設計されている。もし、現在のresponse gourpの内容で、すべての開発者が望む応答を取得できていないのであれば、今後、私たちは、response groupsを追加していきます。もしresponse groupに意見があるのであれば、気軽に掲示板（http://forums.prospero.com/am-assocdevxml. ）に投稿してください。


Amazon E-Commerce Service 4.0（和訳） Ver1.0
日本語化：心は萌え
原文：http://www.amazon.com/gp/aws/sdk/main.html/104-4644997-2807136?s=AWSEcommerceService&v=4-0&p=MigrationArticle
原文の著作権はアマゾンに訳文の著作権は心は萌えに存在します。





p-6806241 at 04:26 │Comments(0) │TrackBack(0) │Amazon E-Commerce Service 4.0（和訳） 
このBlogのトップへ │前の記事 │次の記事

トラックバックURL

この記事にコメントする

名前:
URL:
  情報を記憶: 評価: 顔    星