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

ListMatchingProducts

根据搜索查询,返回商品及其属性列表。

描述

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 操作所返回的一些关键元素的更多信息。

注: 因为亚马逊会对亚马逊 MWS 商品 API 部分进行更新,以包含新的响应要素,因而我们可能会更新 ProductsAPI_Response.xsd schema 和 default.xsd schema。如果您选择使用这些架构进行验证,请谨记这一点。
名称 描述
Product 包含 ProductsAPI_Response.xsd 中Product 元素的四个子元素。这四个子元素为:IdentifiersAttributeSetsRelationshipsSalesRankings
Identifiers 包含能够唯一标识商品的 MarketplaceASIN 组合。
AttributeSets 包含 default.xsd 中 ItemAttributes 元素的商品属性(如果适用于所返回的商品)。请注意,如果 Product 响应元素的属性以多种语言表述,则该元素会有多组属性。全部属性(包括未被翻译的属性)都会在每组属性中重复出现一次。各组属性使用的语言都由 lang 属性表示。
Relationships

包含商品变体信息(如果适用)。如果您的搜索条件与某个变体父 ASIN 相匹配,则 Relationships 元素将包含相关的 VariationChild 元素。如果您的搜索条件与某个变体子 ASIN 相匹配,则 Relationships 元素将包含相关的 VariationParent 元素。

注: 因为此操作不会返回全部商品属性,所以可以通过不同的 ASIN 值但相同的商品变体元素值来获得 VariationChild 元素。即使未返回用于区别商品变体子 ASIN 的商品属性,这些变体子 ASIN 也各不相同。

可以从 default.xsd 的 VariationChild 元素中找到变体属性。

SalesRankings

按商品分类排列的商品销量排行信息。

子元素:
  • ProductCategoryId。表明根据哪个商品分类进行销量排行。
  • Rank。商品在其商品分类中的销量排行。

示例

查询请求示例

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>