SellerLookup
オペレーションは、出品者 (USサイトではマーチャント) に関する詳細な情報を返します。出品者を検索するには、出品者IDを使用します。出品者名、カスタマーによる評価の平均点、最初の5件のカスタマーフィードバックエントリが返されます。ただし、 SellerLookup
は、出品者のEメールアドレスやオフィスの住所などの情報は返しません。
![]() | 注意 |
---|---|
出品者は自分に関する情報を入力する必要があります。出品者が情報を入力しない場合もあります。この場合、
|
1回のリクエストで複数の出品者を検索するには、最大5個のSeller IDをカンマまで区切り、RESTリクエストのSellerId
パラメータで指定します。SOAPリクエストでは、リクエストに複数のSellerId
要素を指定することで、複数の出品者に関する情報を取得できます。
カスタマーは出品者を評価することができます。最高の評価は5、最低は0です。評価結果には、カスタマーによる出品者からの購買履歴が反映されます。 SellerLookup
オペレーションは、デフォルトで個々のカスタマーによるレビューコメントを返します (次の例を参照) 。
<AverageFeedbackRating>3.0</AverageFeedbackRating> <SellerFeedback> <Feedback> <Rating>1</Rating> <Date>2006-06-01T01:58+0000</Date> <RatedBy>A59KKB5O4U1NE</RatedBy> </Feedback> <Feedback> <Rating>5</Rating> <Comment>Super fast shipping and in great condition.</Comment> <Date>2006-05-07T19:57+0000</Date> <RatedBy>AYJHDY02HJ2XY</RatedBy> </Feedback>
このレスポンス例に示すように、カスタマーが入力した全ての出品者評価の平均が Seller/AverageFeedbackRating 要素で返されます。
3人の出品者に関する情報を取得する。
http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]
&
Operation=SellerLookup&
SellerId=[A Seller ID],[A Seller ID],[A Seller ID]
このリクエストに対するレスポンスをリクエスト例に対するレスポンスに示します。
フィードバックの3ページ目を返すには FeedbackPage
を使用します。
http://ecs.amazonaws.com/onca/xml? Service=AWSECommerceService& AWSAccessKeyId=[ID]
& Operation=SellerLookup& SellerId=[Seller ID]
& FeedbackPage
最大10ページのフィードバックを取得できます。1ページに表示されるフィードバックエントリは5件なので、エントリ総数は50件になります。デフォルトでは、 SellerLookup
は、指定した出品者に対するカスタマーフィードバックのうち最初の5件を返します。
名前 | 説明 | 必須 |
---|---|---|
FeedbackPage
|
返されるレビューのページを指定します。1ページに最大5件のレビューが返されます。デフォルトでは1ページ目が返されます。残りのページにアクセスするには、このパラメータを使用して表示したいページを指定します。返される最大ページ数は10ページです (50件のフィードバック項目) 。 有効な値: 1~ 10までの整数 タイプ: 文字列 デフォルト: なし | いいえ |
SellerId
|
出品者を識別する半角英数字のトークン。 有効な値: Amazon によって割り当てられた有効なSeller ID。USサイトでは、マーチャントIDを使用できます。 タイプ: 文字列 デフォルト: なし | はい |
ResponseGroup
|
返される値の種類を指定します。1つのリクエストに複数のレスポンスグループをカンマで区切って指定できます。 タイプ: 文字列 デフォルト: Seller | いいえ |
SellerLookup
には、全てのオペレーションで使用できるパラメータを指定できます。詳細については、一般的なリクエストパラメータをご参照ください。
次に示すのは、上の例の最初のリクエストで返されるレスポンスの一部です。
</SellerId> <SellerName>Amazon.com</SellerName> <SellerLegalName>Amazon.com, LLC</SellerLegalName> <GlancePage>http://www.amazon.com/gp/help/seller/at a glance.html?seller=ATVPDKIKX0DER&;marketplaceSeller=1</GlancePage> <SellerFeedback> <Feedback> <Rating>1</Rating> <Comment>As clearly indicated above, I ordered "How to Do Everything with Windows XP Home Networking" by Dave Field, but received instead "How to Do Everything with Windows XP" by Curt Simmons, a totally different book, for which I have no use.</Comment> <Date>2006-06-01T01:58+0000</Date> <RatedBy>A59KKB5O4U1NE</RatedBy> </Feedback> <Feedback> <Rating>5</Rating> <Comment>Super fast shipping and in great condition.</Comment> <Date>2006-05-07T19:57+0000</Date> <RatedBy>AYJHDY02HJ2XY</RatedBy> </Feedback> <Feedback> <Rating>1</Rating> <Comment>I STILL have not received this, four days after the promised delivery date.</Comment> <Date>2006-04-24T15:18+0000</Date> <RatedBy>A104KQK2R3U0MM</RatedBy> </Feedback> </SellerFeedback> </Seller> </Sellers> </SellerLookupResponse>
名前 | 説明 |
---|---|
AverageFeedbackRating
| 出品者の全てのカスタマー評価の平均。値は0~5の範囲で、5が最高の評価です。 |
City
| 出品者の所在地 (都市)。 |
Comment
| 評価について説明する文字列。 |
日付
| レビュー日。 |
Feedback
| RatedBy、Date、Comment、Ratingを含む、フィードバックのコンテナ。 |
GlancePage
| カスタマーフィードバックに関する要約情報を提供するページのURL。 |
NickName
| 出品者を識別する文字列。 |
Rating
| 0~5の星の数で評価。5つ星が最高評価です。 |
SellerId
| 出品者を一意に識別する半角英数字の文字列。 |
State
| 出品者の所在地 (都道府県または州) 。 |
TotalFeedback
| カスタマーレビューの合計数。 |
TotalFeedbackPages
| カスタマーレビューが掲載されている合計ページ数。各ページに5件のレビューが表示されます。この値は、入力パラメータ FeedbackPage の境界値として使用します。 |
これらのタグの親要素に関する詳細については、Response Groupsの該当するレスポンスグループを参照してください。