亚马逊商品API详解

所需积分/C币:43 2014-05-14 10:16:04 391KB PDF
收藏 收藏 3
举报

用于对卖家的后台商品进行上传或下载,同步到本地ERP系统中
亚马逊商城网终服务商品部分参考(版木 描述 请求参数 响应元素 示例 相关主题 描述 请求参数 响应元素 示例 相关主题 描述 请求参数 响应元素 例 相关主题 描述 请求参数 响应元素 示例 相关主题 描述 请求参数 响应元素 示例 相关主题 描述 请求参数 示例 相关主题 值 客户端库更新 亚马逊商城网络服务商品部分参考(版本 亚马逊商城网终服务商品部分参考(版木 亚马逊商城网络服务商品部分参考(版木 版权所有2011-2013 Amazon,com,lnc.或其附属公司。 amazon、 Amazon.cn、亚马逊和 Amazon. cn标识均是亚马逊有限公司或其附属公司的注册商标。所有其他商 标均为其各自所有者的财产。 最后更新:2013-11-18 亚马逊商城网络服务商品部分参考(版本 亚马逊商城网终服务商品部分参考(版木 您应了解的“亚马逊 商品”部分的相 关内容 亚马逊商城网络服务(亚马逊MwS)的商品AP部分能够帮助您获得相关信息,以便您将自己的商品与亚马 逊商城网站上已有的商品详情相匹配,并为在亚马逊商城网站上发布商品做出采购和定价决策。亚马逊MwS 商品ΔP能够返回商品属性、当前商城价格信息,以及其他各种商品信息。 Note:亚马逊MWS商品API部分只针对亚马逊商城网站上发布的商品。亚马逊MWS商品APl部分 不适用于 Checkout by Amazon或 Amazon webstore 商品API部分包含以下操作 操作 描述 ListMatching Products 根据搜索查询,返回商品及其属性列表。 GetMatching Product 根据ASIN值列表,返回商品及其属性列表 GetMatchingProductForld 根据ASN、GCID、 Sellers、UPC、EAN、ISBN和JAN,返回 商品及其属性列表。 GetCompetitivePricing ForSKU 根据 SellerSku,返回商品的当前有竞争力的价格 GetCompetitivePricing ForASN 根据ASIN,返回商品的当前有竞争力的价格。 GetLowestOfferListingsForSKU 根据 SellersKu,返回价格最低的在售商品的价格信息。 GeIlowestofferListingsFOrASIN 根据ASIN,返回价格最低的在售商品的价柊信息。 GetMy PriceForSKU 根据 SellerSKu,返回您自己的商品的价格信息。 GetMyPriceForASIN 根据ASIN,返回您自己的商品的价格信息 Get Productcategories forsK 根据 SellerSKu,返回商品所在的商品分类 GetProductCategoriesForASIN 根据ASIN,返回商品所在的商品分类。 Getservice Status 返回“商品API”部分的运行状态 处理批量操作请求 介绍如何使用 ASINList、 SellerSKulist和 Idlist请求参数处理批量操作 在业马逊MWS商品API部分中,以 ASsIst、 Sellerskulist或 Idlist作为输入参数的操作可以 为所有输入值中的每个输入值单独返回结果。举例来说,如果您为 GetcompetitivepricirgforAS⊥N 操作的 ASINList输入参数指定了20个ASIN,而此操作只能获得其中18个ASIN的数 据,则此操作会返回这18个ASIN的结果,而不会导致整个请求失败。此操作还会显示失 败的其余两个ASIN。以 ASINList、 Seller sKulist或 Idlist作为输入参数的六个批量操作 33: GetMatchingProduct, Ge-MatchingProductForId, CetCcmpetitivePricingForSKJ, GetCompetitivePricingForAS 和 GethowestofferlistinasForAStno 以下示例显示了如何使用 ASINList输入参数在查询请求中指定3个ASIN。 https://mws.amazonservices.com/products/2011-10-01 ?AWSAccessKeyId=AKIAJGUVGEGHNKE2NVUA &Action=GetMatchingproduct SellerId=A2NK2PX936TE53 & signatureVersion=2 亚马逊商城网络服务商品部分参考(版本 亚马逊商城网终服务商品部分参考(版木 Timestamp=2012-02-07T013A223A392 Version=2011-10-01 Signature= MhSREjubAXTGS1 aGGWROxK4qvi3saW×1 inVE2FepJ○工e3D &signatureMe thod=HmaCSHA25 6 &Marketplaceid=ATVPDKIKXCDER &ASINLis-. ASIN. 1=B002KT3XRO &ASINLis-..ASIN.2=B002KT3XQC &ASINLis-. ASIN.3=B002KT3XOM 使用 SellersKu输入参数的查询请求的格式是类似的,只需将 CAsINlist.AS工N替换为 &SellersKulist. SellersKu,并将ASIN值替换为 SellersKu值。同样,使用Id输入参数的查询请求的格式 是类似的,只需将 CASTNT, st.λsTN替换为sτaist.τd,并将ASIN值替换为Id值 亚马逊MwS商品API部分中的批量操作会对请求中指定的各个商品编码(ASIN、 Sellers或Id)返回 个 OperationNameresult响应元素。每个 Operation Nameresult响应元素都包含一个 Status属性,用于 表明是否能为指定的商品编码返回数据;还包含一个ASIN、 SellerS或Id属性,用于表明请求中指定的 ASIN、 Seller sku或Id值。 下表显示了在亚马逊MWS商品ΔPI部分中执行批量操作所返回的响应元素。请注意,您可以从本文档中相 应的“响应示例”部分找到这些响应元素的示例。 批量操作中的响应元素 名称 描述 Operation NameResult 为请求中指定的各个商品编码(ASⅠN、 Sellers或Id)返回的 素。例如,如果您提交了 作,则此元素会被命名为 GetLowest offer Listings ForsKUResult Status Operation NameResult元素的个属性。表明是否能为指定的商品 编码(ASIN、 SellersKu或Id)返回数据。 有效值 Success-请求成功 Clienterror-请求失败。请求出现问题 Serη erRror·请求失败。网络服务出现问题 ASIN Operation. ameresult元素的一个属性。表明请求中指定的 ASIN 以ASIN为输入值的操作需要有此属性。 SellerS Operation. ameResult元素的一个属性。表明请求中指定的 SellerSKu 以 Sellers为输入值的操作需要有此属性。 IdType Operation NameResult元素的个属性。表明请求中指定的 IdType 以 IdType为输入值的操作需要有此属性。 Id Operation NameResult元素的一个属性。表明请求中指定的ld 以ld为输入值的操作需要有此属性。 Error 以下子元素的父元素:Type、Code、 Message 只在 status= Clienterror或 status= Servererror时返回此元素 亚马逊商城网络服务商品部分参考(版本 亚马逊商城网终服务商品部分参考(版木 名称 描述 可选项。 Code 导致响应失败的钴误类型。 示例: Internalerror。 可选项 表明是清求还是网络服务中的问题引发错误。 有效值 sender-请求出现问题 Receiver-网络服务出现问题。 可选项。 Message 包含提供更多错误信息的消息。 示例: seller.skU对于商城 ATVPDKIKXODER是一个无效 可选项。 Detaill 如果适用,包含其他任何谱情。 可选项 响应示例 <?×m1 version="1.0"?> KoperAtionnameresponsexmlns="http://mws.amazonservices.com/schema/ Products/2011-10-01"> < OperationNameresu1 t ASIN=”B002KT3XQy” status=” Success"”> <! Successful response goes here--> </OperationNameResult> < OperationNameresu1 ASIN=”B000015GsG” status=”C1 interior”> <Error> <Code>InvalidParametervalue</code> <Type>Sender</Type> <Message>B000C15GSG is an invalid ASIN for marketplace ATVPDKIKXODER</ Message> <Detail/> </Error> </OperationNameresult> <ResponseMetadata> <RequestId>454d8b3c-5514-4919-b5ca-6a08fb974272</RequestId> </ResponseMetadata> </OperationNameResponse> 限制 介绍商品API部分的限制规则。 商品API部分使用的限制类型不同于亚马逊MWS的其他API部分。对于商品API部分中将商品列表作为输 入参数的操作 (GetmatchingProduct GetMatchingProductForId GetCompetitivePricingForSKU GetCompe-itivePr-cingFOrASIN 亚马逊商城网络服务商品部分参考(版本 亚马逊商城网终服务商品部分参考(版木 和! GetMyPriceForASIN),其恢复速率是按商品数量计的。这一点与亚马逊MWS的其他操作的恢复速率相 反,即按请求数量计。系统将以每个亚马逊卖家账户和亚马逊MWS开发人员账户对为基础计算请求数量。 由于恢复速率按商品数量计,这样便提高了卖家同时査询多件商品的效率。在此情况下(如使用 扫描枪扫描一件商品),卖家可以在每个请求中包含一件商品。例如,假设卖家连续多次提交 GetlowestofferlistingsForsKυ操作,在用尽其请求限额后,卖家只需要等待一秒钟,便可以再连续提交10 个 GetlowestofferlistingsForSKU请求(前提是每个请求只包含一件商品)。 有关限制的更多信息,请参阅《业马逊MWS开发者指南》的限制部分 以下是商品API部分的限制恢复速率 操作 最大请求限额 恢复速率 ListMatchingeroducts 20个请求 每5秒钟1个请求 GetMatchingProduct 20个请求 每秒钟2件商品 GetMatchingProductForId 20个请求 每秒钟5件商品 etCompetitivePricing ForSKU FA 20个请求 每秒钟10件商品 GetcompetitivepricingFOrASIN GetL。 westofferListingsForSKU和 20个请求 每秒钟10件商品 GetT. ferT.i stingsForASTN Ge tMyPriceorSKU和 GetMyPriceforAs:20个请求 每秒钟10件商品 和 20个请求 每5秒钟1个请求 请注意 Getcompetitive?ricing ForsKU和 GetCompetitivepricingForASIN操作具有相同的最大请求限额和恢复 速率 t○ff orSKu和 操作具有相同的最大请求限额和恢 复速率 GetMyPriceForSKU和 GetMyPriceFOrASIN操作具有相同的最大请求限额和恢复速率。 GetProductCategoriesForsKU和 GetProductcategoriesForASIN操作具有相同的最大请求限额和恢复速 率 亚马逊商城网络服务商品部分参考(版本 亚马逊商城网终服务商品部分参考(版木 根据搜索査询,返回商品及其属性列表。 描述 ListMatchingProducts操作会返回一个包含商品及其属性的列表,该列表以您指定的搜索查询为 基础,按照关联性排序。您的搜索査询可以是用于描述商品的一个词组,或是一个商品编码(如 GCID、UPC、EAN、ISBN或JAN)。如果您有商品相应的ASIN,请使用 GetMatching Product操作。请注 意,商品编码不能为 Sellers。如果您的査询未返回任何匹配的商品,可以通过拼写校正或删除关键词来扩 大查询范围,从而获取匹配的商品。此操作最多会返回10件商品,但不包括无法购买的商品。 请求参数 名称 描述 必填项 Marketplaceld 商城编码。指定返回商品的商城 类型: XS. String Query 亚马逊商城网站所支持的搜索字符串。 是 示例: Query=哈利波特DVD 类型:xs: string Query ContextEd 在其中进行指定搜索的上下文的编码。商城可能会提供某些机,否 只搜索某些可能匹配的商品。例如,业马逊商城允许对某一分类进 行査询。 Query ContextEd参数用于指定此类范围。如果省略此项, 则会在商城的默认上下文中进行搜索,该上下文通常为最大商品范 围。有关可在各个亚马逊商域中使用的 Query ContextEd值的完整列 表,请参阅“ Query Contexted值” 类型: XS:String 响应元素 ListMatchingProducts操作返回的响应元素由以下公用XSD描述: Product.xsd:http:/g-ecx.images-amazon.com/images/g/01/mwsportal/doc/enUs/prOducts/product.xsd defaultxsd:http:/g-ecx.images-amazon.com/images/g/01/mwsportal/doc/enUs/prOducts/default.xsd 下表提供了关于 ListMatchingProducts操作所返回的一些关键元素的更多信息。 r Note:因为亚马逊会对亚马逊MNS高品AP部分进行更新,以包含新的响应要素,因而我们可能会 更新 Product xsd schema和 default xsd schema。如果您选择使用这些架构进行验证,请谨记这一点。 名称 描述 Product 包含 Product .xsd中 Product元素的四个子亓素。这四个子元素 为: Identifiers、 A ttributesets、 Relationships和 Salesrankings Identifiers 包含能够唯一标识商品的 MarketplaceASIN组合。 Attribulesets 包含 default. xsd中 ItemAttributes元素的商品属性(如果适用于所 返回的商品)。请注意,如果 Product响应元素的属性以多种语言 亚马逊商城网络服务商品部分参考(版本 亚马逊商城网终服务商品部分参考(版木 名称 描述 表述,则该元素会有多组属性。仝部属性(包括未被翻译的属性) 都会在每组属性中重复出现一次。各组属性使用的语言都巾lang 属性表示。 Relationships 包含商品变体信息(如果适用)。如果您的搜索条仁与某个 变体父ASIN相匹配,则 Relationships元素将包含相关的 Variation child元素。如果您的搜索条件与某个变体了ASIN相匹 配,则 Relationships元素将包含相关的 Varialionparent元素。 通过不同的AN值但相同的商品变体元素值来获得 Variation child元素。即使未返回用于区别商品变体子 ASIN的品属性,这些变体子ASIN也各不相同。 可以从 default. xsd的 Variation child元素中找到变体属性 Sales rankings 按商品分类排刎的商品销量排行信息 子元素 ProductCategoryld。表呋根据哪个商品分类进行销量排行 Rank。商品在其商品分类中的销量排行。 示例 查询请求示例 https://mws.amazonservices.com/products/2011-10-01 F AWSAccessKeyId=AKIAEXAMPLEFWR4Tu7ZQ &action=ListMatchingProducts sellerId=A1IMEXAMPLEWRC &signatureVersion-=2 Timestamp=2012-12-12T228322383250 Version-2011-10-01 &signature=V2BEXAMPLERT22Baj2FxwCo7y3PIifMFHegFINYWOEXAMPLEA3D &signatureMe thod=-HmacSHA256 &Marketplace id=ATVPDKIKXCDER Qery=0439708184 响应示例 <?xml version=1.0?> <lisTmatchingproductsResponsexmlns="http://mws.aazonservices.com/schema/ Products/2011-10-01"> <ListMatchingProductsresult> prodUctsxmlns="http://mws.amazonservices.com/schema/products/2011-10-01 xmlns:ns2=http://mws.amazonservices.com/schema/ Products/2011-10-01/ default. xsd"> Product> <Identifiers> <MarketolaceAStN> <Marketplaceid>ATVPDKIKXODER</ MarketplaceId> <ASIN>059035342X</AsIN> </ MarketplaceASIN> < /Identifie <Atributesets> <ns2: ItemAttributes xml: Lang=en-JS"> <ns2: Author>Rowling, JK</ 2 ns2. Author> <ns2: Binding>Paperback</ns2: Binding> 亚马逊商城网络服务商品部分参考(版本

...展开详情
试读 52P 亚马逊商品API详解
立即下载 低至0.43元/次 身份认证VIP会员低至7折
    一个资源只可评论一次,评论内容不能少于5个字
    tiger1978 很好用的资源
    2018-05-22
    回复
    lgtao30 官方文档啊
    2017-07-12
    回复
    z_hot 是官方文档
    2014-08-14
    回复
    关注 私信 TA的资源
    上传资源赚积分,得勋章
    最新推荐
    亚马逊商品API详解 43积分/C币 立即下载
    1/52
    亚马逊商品API详解第1页
    亚马逊商品API详解第2页
    亚马逊商品API详解第3页
    亚马逊商品API详解第4页
    亚马逊商品API详解第5页
    亚马逊商品API详解第6页
    亚马逊商品API详解第7页
    亚马逊商品API详解第8页
    亚马逊商品API详解第9页
    亚马逊商品API详解第10页
    亚马逊商品API详解第11页
    亚马逊商品API详解第12页
    亚马逊商品API详解第13页
    亚马逊商品API详解第14页
    亚马逊商品API详解第15页
    亚马逊商品API详解第16页

    试读已结束,剩余36页未读...

    43积分/C币 立即下载 >