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.
特定のカテゴリー、または特定のマーケットプレイスのすべてのカテゴリーで最新の推奨情報を返します。
ListRecommendationsオペレーションは、指定したカテゴリー、またはすべてのカテゴリーの最新の推奨情報を返します。
あるカテゴリーの新しい推奨情報を確認する必要があるかどうかを判断するには、最初にGetLastUpdatedTimeForRecommendationsオペレーションを呼び出します。GetLastUpdatedTimeForRecommendationsオペレーションでカテゴリーに返された最終更新時刻のタイムスタンプがそのオペレーションを前回呼び出した時刻より新しい場合、ListRecommendationsオペレーションを呼び出して最新の推奨情報を取得する必要があります。それ以外の場合は、すでに最新の推奨情報を取得していることとなり、ListRecommendationsオペレーションを呼び出す必要はありません。
このオペレーションの最大リクエストクォータは8回で、回復レートは2秒毎につき1リクエストです。スロットリングの詳細情報と説明に関しては、 Amazon MWS開発者ガイドのスロットリング: リクエストを送信できる頻度を制限するを参照してください。
すべてのAmazon MWSオペレーションに必須とされるリクエストパラメータについて詳しくは、Amazon MWS開発者ガイドの必須リクエストパラメータを参照してください。
名前 | 説明 | 必須 | 有効な値 |
---|---|---|---|
MarketplaceId | 推奨情報を取得するマーケットプレイスのマーケットプレイスID。 | はい | 出品者が登録されている有効なMarketplaceId。 タイプ:xs:string |
RecommendationCategory | 取得する推奨情報のカテゴリーを指定します。 すべての推奨情報を取得するには、このパラメータに値を指定しないでください。 |
いいえ | RecommendationCategory値:
すべての推奨情報を取得するには、このパラメータに値を指定しないでください。 タイプ: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のリスト |
以下の例は、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>
以下はの例は、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>