ebay 官方文档 。ebay api开发者中心，商品检索，商品列表 检索物品列表数据的方法

 

本章讨论检索物品列表数据的方法。

副主题

浏览卖家的物品

检索一个项目的数据

向买家显示折扣价格信息

应用程序可以从易贝站点检索数据，以在应用程序的特定用户界面中显示或由应用程序处理。可以整组检索项目(例如特定卖家列出的项目列表)。这复制了易贝站点上的类似功能。也可以一次检索一个项目，这类似于易贝网站上的查看项目页面。

应用程序返回一个项目或一组项目的数据的一个原因是以可视格式显示项目数据。然后，应用程序的最终用户可以看到这些数据，并使用这些信息作为采取某些行动的基础，例如卖家修改商品或买家对商品进行投标。

检索项目数据的另一个原因是在用户界面或人工干预的环境之外对项目数据进行编程处理。例如，应用程序可以检索特定卖方的项目列表，以评估投标活动，仅在存在预定条件时提醒卖方(如拍卖即将结束，当前有高出价者)。

应用程序使用GetSellerList。检索单个项目的数据是用GetItem。大多数情况下，使用它更经济GetSellerList检索项目列表并对其进行操作比使用GetItem多次。这样做可以节省应用程序调用API的次数(每小时、每天和每月都有限制)。它还减少了与易贝网站交流和互动的总在线时间。

有关的信息GetSellerList，包括执行调用和业务逻辑，请参见GetSellerList。有关的信息GetItem，参见GetItem.

浏览卖家的物品

要检索特定卖家列出的商品列表，请使用GetSellerList.

GetSellerList调用参考

https://developer . ebay . com/DevZone/XML/docs/Reference/易贝/GetSellerList.html

在所有呼叫中，必须至少指定一个日期范围筛选器。

您可以指定一个详细级别来控制响应数据。如果您设置了详细级别，您必须设置分页值。请指定将被退回物品的卖家的易贝会员帐号。该输入是可选的。如果没有指定，发出请求的用户将被视为商品被退回的卖家。

给定卖家可以退回的商品数量可能很大。若要减少返回的项目数，请使用基于日期的筛选输入。这些工具根据项目开始时间、项目结束时间或项目上次修改时间来筛选数据。应用程序使用这种过滤将项目限制在给定操作的上下文中感兴趣的项目。例如，如果上下文要求只检索在特定日期结束的项目，那么应用程序就不应该过滤在给定月份内结束的所有项目。

基于日期的过滤器成对工作，用最早(最早)的感兴趣日期和最晚(最近)的感兴趣日期来描述日期范围。例如，如果您正在检索在特定日期结束的项目，该范围内的最早日期可能是感兴趣的早晨午夜后一秒钟，在该日期之前结束的项目都不会感兴趣。

该范围中的最晚日期可能是当天晚上的午夜，在该日期之后结束的项目都不是感兴趣的。当使用一个滤波器输入时，还必须使用另一个匹配的滤波器元件(应用程序必须始终指定两者过滤日期范围的最早日期和最近日期)。例如，如果结束时间从(因为筛选日期范围基于结束日期)则结束时间也必须指定。必须至少指定一个日期范围筛选器。每个呼叫可以使用多个日期范围过滤器。例如，单个调用可以返回在一个日期范围内结束的项目(一个过滤器)加上在指定日期范围内开始的项目(第二个过滤器)。

基于日期的筛选器是单独可选的，但必须至少指定一个(适用于所有详细程度)。

另一种减少单个调用中返回的项数的方法是通过分页。分页将整个数据集分解成更小的块，可能更便于应用程序使用。

如果返回零个项目，则不会返回“无效页码”错误。

例如，如果卖方有100件商品符合调用的其他选择标准，应用程序可以进行一次调用，检索所有100件商品，或者进行十次调用，每次检索10件商品(十页，每页十件商品)。

在哪里GetSellerList就输入而言，分页是通过指定每页数据中要返回的项数(即每次调用)和要返回的页码来控制的。第一个调用将返回卖家商品的第1页。调用结果集中的数据指示是否有其他项要检索以及有多少项。应用程序可以使用该信息来确定是否需要进行额外的调用，并根据页面大小(每页的项目数)来确定需要对所有要检索的项目进行多少次额外的调用。如果需要额外的调用，每个后续调用指定一个递增的页码，以检索项目的每个后续页面。如果没有为调用指定每页的项目数和页码，则不会进行分页，调用会尝试将项目作为单页数据进行检索。

如果指定了详细程度，则需要分页。只有通过使用最小的结果集(没有指定详细级别),才能在没有分页的情况下进行调用——不管将返回多少项。

使用检索的项目GetSellerList可以根据返回项目的结束日期进行排序。它会传回卖家列出的物品。

有一个ItemType对象，并满足输入筛选条件。还返回了指示符，指示返回了多少项，以及是否有其他项可以返回(满足条件的其他项需要额外的调用来检索)。结果集还包含返回数据的页码、每页返回的项目数以及符合选择标准的项目总页数。

应用程序需要遍历这个项目数组来访问每个ItemType对象并检查其属性。

当列表包含目录产品详细信息，并且卖家选择在列表中包含附加的库存摘要信息时描述字段是可选的。这意味着由返回的项目GetSellerList(和其他项检索调用)不保证在描述字段。看见用产品细节预先填写项目细节了解更多关于产品详细目录列表的信息。

检索一个项目的数据

若要检索单个项目的数据，请使用GetItem。这样做包括三个一般步骤:设置执行环境、指定要返回的数据(基于项目ID)以及进行API调用。

检索单个项目的数据需要为要返回的项目指定项目ID。

GetItem返回一个项目的数据。结果集包含一个ItemType对象，它包含该项的数据。参见GetItem中的文档易贝贸易API参考详情请见。

GetItem调用引用

https://developer . ebay . com/DevZone/XML/docs/Reference/易贝/GetItem.html

检索具有项目细节和/或产品数据的项目

如果列表包含项目细节，则在您执行时会返回项目细节GetItem与退货单或者ItemReturnAttributes细节层次。类似地，如果列表包含目录产品详细信息，则产品详细信息将与这些详细信息级别一起返回。

当您在某些类别(或者更具体地说，某些特征集)中列出时，GetItem可能会返回从其他属性值计算出的其他项目细节。这意味着属性集对象可能不总是与属性集卖家提交的。例如，假设类别的项目细节包括城市(例如，“圣何塞”)、州(例如，“CA”)和邮政编码(例如，“95125”)的单独属性。在某些类别中GetItem响应可能包含这些属性以及一个附加属性，该属性在一个字段中显示所有三个值(例如，“San Jose，CA 95125”)以供显示。

当列表中包含产品详细信息，并且卖家选择在列表中包含附加的库存摘要信息时描述字段是可选的。这意味着由返回的项目GetItem(和其他项检索调用)不保证在描述场。

中的项目细节数据GetItem响应包括属性和值id，以及指定id的文字值。如果您的应用程序保存了从GetAttributesCS这在列表开始日期时是有效的，您可以使用元数据来确定每个属性的显示名称。

向买家显示折扣价格信息

删除线定价和最低广告价格显示处理仅适用于那些有资格参与折扣定价计划的卖家。如果您有兴趣成为该计划的成员，请联系您的客户经理或客户服务代表。

一些易贝的固定价格物品有折扣价格信息，它指定了物品的原始零售价格以及关于卖方折扣价格的视觉处理的附加信息。以下部分描述了价格信息的以下两种可视化处理方式及其正确使用:

• 删除线定价
• 最低广告价格(地图)

对于刊登物品的最低广告价格，以及卖家指定的低于最低广告价格的价格，你必须遵守向潜在买家显示物品价格的规则。您受API许可协议条款的约束，必须遵守这些规则。有关不符合的后果，请参考API许可协议。

由于最低广告价格处理的法律含义，向购买者显示商品价格的应用程序必须首先检查商品的折扣价格信息(例如，项目。DiscountPriceInfo)和具体的价格待遇(如:项目。discount price info . pricing treatment)来确定项目价格是否需要特殊的显示处理。折扣价格信息由Finding API搜索调用返回，GetSingleItem和GetMultipleItems在购物API中，并且GetItem在交易API中。

折扣定价信息的显示规则和指南适用于有效和已完成的项目。

没有由降价管理器或相关API调用指定的与促销销售相关联的特定定价显示规则(例如，SetPromotionalSale).如果为列表指定了删除线价格或最低广告价格，它将取代任何促销处理。

显示删除线定价的准则

删除线定价适用于美国易贝、英国易贝、德国易贝、加拿大易贝(英语和法语)、法国易贝、意大利易贝、西班牙易贝网站。这些站点中的每一个站点对于用DiscountPriceInfo元素。

删除线定价是一种视觉处理，由删除线字体的“原始”价格和非删除线字体的当前折扣商品价格组成。原价是同一件商品或几乎相同的商品的销售价格(不包括运费和手续费)。在英国和德国(DE)的网站上，卖家也可以指定他们已经在易贝或其他地方提供了类似的商品。

注意:支持这一功能的网站都使用不同的符号和措辞进行删除价格显示处理。例如，美国站点使用短语“比较于”，而英国站点使用“RRP”，德国站点使用“UVP”。

确定适用性

删除线定价的显示规则适用于与折扣定价信息一起列出的物品定价处理返回STP。为了符合STP展示处理的资格，物品起始价格价格必须低于原始零售价格如下面来自交易API的XML响应片段所示:

删除线定价的API回应示例

...
<StartPrice currencyID="USD">149.99</CurrentPrice>
...
<DiscountPriceInfo>
   <OriginalRetailPrice currencyID="USD">159.99</OriginalRetailPrice>
   <PricingTreatment>STP</PricingTreatment>
   <SoldOneBay>true</SoldOneBay>
</DiscountPriceInfo>
...

折扣价格信息的响应XML可能会因API的不同而略有不同。

治疗规则

对于包含删除线定价信息的列表，您不需要使用删除线定价处理。您可以简单地显示商品价格，而无需任何特殊处理。

如果您选择提供删除线定价处理，应用程序应该显示“原始”价格(项目。DiscountPriceInfo . OriginalRetailPrice)连同框项目价格(项目。起始价格)和表示有折扣的文本(例如，“比较价格”)。英国易贝和德国易贝站点的折扣显示处理略有不同，如下所述。

如果物品列在英国或德国(DE)网站上，物品还可以包括索尔多恩贝或者出售易趣字段，如果使用该字段，则表明同一卖家在过去60天内以原始零售价格价值。

下图提供了美国网站上删除线定价视觉处理的示例。易贝用星号做了一个脚注，解释“比较”价格来自另一家在线零售商，而不是易贝。

当对易贝列表应用删除线定价处理时，您的应用程序应该显示或包含一个链接，该链接在隐藏项目价格的页面上显示说明性文本。美国的说明文字应如下所示:

“比较价格”是卖家提供的价格(不包括运费和手续费)，是同一件物品或几乎相同的物品在过去90天内出售的价格。

对于在英国或德国(DE)列出的打折商品，根据需要修改此文本。

英国网站上的删除线显示处理

易贝英国站点采用以下删除线处理方式:

• 如果某个项目符合删除线定价，项目显示会显示RRP随后是删除线价格。在这下面，You save显示以英镑为单位的节省金额:

  

• 如果物品在过去30天内由同一卖家在易贝出售，物品显示会显示Was随后是删除线价格。在这下面，You save显示以英镑为单位的节省金额:

  

• 如果该物品在过去30天内曾由同一卖家在易贝以外的地方出售过(无论是在另一个网站上还是在离线商店中)，物品显示会显示Was*跟随一个删除线价格。在这下面，You save显示以英镑为单位的节省金额:

  

德国(DE)网站上的删除线显示处理

德国易贝站点采用以下删除线处理方式:

• 如果某个项目符合删除线定价，项目显示会显示UVP随后是删除线价格。在这下面，Sie sparen以欧元显示节省的金额:

  

• 如果物品在过去60天内由同一卖家在易贝出售，物品显示会显示Urspünglich随后是删除线价格。在这下面，Sie sparen以欧元显示节省的金额:

  

• 如果该物品在过去30天内曾由同一卖家在易贝以外的地方出售过(无论是在另一个网站上还是在离线商店中)，物品显示会显示Was*跟随一个删除线价格。在这下面，Sie sparen以欧元显示节省的金额:

  

最低广告价格的显示规则

仅易贝美国网站支持最低广告价格。

虽然卖家可以自由设定他们认为合适的商品价格，但一些制造商限制某些商品的价格如何显示或传达给其他人。当列表包括最低广告价格(MAP)折扣定价信息时，当项目价格低于制造商设置的最低广告价格时，法律要求向买家显示项目价格。如果卖家对商品的定价低于最低广告价格，应用程序就不能在任何页面上显示价格，直到买家采取进一步的行动(比如点击按钮或链接)。

如果商品价格大于或等于最低广告价格，则不需要特殊处理来显示价格。

确定适用性

当刊登物品的折扣价格信息导致以下情况时，适用最低广告价格的显示规则定价处理返回MAP。为了符合地图显示处理的条件，该物品起始价格价格必须低于最小广告价格如下面来自交易API的XML响应片段所示:

最低广告价格的API响应示例:

...
<StartPrice currencyID="USD">149.99</CurrentPrice>
...
<DiscountPriceInfo>
   <OriginalRetailPrice currencyID="USD">159.99</OriginalRetailPrice>
   <MinimumAdvertisedPrice currencyID="USD">154.99</MinimumAdvertisedPrice>
   <MinimumAdvertisedPriceExposure>DuringCheckout</MinimumAdvertisedPriceExposure>
   <PricingTreatment>MAP</PricingTreatment>
</DiscountPriceInfo>
...

折扣价格信息的响应XML可能会因API的不同而略有不同。

治疗规则

当最低广告价格的显示规则适用时，应用程序不能显示卖方的较低价格，直到买方采取进一步的行动。如果曝光设置(项目。discount price info . minimum advertised price exposure)是PreCheckout，买家可以点击链接或按钮，在弹出窗口或后续页面中查看商品的价格。如果曝光设置恢复DuringCheckout，价格会显示在易贝结账流程中的“检查和确认”页面上，或者显示在支持结账功能的第三方应用程序的类似页面上，例如要约收购。如果您的应用程序将买家送到易贝结账，当曝光设置为时，您的应用程序不应向买家显示商品价格结账时.

下图显示了当商品价格低于指定的最低广告价格时允许的视觉处理。用户必须点击“查看价格详情”链接才能查看商品价格。

当对易贝列表应用最低广告价格处理时，您的应用程序必须在隐藏项目价格的页面上显示或包含显示以下说明性文本的链接:

卖家有权独立设定自己的价格，但一些制造商对这些价格如何显示或传达给其他人设置了限制。因为这件物品的卖家价格低于制造商的“最低广告价格”，制造商可能不会允许卖家向您显示卖家的更低价格，直到您采取进一步的行动，如单击下拉菜单、将物品放入您的购物车或继续结帐。所需的步骤取决于制造商的最低广告价格政策的条款。采取这些步骤可以让易贝向您展示卖家的优惠价格，这与易贝的目标是一致的，即始终为像您这样的消费者提供尽可能最低的价格和最广泛的产品选择。

你应该知道，通过采取这些步骤，你不会被要求购买该产品。如果您决定不购买该商品，您可以随时从购物车中删除该商品或不进行结账。

折扣定价的这些显示规则适用于有效项目和已完成项目。

附加折扣定价信息

有关折扣定价的更多信息，请参见以下资源:

• discountPriceInfo查找API参考中的描述
• DiscountPriceInfo购物API参考中的描述
• DiscountPriceInfo交易API参考中的说明