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 个请求。关于限制术语的定义以及完整的限制说明,请参阅亚马逊MWS开发者指南中的限制:针对提交请求频率的限制。
有关所有亚马逊MWS 操作的必需请求参数的更多信息,请参阅亚马逊MWS开发者指南中的必需的请求参数。
名称 | 描述 | 必填项 | 有效值 |
---|---|---|---|
MarketplaceId | 您要从其检索建议的商城的商城编码。 | 是 | 卖家注册的任何有效 MarketplaceId。 类型:xs:string |
RecommendationCategory | 指定要检索建议的分类。 若要检索所有建议,请不要为该参数指定值。 |
否 | RecommendationCategory 值:
若要检索所有建议,请不要为该参数指定值。 类型:xs:string |
CategoryQueryList | 可以对某个分类指定的筛选条件,以缩小对每个分类返回的建议类型的范围。 | 否 | 类型:CategoryQuery 列表 |
名称 | 描述 |
---|---|
NextToken | 生成的字符串,用于将信息传递给下一请求。如果返回 NextToken,将 NextToken 的值传递给 ListRecommendationsByNextToken。如果没有返回 NextToken,则不返回其他建议。
可选 类型:xs:string |
FulfillmentRecommendations | 当前配送建议列表。 可选。如果没有当前配送建议或 RecommendationCategory 没有请求配送建议,则该列表为空。 |
InventoryRecommendations | 当前库存建议列表。 可选。如果没有当前库存建议或 RecommendationCategory 没有请求库存建议,则该列表为空。 类型:InventoryRecommendation 列表 |
ListingQualityRecommendations | 当前商品信息质量建议。 可选。如果没有当前商品信息质量建议或 RecommendationCategory 没有请求商品信息质量建议,则该列表为空。 |
PricingRecommendations | 当前价格建议的列表。 可选。如果没有当前价格建议或 RecommendationCategory 没有请求价格建议,则该列表为空。 类型:PricingRecommendation 列表 |
SelectionRecommendations | 当前选品建议的列表。 可选。如果没有当前选品建议或 RecommendationCategory 没有请求选品建议,则该列表为空。 类型:SelectionRecommendation 列表 |
GlobalSellingRecommendations | 当前全球开店建议的列表。 可选。如果没有当前全球开店建议或 RecommendationCategory 没有请求全球开店建议,则该列表为空。 |
AdvertisingRecommendations | 当前广告建议的列表。 可选。如果没有当前广告建议或 RecommendationCategory 没有请求广告建议,则该列表为空。 |
此示例介绍如何请求 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>