Amazon Services China
亚马逊商城网络服务(亚马逊 MWS)文档
亚马逊 MWS 文档

ListRecommendations

返回特定分类或特定商城中的所有分类的有效建议。

描述

ListRecommendations 操作为您返回指定分类或所有分类的最新建议。

要确定是否需要检查某个分类的新建议,请首先调用 GetLastUpdatedTimeForRecommendations 操作。如果 GetLastUpdatedTimeForRecommendations 操作针对某个分类返回的最后更新的时间戳晚于您上次调用该操作时的时间戳,则您应调用 ListRecommendations 操作来获得最新建议。否则,无需调用 ListRecommendations 操作,因为您已具有最新的建议。

注: 当前,不会对信息质量建议返回最后更新的时间戳。

此操作的最大请求限额为 8 个,恢复速率为每 2 秒 1 个请求。关于限制术语的定义以及完整的限制说明,请参阅亚马逊MWS开发者指南中的限制:针对提交请求频率的限制

请求参数

有关所有亚马逊MWS 操作的必需请求参数的更多信息,请参阅亚马逊MWS开发者指南中的必需的请求参数

名称 描述 必填项 有效值
MarketplaceId 您要从其检索建议的商城的商城编码。 卖家注册的任何有效 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 没有请求选品建议,则该列表为空。

类型:SelectionRecommendation 列表

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>