建议数据类型

以下是用于亚马逊商城网络服务 (亚马逊 MWS)“销售指导 API”部分的请求参数和响应元素的数据类型：

数据类型	描述
AdvertisingRecommendation	对发布商品广告以及使用商品推广项目的建议。
CategoryQuery	可以对某个分类指定的筛选条件，以缩小每个分类返回的建议类型的范围。
DimensionMeasure	尺寸单位和数量
FulfillmentRecommendation	对通过亚马逊物流 (FBA) 进行配送的畅销商品的建议。
GlobalSellingRecommendation	对将您的商品销售到更多地区和商城的建议。
InventoryRecommendation	对您的库存不足或缺货商品进行补货的建议。
ItemDimensions	商品尺寸。
ListingQualityRecommendation	对修改当前商品信息错误的建议。
Price	货币种类和金额。
PricingRecommendation	对查看您的库存商品价格（您的售价不是最低价）的建议。
ProductIdentifier	商品的 ASIN、SKU 和 UPC。
SelectionRecommendation	对在亚马逊发布新商品的建议。
WeightMeasure	重量单位和数量。

AdvertisingRecommendation

对发布商品广告以及使用商品推广项目的建议。

操作

AdvertisingRecommendation 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 AdvertisingRecommendation 数据类型的元素：

名称	描述
RecommendationId	建议的唯一编码，格式为 {`Category`}-{`RecommendationReason`}-{`ASIN`}-{`SKU`}-{`UPC`}-{`ItemName`}。如果这些值中任何一个为空，该值将为空。类型：xs:string
RecommendationReason	建议的详细说明。类型：xs:string
LastUpdated	生成或最后更新建议的日期和时间。格式为 ISO 8601。类型：xs:dateTime
ItemIdentifier	商品的 ASIN、SKU 和 UPC。类型：ProductIdentifier
ItemName	商品名称。可选类型：xs:string
BrandName	商品品牌名称。可选类型：xs:string
ProductCategory	商品的分类。可选类型：xs:string
SalesRank	商品在指定分类中的销售排行。可选类型：xs:int
YourPricePlusShipping	为商品设置的价格（包括运费）。可选类型：Price
LowestPricePlusShipping	具有相同 Condition 和 SubCondition 的商品的最低价格（包括运费）。可选类型：Price
AvailableQuantity	您的库存商品总数。可选类型：xs:int
SalesForTheLast30Days	过去 30 天的商品销售数量。可选类型：xs:int

CategoryQuery

可以对某个分类指定的筛选条件，以缩小每个分类返回的建议类型的范围。

操作

CategoryQuery 数据类型用于以下操作的请求参数：

ListRecommendations

数据类型内容

下表列出了 CategoryQuery 数据类型的元素：

名称	描述	必填项	有效值
RecommendationCategory	指定要检索建议的分类。类型：xs:string	是	RecommendationCategory 值： `Selection` `Fulfillment` `ListingQuality` `GlobalSelling` `Advertising` 注：如果您在此处指定 RecommendationCategory 值，但该值并未在 ListRecommendations 操作的 RecommendationCategory 请求参数中指定，则该值将被忽略。
FilterOptions	可以对某个建议分类指定的筛选条件，以缩小对建议分类返回的建议的范围。将以一组 `FilterName=FilterValue` 值对的形式指定筛选条件。有关更多信息，请参阅 ListRecommendations 操作的示例部分。	是	`ListingQuality` 建议的 FilterOptions 值： `QualitySet=Defect` – 可筛选出虽然有错误，但仍有效的商品信息。例如，此查询将返回没有详细说明的商品信息。 `QualitySet=Quarantine` – 可筛选出因不符合亚马逊标准而阻止上传的商品信息。例如，此查询将返回没有主图的商品信息。 `ListingStatus=Active` – 仅筛选出在售的库存商品。返回状态为“在售”的库存商品。 `ListingStatus=Inactive` – 仅筛选出不可售的库存商品。返回状态为“不可售”的库存商品。 `Selection`、`Fulfillment`、`GlobalSelling` 和 `Advertising` 建议的 FilterOptions 值： `BrandName=<BrandName>` - 用于筛选适用于指定品牌名称的建议。 `ProductCategory=<ProductCategory>` - 用于筛选适用于指定商品分类的建议。 `Selection` 建议的 FilterOptions 值： `IncludeCommonRecommendations=true` - 包括所有卖家都通用的 `Selection` 建议（还包括针对具体卖家的建议）。 `IncludeCommonRecommendations=false` - 不包括所有卖家都通用的 `Selection` 建议，只包括针对具体卖家的建议。

名称

描述

必填项

有效值

RecommendationCategory

指定要检索建议的分类。

类型：xs:string

是

RecommendationCategory 值：

Selection
Fulfillment
ListingQuality
GlobalSelling
Advertising

注：如果您在此处指定 RecommendationCategory 值，但该值并未在 ListRecommendations 操作的 RecommendationCategory 请求参数中指定，则该值将被忽略。

FilterOptions

可以对某个建议分类指定的筛选条件，以缩小对建议分类返回的建议的范围。

将以一组 FilterName=FilterValue 值对的形式指定筛选条件。有关更多信息，请参阅 ListRecommendations 操作的示例部分。

是

ListingQuality 建议的 FilterOptions 值：

QualitySet=Defect – 可筛选出虽然有错误，但仍有效的商品信息。例如，此查询将返回没有详细说明的商品信息。
QualitySet=Quarantine – 可筛选出因不符合亚马逊标准而阻止上传的商品信息。例如，此查询将返回没有主图的商品信息。
ListingStatus=Active – 仅筛选出在售的库存商品。返回状态为“在售”的库存商品。
ListingStatus=Inactive – 仅筛选出不可售的库存商品。返回状态为“不可售”的库存商品。

Selection、Fulfillment、GlobalSelling 和 Advertising 建议的 FilterOptions 值：

BrandName=<BrandName> - 用于筛选适用于指定品牌名称的建议。
ProductCategory=<ProductCategory> - 用于筛选适用于指定商品分类的建议。

Selection 建议的 FilterOptions 值：

IncludeCommonRecommendations=true - 包括所有卖家都通用的 Selection 建议（还包括针对具体卖家的建议）。
IncludeCommonRecommendations=false - 不包括所有卖家都通用的 Selection 建议，只包括针对具体卖家的建议。

DimensionMeasure

操作

DimensionMeasure 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 DimensionMeasure 数据类型的元素：

名称	描述
Value	尺寸的值。类型：xs:decimal
Unit	尺寸的单位。类型：xs:string

FulfillmentRecommendation

对通过亚马逊物流 (FBA) 进行配送的畅销商品的建议。

操作

FulfillmentRecommendation 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 FulfillmentRecommendation 数据类型的元素：

名称	描述
RecommendationId	建议的唯一编码，格式为 {`Category`}-{`RecommendationReason`}-{`ASIN`}-{`SKU`}-{`UPC`}-{`ItemName`}。如果这些值中任何一个为空，该值将为空。类型：xs:string
RecommendationReason	建议的详细说明。类型：xs:string
LastUpdated	生成或最后更新建议的日期和时间。格式为 ISO 8601。类型：xs:dateTime
ItemIdentifier	商品的 ASIN、SKU 和 UPC。类型：ProductIdentifier
ItemName	商品名称。可选类型：xs:string
BrandName	商品品牌名称。可选类型：xs:string
ProductCategory	商品的分类。可选类型：xs:string
SalesRank	商品在指定分类中的销售排行。可选类型：xs:int
BuyboxPrice	获得购买按钮的商品的价格。可选类型：Price
NumberOfOffers	在售商品数量。可选类型：xs:int
NumberOfOffersFulfilledByAmazon	由亚马逊配送的在售商品数量。可选类型：xs:int
AverageCustomerReview	商品的买家平均浏览次数。可选类型：xs:decimal
NumberOfCustomerReviews	商品的买家浏览次数。可选类型：xs:int
ItemDimensions	商品的尺寸。可选类型：ItemDimensions

GlobalSellingRecommendation

对将您的商品销售到更多地区和商城的建议。

操作

GlobalSellingRecommendation 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 GlobalSellingRecommendation 数据类型的元素：

名称	描述
RecommendationId	建议的唯一编码，格式为 {`Category`}-{`RecommendationReason`}-{`ASIN`}-{`SKU`}-{`UPC`}-{`ItemName`}。如果这些值中任何一个为空，该值将为空。类型：xs:string
RecommendationReason	建议的详细说明。类型：xs:string
LastUpdated	生成或最后更新建议的日期和时间。格式为 ISO 8601。类型：xs:dateTime
ItemIdentifier	商品的 ASIN、SKU 和 UPC。类型：ProductIdentifier
ItemName	商品名称。可选类型：xs:string
BrandName	商品品牌名称。可选类型：xs:string
ProductCategory	商品的分类。可选类型：xs:string
SalesRank	商品在指定分类中的销售排行。可选类型：xs:int
BuyboxPrice	获得购买按钮的商品的价格。可选类型：Price
NumberOfOffers	在售商品数量。可选类型：xs:int
NumberOfOffersFulfilledByAmazon	由亚马逊配送的在售商品数量。可选类型：xs:int
AverageCustomerReview	商品的买家平均浏览次数。可选类型：xs:decimal
NumberOfCustomerReviews	商品的买家浏览次数。可选类型：xs:int
ItemDimensions	商品的尺寸。可选类型：ItemDimensions

InventoryRecommendation

对您的库存不足或缺货商品进行补货的建议。

操作

InventoryRecommendation 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 InventoryRecommendation 数据类型的元素：

名称	描述
RecommendationId	建议的唯一编码，格式为 {`Category`}-{`RecommendationReason`}-{`ASIN`}-{`SKU`}-{`UPC`}-{`ItemName`}。如果这些值中任何一个为空，该值将为空。类型：xs:string
RecommendationReason	建议的详细说明。类型：xs:string
LastUpdated	生成或最后更新建议的日期和时间。格式为 ISO 8601。类型：xs:dateTime
ItemIdentifier	商品的 ASIN、SKU 和 UPC。类型：ProductIdentifier
ItemName	商品名称。可选类型：xs:string
FulfillmentChannel	FulfillmentChannel 值： `MFN` – 表明您自行配送商品。 `AFN` – 表明由亚马逊配送商品。可选类型：xs:string
SalesForTheLast14Days	过去 14 天的商品销售数量。可选类型：xs:int
SalesForTheLast30Days	过去 30 天的商品销售数量。可选类型：xs:int
AvailableQuantity	您的库存商品总数。可选类型：xs:int
DaysUntilStockRunsOut	根据当前销量，预计库存商品在售罄前可售的天数。可选类型：xs:int
InboundQuantity	已发送并即将在亚马逊运营中心入库的商品数量（如果商品由亚马逊配送）。可选类型：xs:int
RecommendedInboundQuantity	建议您发送到亚马逊运营中心的商品数量（如果商品由亚马逊配送）。可选类型：xs:int
DaysOutOfStockLast30Days	过去 30 天商品缺货的天数。可选类型：xs:int
LostSalesInLast30Days	由于商品缺货而导致的估计销量损失。可选类型：xs:int

ItemDimensions

商品尺寸。

操作

ItemDimensions 数据类型用于以下操作的响应元素：

数据类型内容

下表显示了 ItemDimensions 数据类型的元素：

名称	描述
Height	商品高度。类型：DimensionMeasure
Width	商品宽度。类型：DimensionMeasure
Length	商品长度。类型：DimensionMeasure
Weight	商品重量。类型：WeightMeasure

ListingQualityRecommendation

对修改当前商品信息错误的建议。

操作

ListingQualityRecommendation 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 ListingQualityRecommendation 数据类型的元素：

名称	描述
RecommendationId	建议的唯一编码，格式为 {`Category`}-{`QualitySet`}-{`DefectGroupKey`}-{`DefectAttributeKey`}-{`ASIN`}-{`SKU`}-{`UPC`}-{`ItemName`}。如果这些值中任何一个为空，该值将为空。类型：xs:string
RecommendationReason	建议的详细说明。类型：xs:string
QualitySet	QualitySet 值： `Defect` – 表示商品信息虽然有错误，但仍有效。例如，没有详细说明的商品信息。 `Quarantine` – 表示因不符合亚马逊标准而阻止上传的商品信息。例如，没有主图的商品信息。类型：xs:string
DefectGroup	`Defect` QualitySet 中商品信息的错误的详细说明。例如，“缺少主图”。可选类型：xs:string
DefectAttribute	`Defect` QualitySet 中有错误的商品信息的特有属性。例如，“裤子内接缝”。
ItemIdentifier	商品的 ASIN、SKU 和 UPC。类型：ProductIdentifier
ItemName	商品名称。可选类型：xs:string

Price

货币种类和金额。

操作

Price 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 Price 数据类型的元素：

名称	描述
CurrencyCode	三位数的货币代码。格式为 ISO 4217。类型：xs:string
Amount	货币金额。类型：xs:decimal

PricingRecommendation

对查看您的库存商品价格（您的售价不是最低价）的建议。

操作

PricingRecommendation 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 PricingRecommendation 数据类型的元素：

名称	描述
RecommendationId	建议的唯一编码，格式为 {`Category`}-{`RecommendationReason`}-{`ASIN`}-{`SKU`}-{`UPC`}-{`ItemName`}。如果这些值中任何一个为空，该值将为空。类型：xs:string
RecommendationReason	建议的详细说明。类型：xs:string
LastUpdated	生成或最后更新建议的日期和时间。格式为 ISO 8601。类型：xs:dateTime
ItemIdentifier	商品的 ASIN、SKU 和 UPC。类型：ProductIdentifier
ItemName	商品名称。可选类型：xs:string
Condition	商品状况。可选类型：xs:string
SubCondition	商品的子状况。可选类型：xs:string
FulfillmentChannel	FulfillmentChannel 值： `MFN` – 表明您自行配送商品。 `AFN` – 表明由亚马逊配送商品。可选类型：xs:string
YourPricePlusShipping	为商品设置的价格（包括运费）。可选类型：Price
LowestPricePlusShipping	具有相同 Condition 和 SubCondition 的商品的最低价格（包括运费）。可选类型：Price
PriceDifferenceToLowPrice	对于具有相同 Condition 和 SubCondition 的商品，您的商品价格与商品最低价格之间的差价。可选类型：Price
MedianPricePlusShipping	具有相同 Condition 和 SubCondition 的商品的中间价格（包括运费）。可选类型：Price
LowestMerchantFulfilledOfferPrice	具有相同 Condition 和 SubCondition、由卖家自行配送的商品的最低价格。可选类型：Price
LowestAmazonFulfilledOfferPrice	具有相同 Condition 和 SubCondition、由亚马逊配送的商品的最低价格。可选类型：Price
NumberOfOffers	在售商品总数。可选类型：xs:int
NumberOfMerchantFulfilledOffers	由卖家自行配送的在售商品的总数。可选类型：xs:int
NumberOfAmazonFulfilledOffers	由亚马逊配送的在售商品的总数。可选类型：xs:int

ProductIdentifier

商品的 ASIN、SKU 和 UPC。

操作

ProductIdentifier 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 ProductIdentifier 数据类型的元素：

名称	描述
Asin	商品 ASIN。类型：xs:string
Sku	商品 SKU。类型：xs:string
Upc	商品 UPC 。类型：xs:string

SelectionRecommendation

对在亚马逊发布新商品的建议。

操作

SelectionRecommendation 数据类型用于以下操作的响应元素：

数据类型

下表列出了 SelectionRecommendation 数据类型的元素：

名称	描述
RecommendationId	建议的唯一编码，格式为 {`Category`}-{`RecommendationReason`}-{`ASIN`}-{`SKU`}-{`UPC`}-{`ItemName`}。如果这些值中任何一个为空，该值将为空。类型：xs:string
RecommendationReason	建议的详细说明。类型：xs:string
LastUpdated	生成或最后更新建议的日期和时间。格式为 ISO 8601。类型：xs:dateTime
ItemIdentifier	商品的 ASIN、SKU 和 UPC。类型：ProductIdentifier
ItemName	商品名称。可选类型：xs:string
BrandName	商品品牌名称。可选类型：xs:string
ProductCategory	商品的分类。可选类型：xs:string
SalesRank	商品在指定分类中的销售排行。可选类型：xs:string
BuyboxPrice	获得购买按钮的商品的价格。可选类型：Price
NumberOfOffers	在售商品数量。可选类型：xs:int
AverageCustomerReview	商品的买家平均浏览次数。可选类型：xs:decimal
NumberOfCustomerReviews	商品的买家浏览次数。可选类型：xs:int

WeightMeasure

重量单位和数量。

操作

WeightMeasure 数据类型用于以下操作的响应元素：

数据类型内容

下表列出了 WeightMeasure 数据类型的元素：

名称	描述
Value	尺寸的值。类型：xs:decimal
Unit	尺寸的单位。类型：xs:string

Deprecation Notice:

建议数据类型

AdvertisingRecommendation

操作

数据类型内容

CategoryQuery

操作

数据类型内容

DimensionMeasure

操作

数据类型内容

FulfillmentRecommendation

操作

数据类型内容

GlobalSellingRecommendation

操作

数据类型内容

InventoryRecommendation

操作

数据类型内容

ItemDimensions

操作

数据类型内容

ListingQualityRecommendation

操作

数据类型内容

Price

操作

数据类型内容

PricingRecommendation

操作

数据类型内容

ProductIdentifier

操作

数据类型内容

SelectionRecommendation

操作

数据类型

WeightMeasure

操作

数据类型内容

相关主题