Amazon Services Japan
Amazonマーケットプレイス Web サービス (Amazon MWS) ドキュメント

Deprecation Notice:

Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.

Amazon MWS ドキュメント

ListRecommendations

特定のカテゴリー、または特定のマーケットプレイスのすべてのカテゴリーで最新の推奨情報を返します。

説明

ListRecommendationsオペレーションは、指定したカテゴリー、またはすべてのカテゴリーの最新の推奨情報を返します。

あるカテゴリーの新しい推奨情報を確認する必要があるかどうかを判断するには、最初にGetLastUpdatedTimeForRecommendationsオペレーションを呼び出します。GetLastUpdatedTimeForRecommendationsオペレーションでカテゴリーに返された最終更新時刻のタイムスタンプがそのオペレーションを前回呼び出した時刻より新しい場合、ListRecommendationsオペレーションを呼び出して最新の推奨情報を取得する必要があります。それ以外の場合は、すでに最新の推奨情報を取得していることとなり、ListRecommendationsオペレーションを呼び出す必要はありません。

注: 現在、出品情報の品質の推奨情報には、最終更新のタイムスタンプが返されません。

このオペレーションの最大リクエストクォータは8回で、回復レートは2秒毎につき1リクエストです。スロットリングの詳細情報と説明に関しては、 Amazon MWS開発者ガイドスロットリング: リクエストを送信できる頻度を制限するを参照してください。

リクエストパラメータ

すべてのAmazon MWSオペレーションに必須とされるリクエストパラメータについて詳しくは、Amazon MWS開発者ガイド必須リクエストパラメータを参照してください。

名前 説明 必須 有効な値
MarketplaceId 推奨情報を取得するマーケットプレイスのマーケットプレイスID。 はい 出品者が登録されている有効なMarketplaceId

タイプ:xs:string

RecommendationCategory 取得する推奨情報のカテゴリーを指定します。

すべての推奨情報を取得するには、このパラメータに値を指定しないでください。

いいえ RecommendationCategory値:
  • Inventory
  • Selection
  • Pricing
  • Fulfillment
  • ListingQuality
  • GlobalSelling
  • Advertising

すべての推奨情報を取得するには、このパラメータに値を指定しないでください。

タイプ:xs:string

CategoryQueryList カテゴリー固有のフィルタを指定して、各カテゴリーに返される推奨情報のタイプを絞り込むことができます。 いいえ タイプ: CategoryQueryのリスト

レスポンス要素

名前 説明
NextToken 次のリクエストに情報を渡すために使用される生成文字列。NextTokenが返される場合、NextTokenの値をListRecommendationsByNextTokenに渡します。NextTokenが返されない場合、それ以上返される推奨情報はありません。

任意

タイプ:xs:string

FulfillmentRecommendations 現在の出荷に関する推奨情報のリスト。

任意。 現在の出荷に関する推奨情報がない場合、またはRecommendationCategoryで出荷に関する推奨情報がリクエストされなかった場合は、リストは空です。

タイプ: FulfillmentRecommendationのリスト

InventoryRecommendations 現在の在庫に関する推奨情報のリスト。

任意。 現在の在庫に関する推奨情報がない場合、またはRecommendationCategoryで在庫に関する推奨情報がリクエストされなかった場合は、リストは空です。

タイプ: InventoryRecommendationのリスト

ListingQualityRecommendations 現在の在庫に関する推奨情報のリスト。

任意。 現在の出荷に関する推奨情報がない場合、またはRecommendationCategoryで出荷に関する推奨情報がリクエストされなかった場合は、リストは空です。

タイプ: ListingQualityRecommendationのリスト

PricingRecommendations 現在の価格に関する推奨情報のリスト。

任意。 現在の価格に関する推奨情報がない場合、またはRecommendationCategoryで価格に関する推奨情報がリクエストされなかった場合は、リストは空です。

タイプ: PricingRecommendationのリスト

SelectionRecommendations 現在のセレクションに関する推奨情報のリスト。

任意。 現在のセレクションに関する推奨情報がない場合、またはRecommendationCategoryでセレクションに関する推奨情報がリクエストされなかった場合は、リストは空です。

タイプ: SelectionRecommendationsのリスト

GlobalSellingRecommendations 最新の海外出品に関する推奨情報のリスト。

任意。 最新の海外出品に関する推奨情報がない場合、またはRecommendationCategoryで海外出品に関する推奨情報がリクエストされなかった場合は、リストは空です。

タイプ: GlobalSellingRecommendationのリスト

AdvertisingRecommendations 最新の広告に関する推奨情報のリスト。

任意。 最新の広告に関する推奨情報がない場合、またはRecommendationCategoryで広告に関する推奨情報がリクエストされなかった場合は、リストは空です。

タイプ: AdvertisingRecommendationのリスト

例1

クエリリクエスト例

以下の例は、ListingQualityの推奨情報をリクエストする方法を示しています。

POST /Recommendations/2013-04-01 HTTP/1.1
Content-Type: x-www-form-urlencoded
Host: mws.amazonservices.com
User-Agent: <Your User Agent Header>

AWSAccessKeyId=0PB842EXAMPLESDX
&Action=ListRecommendations
&CategoryQueryList.CategoryQuery.1.FilterOptions.FilterOption.1=
    QualitySet%3DDefect
&CategoryQueryList.CategoryQuery.1.FilterOptions.FilterOption.2=
    ListingStatus%3DActive
&CategoryQueryList.CategoryQuery.1.RecommendationCategory=ListingQuality
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&MarketplaceId=ATVPDKIKX0DER
&RecommendationCategory=ListingQuality
&SellerId=A1XEXAMPLEDF
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2013-03-04T18%3A12%3A21.687Z
&Signature=ZQLpf8vEXAMPLE0iC265pf18n0%3D

レスポンス例

<?xml version="1.0"?>
<ListRecommendationsResponse
    xmlns="https://mws.amazonservices.com/Recommendations/2013-04-01">
  <ListRecommendationsResult>
    <ListingQualityRecommendations>
      <member>
        <RecommendationReason>
          Product_description is important for helping customers find your
          product.
        </RecommendationReason>
        <ItemName>Nike II</ItemName>
        <DefectAttribute>product_description</DefectAttribute>
        <QualitySet>DEFECT</QualitySet>
        <RecommendationId>
          ListingQuality-DEFECT-1-12-product_description-BT00I3X7F0-
          ldr-core-Nike II
        </RecommendationId>
        <DefectGroup>Missing Description and Bullets</DefectGroup>
        <ItemIdentifier>
          <Asin>BT00I3X7F0</Asin>
          <Sku>ldr-core</Sku>
        </ItemIdentifier>
      </member>
      <member>
        <RecommendationReason>
          Brand name is an important factor in helping customers find
          your product.
        </RecommendationReason>
        <ItemName>Nike II</ItemName>
        <DefectAttribute>brand</DefectAttribute>
        <QualitySet>DEFECT</QualitySet>
        <RecommendationId>
          ListingQuality-DEFECT-1-13-brand-BT00I3X7F0-
          ldr-core-Nike II
        </RecommendationId>
        <DefectGroup>Missing Brand Name</DefectGroup>
        <ItemIdentifier>
          <Asin>BT00I3X7F0</Asin>
          <Sku>ldr-core</Sku>
        </ItemIdentifier>
      </member>
      <member>
        <RecommendationReason>
          Images can make your product more attractive to customers
          and help them make buying decisions.
        </RecommendationReason>
        <ItemName>Nike II</ItemName>
        <DefectAttribute>image</DefectAttribute>
        <QualitySet>DEFECT</QualitySet>
        <RecommendationId>
          ListingQuality-DEFECT-1-10-image-BT00I3X7F0-
          ldr-core-Nike II
        </RecommendationId>
        <DefectGroup>Missing Image</DefectGroup>
        <ItemIdentifier>
          <Asin>BT00I3X7F0</Asin>
          <Sku>ldr-core</Sku>
        </ItemIdentifier>
      </member>
      <member>
        <RecommendationReason>
          Images can make your product more attractive to customers
          and help them make buying decisions.
        </RecommendationReason>
        <ItemName>Pants Apparel</ItemName>
        <DefectAttribute>image</DefectAttribute>
        <QualitySet>QUARANTINE</QualitySet>
        <RecommendationId>
          ListingQuality-QUARANTINE-101-100-image-BT00HKTWE4-
          ldr-quarantine-Pants Apparel
        </RecommendationId>
        <DefectGroup> Image</DefectGroup>
        <ItemIdentifier>
          <Asin>BT00HKTWE4</Asin>
          <Sku>ldr-quarantine</Sku>
        </ItemIdentifier>
      </member>
    </ListingQualityRecommendations>
  </ListRecommendationsResult>
  <ResponseMetadata>
    <RequestId>d0305dfc-b83e-11e2-8aeb-c93b3EXAMPLE</RequestId>
  </ResponseMetadata>
</ListRecommendationsResponse>

例2

クエリーリクエスト例

以下はの例は、Selectionの推奨情報をリクエストする方法を示しています。

POST /Recommendations/2013-04-01 HTTP/1.1
Content-Type: x-www-form-urlencoded
Host: mws.amazonservices.com
User-Agent: <Your User Agent Header>

AWSAccessKeyId=0PB842EXAMPLESDX
&Action=ListRecommendations
&CategoryQueryList.CategoryQuery.1.FilterOptions.FilterOption.1=
    BrandName%3DDEWALT
&CategoryQueryList.CategoryQuery.1.FilterOptions.FilterOption.2=
    ProductCategory%3DHome%20Improvement
&CategoryQueryList.CategoryQuery.1.FilterOptions.FilterOption.3=
    IncludeCommonRecommendations%3Dtrue
&CategoryQueryList.CategoryQuery.1.RecommendationCategory=Selection
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&MarketplaceId=ATVPDKIKX0DER
&RecommendationCategory=Selection
&SellerId=A1XEXAMPLEDF
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2013-03-04T18%3A12%3A21.687Z
&Signature=ZQLpf8vEXAMPLE0iC265pf18n0%3D

レスポンス例

<ListRecommendationsResponse
    xmlns="https://mws.amazonservices.com/Recommendations/2013-04-01">
  <ListRecommendationsResult>
    <SelectionRecommendations>
      <member>
        <BuyboxPrice>
          <Amount>15.99</Amount>
          <CurrencyCode>USD</CurrencyCode>
        </BuyboxPrice>
        <SalesRank>1579</SalesRank>
        <RecommendationReason>
          Popular Out-of-Stock Products
        </RecommendationReason>
        <ItemName>DEWALT Ratcheting Screwdriver</ItemName>
        <ProductCategory>Home Improvement</ProductCategory>
        <LastUpdated>2014-09-19T19:10:14.510Z</LastUpdated>
        <RecommendationId>
          Selection-Popular Out-of-Stock Products-B000A0-ASDF-SDE3D-DEWALT Ratcheting Screwdriver
        </RecommendationId>
        <NumberOfOffers>2</NumberOfOffers>
        <NumberOfCustomerReviews>0</NumberOfCustomerReviews>
        <AverageCustomerReview>0.0</AverageCustomerReview>
        <BrandName>DEWALT</BrandName>
        <ItemIdentifier>
          <Asin>B000A0</Asin>
          <Sku>ASDF-SDE3D</Sku>
          <Upc>076174692334</Upc>
        </ItemIdentifier>
      </member>
    </SelectionRecommendations>
    <NextToken>SAMPLE-TOKENE</NextToken>
  </ListRecommendationsResult>
  <ResponseMetadata>
    <RequestId>45f1ba88-862f-SAMPLE-ce318b534859</RequestId>
  </ResponseMetadata>
</ListRecommendationsResponse>