SellerLookup

説明

SellerLookup オペレーションは、出品者 (USサイトではマーチャント) に関する詳細な情報を返します。出品者を検索するには、出品者IDを使用します。出品者名、カスタマーによる評価の平均点、最初の5件のカスタマーフィードバックエントリが返されます。ただし、 SellerLookup は、出品者のEメールアドレスやオフィスの住所などの情報は返しません。

[注]注意

出品者は自分に関する情報を入力する必要があります。出品者が情報を入力しない場合もあります。この場合、 SellerLookup は、出品者に関する情報の一部を返すことができません。

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の該当するレスポンスグループを参照してください。

関連オペレーション