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.
根据搜索查询,返回商品及其属性列表。
ListMatchingProducts 操作会返回一个包含商品及其属性的列表,该列表以您指定的搜索查询为基础,按照关联性排序。您的搜索查询可以是用于描述商品的一个词组,或是一个商品编码(如 GCID、UPC、EAN、ISBN 或 JAN)。 如果您有商品相应的 ASIN,请使用 GetMatchingProduct 操作。请注意,商品编码不能为 SellerSKU。如果您的查询未返回任何匹配的商品,可以通过拼写校正或删除关键词来扩大查询范围,从而获取匹配的商品。此操作最多会返回 10 件商品,但不包括无法购买的商品。
名称 | 描述 | 必填项 |
---|---|---|
MarketplaceId |
商城编码。指定返回商品的商城。 类型:xs:string |
是 |
Query |
亚马逊商城网站所支持的搜索字符串。 示例:Query=哈利波特 DVD 类型:xs:string |
是 |
QueryContextId |
在其中进行指定搜索的上下文的编码。商城可能会提供某些机制,只搜索某些可能匹配的商品。例如,亚马逊商城允许对某一分类进行查询。QueryContextId 参数用于指定此类范围。如果省略此项,则会在商城的默认上下文中进行搜索,该上下文通常为最大商品范围。有关可在各个亚马逊商城中使用的 QueryContextId 值的完整列表,请参阅“QueryContextId 值”。 类型:xs:string |
否 |
ListMatchingProducts 操作返回的响应元素由以下公用 XSD 描述:
下表提供了关于 ListMatchingProducts 操作所返回的一些关键元素的更多信息。
名称 | 描述 |
---|---|
Product | 包含 ProductsAPI_Response.xsd 中Product 元素的四个子元素。这四个子元素为:Identifiers、AttributeSets、Relationships 和 SalesRankings。 |
Identifiers | 包含能够唯一标识商品的 MarketplaceASIN 组合。 |
AttributeSets | 包含 default.xsd 中 ItemAttributes 元素的商品属性(如果适用于所返回的商品)。请注意,如果 Product 响应元素的属性以多种语言表述,则该元素会有多组属性。全部属性(包括未被翻译的属性)都会在每组属性中重复出现一次。各组属性使用的语言都由 lang 属性表示。 |
Relationships |
包含商品变体信息(如果适用)。如果您的搜索条件与某个变体父 ASIN 相匹配,则 Relationships 元素将包含相关的 VariationChild 元素。如果您的搜索条件与某个变体子 ASIN 相匹配,则 Relationships 元素将包含相关的 VariationParent 元素。 注: 因为此操作不会返回全部商品属性,所以可以通过不同的 ASIN 值但相同的商品变体元素值来获得 VariationChild 元素。即使未返回用于区别商品变体子 ASIN 的商品属性,这些变体子 ASIN 也各不相同。
可以从 default.xsd 的 VariationChild 元素中找到变体属性。 |
SalesRankings |
按商品分类排列的商品销量排行信息。 子元素:
|
https://mws.amazonservices.com/Products/2011-10-01 ?AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ &Action=ListMatchingProducts &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &SellerId=A1IMEXAMPLEWRC &SignatureVersion=2 &Timestamp=2012-12-12T22%3A23%3A50Z &Version=2011-10-01 &Signature=V%2BEXAMPLERT%2Baj%2Fxwqo7y3PIifMFHeqFlNYW0EXAMPLEA%3D &SignatureMethod=HmacSHA256 &MarketplaceId=ATVPDKIKX0DER &Query=0439708184
<?xml version="1.0"?> <ListMatchingProductsResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <ListMatchingProductsResult> <Products xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01" xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd"> <Product> <Identifiers> <MarketplaceASIN> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>059035342X</ASIN> </MarketplaceASIN> </Identifiers> <AttributeSets> <ns2:ItemAttributes xml:lang="en-US"> <ns2:Author>Rowling, J.K.</ns2:Author> <ns2:Binding>Paperback</ns2:Binding> <ns2:Brand>Scholastic Press</ns2:Brand> <ns2:Creator Role="Illustrator">GrandPré, Mary</ns2:Creator> <ns2:Edition>1st</ns2:Edition> <ns2:Feature>Recommended Age: 9 years and up</ns2:Feature> <ns2:ItemDimensions> <ns2:Height Units="inches">0.80</ns2:Height> <ns2:Length Units="inches">7.50</ns2:Length> <ns2:Width Units="inches">5.20</ns2:Width> <ns2:Weight Units="pounds">0.50</ns2:Weight> </ns2:ItemDimensions> <ns2:IsAutographed>false</ns2:IsAutographed> <ns2:IsMemorabilia>false</ns2:IsMemorabilia> <ns2:Label>Scholastic Paperbacks</ns2:Label> <ns2:Languages> <ns2:Language> <ns2:Name>english</ns2:Name> <ns2:Type>Unknown</ns2:Type> </ns2:Language> <ns2:Language> <ns2:Name>english</ns2:Name> <ns2:Type>Original Language</ns2:Type> </ns2:Language> <ns2:Language> <ns2:Name>english</ns2:Name> <ns2:Type>Published</ns2:Type> </ns2:Language> </ns2:Languages> <ns2:ListPrice> <ns2:Amount>10.99</ns2:Amount> <ns2:CurrencyCode>USD</ns2:CurrencyCode> </ns2:ListPrice> <ns2:Manufacturer>Scholastic Paperbacks</ns2:Manufacturer> <ns2:NumberOfItems>1</ns2:NumberOfItems> <ns2:NumberOfPages>320</ns2:NumberOfPages> <ns2:PackageDimensions> <ns2:Height Units="inches">1.00</ns2:Height> <ns2:Length Units="inches">7.50</ns2:Length> <ns2:Width Units="inches">5.20</ns2:Width> <ns2:Weight Units="pounds">0.50</ns2:Weight> </ns2:PackageDimensions> <ns2:PackageQuantity>1</ns2:PackageQuantity> <ns2:PartNumber>9780590353427</ns2:PartNumber> <ns2:ProductGroup>Book</ns2:ProductGroup> <ns2:ProductTypeName>ABIS_BOOK</ns2:ProductTypeName> <ns2:PublicationDate>1999-10-01</ns2:PublicationDate> <ns2:Publisher>Scholastic Paperbacks</ns2:Publisher> <ns2:ReleaseDate>1999-09-08</ns2:ReleaseDate> <ns2:SmallImage> <ns2:URL>http://ecx.images-amazon.com/images/I/51MU5VilKpL._SL75_.jpg</ns2:URL> <ns2:Height Units="pixels">75</ns2:Height> <ns2:Width Units="pixels">51</ns2:Width> </ns2:SmallImage> <ns2:Studio>Scholastic Paperbacks</ns2:Studio> <ns2:Title>Harry Potter and the Sorcerer's Stone (Book 1)</ns2:Title> </ns2:ItemAttributes> </AttributeSets> <Relationships/> <SalesRankings> <SalesRank> <ProductCategoryId>book_display_on_website</ProductCategoryId> <Rank>401</Rank> </SalesRank> <SalesRank> <ProductCategoryId>15356791</ProductCategoryId> <Rank>5</Rank> </SalesRank> <SalesRank> <ProductCategoryId>3153</ProductCategoryId> <Rank>8</Rank> </SalesRank> <SalesRank> <ProductCategoryId>17468</ProductCategoryId> <Rank>16</Rank> </SalesRank> </SalesRankings> </Product> </Products> </ListMatchingProductsResult> <ResponseMetadata> <RequestId>3b805a12-689a-4367-ba86-EXAMPLE91c0b</RequestId> </ResponseMetadata> </ListMatchingProductsResponse>