客服电话：13904310313 
程序消息
我们希望大家都好。我们想借此机会与您分享最近一个季度（2025年7月至9月）的一些eBay开发人员计划更新。
在新指南体验中提供了五个新指南
以下两个新指南被添加到新的指南登录页面https://developer.ebay.com/develop/guides-v2：
- 清单创建指南：此API用例指南涵盖了创建单个sku和多个sku清单、批量创建清单以及基于现有eBay Catalog产品生成清单。
- 清单管理指南：这个API用例指南涵盖了如何修改、重新列出、检索和结束eBay活动列表。
以下三个参考线不是新的，但已被重新格式化为新的参考线体验。如果您已将这些指南的先前版本加入书签，我们建议您更新您的书签：
- 使用eBay REST指南：本指南提供了入门和使用eBay REST api的高级信息。
- 授权指南：本指南涵盖了在进行API调用时生成和使用OAuth令牌所需了解的所有内容。
- 数字签名指南：本指南涵盖了在受影响的API调用的HTTP有效负载中创建和添加数字签名的完整过程。 数字签名只需要开发人员代表欧盟/英国卖家进行API调用。
数据处理更改
eBay的API集成将被修改，以满足特定用户的数据处理需求。 这一变化将影响在以下司法管辖区运营的第三方开发者：中国（及其领土）、俄罗斯、朝鲜、古巴、伊朗和委内瑞拉。 使用/返回公共eBay用户名的公共eBay API字段将被替换为不可变的用户id，并且某些用户的财务数据将受到保护。 有关此更改的更多详细信息和受影响的公共API字段的完整列表可以在我们的数据处理合规文档中找到。
在美国创建合规的损益清单
从今年7月开始，eBay实施了一项“免费和轻松”退货政策，即美国市场上的零部件和配件清单，如果符合一定标准，必须在30或60天内为买家提供免费退货。 请参阅卖方中心的Boost买方信任与新的P&A退货政策页面，了解更多信息，完整的标准列表和全套常见问题解答。
Add和revision api已经为不兼容的列表返回警告，这些警告将从10月7日左右开始转换为阻塞错误。 请与您的卖家合作，以确保他们的美国零件和配件清单符合此政策。 有关通过Trading API或Account v1 API的Fulfillment Policy对象创建合规退货策略的具体信息，请参阅部件和配件集成指南主题中的支持轻松退货。
为了帮助抵消成本，eBay将向卖家提供eBay退货标签的50%折扣。
首席运营官/制造商区域方面的变化
向美国发货的eBay卖家应在其清单上提供有关商品产地的信息，以实现符合美国关税要求的透明运输体验。以下是开发者和卖家需要注意的两点：
- 自9月12日起，时尚或珠宝等类别的原产国部分已更改为材料来源。
- 10月份，国家/地区制造方面（适用于大多数eBay类别）将更改为原产国，并且该方面名称应用于所有eBay市场上运往美国的所有清单，而不是国家/地区制造。
建议开发人员使用或继续使用getItemAspectsForCategory方法或fetchItemAspects方法和Taxonomy SDK来监控受影响类别从制造商的国家/地区到原产国方面名称的切换。
所有媒体API POST调用的短时间呼叫限制
Media API中的所有POST方法都有每5秒50个请求的短时间调用限制。 如果超过此短时间呼叫限制，将发生错误。 这并不是一种新的行为，但是这个速率限制只是在本季度的文档中提出的，以帮助防止触发与超出此速率限制相关的任何错误。 此说明已添加到所有POST方法参考文档中，也添加到API调用限制页面中。
允许对类别ID 173651进行目录产品编辑
作为排放控制失败设备策略的一部分，调谐设备和软件功能类别（类别ID 173651）中的产品必须引用eBay目录产品。 到目前为止，卖家不允许对目录中的任何产品细节进行任何编辑，但如果他们愿意，现在可以对标题和/或描述进行修改。 他们仍然不能对产品的项目细节进行任何更改。 有关更多特定于api的信息，请参阅优化设备和软件集成指南主题。
时尚二手物品条件扩大
这三种“二手”物品条件在全球范围内推出，涉及另外159个类别，包括女性手袋、配饰、珠宝和鞋子。
提醒一下，这里有三个条件id（用于交易API）和条件枚举（用于库存API）用于“二手”物品条件：
| 条件的名字 | 条件ID值 | 条件Enum值 |
|---|---|---|
| 二手-优秀 | 2990 | PRE_OWNED_EXCELLENT |
| 二手-很好 | 3000 | USED_EXCELLENT |
| 二手-展览会 | 3010 | PRE_OWNED_FAIR |
元数据API的getItemConditionPolicies方法中的项目条件元数据已经针对新支持的叶子类别进行了更新。
翻新计划推出更多类别
eBay翻新计划在第三季度继续增长，2025年该计划增加了500多个叶片类别，使叶片类别总数超过2200个。 在eBay翻新计划中，有四种不同的翻新物品条件，包括认证翻新（ID 2000），优秀翻新（ID 2010），非常好翻新（ID 2020）和良好翻新（ID 2030）。 卖家在使用四种翻新物品条件中的任何一种之前，必须经过申请和审查程序。
eBay翻新计划适用于以下垂直领域的树叶类别：家庭和花园、商业和工业、电子、时尚、汽车、珠宝和手表、生活方式和收藏品。 对于支持eBay翻新计划的所有叶子类别，不能再使用卖方翻新（ID 2500）的物品条件，卖家必须将条件更改为已使用（ID 3000），或者如果他们申请并有资格使用该物品条件，则使用较新的翻新条件之一。
关于eBay翻新计划的更多信息可以在eBay翻新计划卖家中心页面上找到，包括应用程序的链接和一个可下载的电子表格的链接，其中有500多个叶子类别，这些类别在2025年成为该计划的一部分。 元数据API的getItemConditionPolicies方法可用于检索eBay翻新程序支持的所有叶子类别。
卖家新的自动反馈功能
反馈分数和积极反馈百分比对卖家来说是非常重要的指标。大多数交易都很顺利，卖家提供了很好的服务，但并不是每个买家都会通过提供反馈来认可好的服务。从2025年9月3日起，卖家将自动收到符合以下标准的成功销售交易反馈：
- 你们发货时有跟踪，货物在预期交货范围内到达
- 买方没有报告任何问题
- 买家没有留下任何反馈
通常情况下，如果买家还没有留下反馈，卖家会在交易完成七天后自动收到eBay的积极反馈。如果买家在自动反馈已经存在之后留下了积极的反馈，买家的反馈评论将取代eBay的反馈评论。对于每笔销售交易，买家不会知道eBay已经为卖家留下了自动反馈，所以他们不会失去留下反馈的动力。
API的更新
本季度对我们的api进行了以下更新。
支持订单api中的多仓库功能
对于拥有多个仓库并实现了eBay多仓库功能的卖家，Fulfillment API和Trading API的订单管理方法现在返回离买家位置最近的仓库位置。
无论您使用哪个清单API，您都需要使用库存API的createInventoryLocation方法创建一个FULFILLMENT_CENTER位置（带有完整地址），然后您将使用createOrReplaceSkuLocationMapping方法将多个FULFILLMENT_CENTER位置映射到清单。 请注意，createOrReplaceSkuLocationMapping方法在SKU级别映射了FULFILLMENT_CENTER位置，因此对于多个SKU列表，需要多次使用createOrReplaceSkuLocationMapping方法。 无论您是使用库存API还是交易API，请参阅2024年第四季度通讯，了解将多个仓库关联到清单的过程的更多信息。
对于具有多仓库功能的清单，在Fulfillment API的getOrder和getOrders方法中的itemLocation容器以及Item中，将返回离买方最近的FULFILLMENT_CENTER位置的地址。交易API的GetOrders、GetSellerTransactions和GetItemTransactions调用的位置字段。
eBay保证适合在履行API支持
作为eBay US Motors P&A清单的eBay Guaranteed Fit计划的一部分，买方的车辆方面将在Fulfillment API中的getOrder和getOrders方法的compatiityproperties数组中返回。 为了利用eBay保证匹配计划，买家需要提供车辆的年份、制造、型号和装饰，这些方面将在订单详细信息中返回，以便卖家可以验证车辆是否与零件或配件兼容。
电机/焦糖结帐详细信息返回顺序api
对于使用eBay的安全购买程序在eBay US Motors上购买的机动车辆，此购买的详细信息将通过交易API的GetOrders和GetItemTransactions的新MotorPurchase容器返回。 有了安全购买，买家可以安全地支付汽车的全部余额，很容易获得融资和/或保险，甚至让eBay来处理车管所相关的任务，比如缴纳税款和车辆所有权。 有关详细信息，包括许多常见问题，请参阅安全购买主题。
在Feed和元数据api中支持CAFR和BEFR
eBay加拿大（https://www.cafr.ebay.ca/）和eBay比利时（https://www.befr.ebay.be/）网站的法语版本现在由Sell Feed API和Metadata API的所有方法支持。 无论您是使用Sell Feed API在其中一个eBay市场上列出/修改项目，还是使用Metadata API从其中一个eBay市场中检索列表元数据，您都必须设置以下HTTP标头如下：
- eBay加拿大（法语）：包括X-EBAY-C-MARKETPLACE-ID标头并将其值设置为
EBAY_CA，并包含Accept-Language头，并将其值设置为fr - ca. - eBay比利时（法语）：包括X-EBAY-C-MARKETPLACE-ID标头并将其值设置为
EBAY_BE，并包含Accept-Language头，并将其值设置为fr-BE.
媒体API中支持的新文档类型
Media API的文档资源现在支持accessbility_information作为createDocument和createDocumentFromUrl方法中的documentType值。 的 ACCESSIBILITY_INFORMATION 文档类型被描述为提供“产品可访问性特征的详细信息，确保有残疾或特殊需要的个人可以使用”的文档。
促销清单活动报告更新
本季度对销售营销API中的推广列表报告进行了以下更新：
- 对于所有活动reportType值，当dimensionKey值设置为
seller_keyword_id，以下注解键值可用： keyword_bidkeyword_status- 对于所有活动reportType值，当dimensionKey值设置为
campaign_id，以下注解键值可用： campaign_statusdaily_budget（仅限中国共产党宣传活动）daily_budget_status（仅限中国共产党宣传活动）- 对于所有活动reportType值，当dimensionKey值设置为
listing_id,listing_status是新支持的annotationKeys值。 - 当reportType值设置为
CAMPAIGN_PERFORMANCE_REPORT，并将dimensionKey值设置为campaign_id，以下注解键值可用： listing_strategybudget_strategy- 当reportType值设置为
TRANSACTION_REPORT,sales_typedimensionKey值现在可用于CPC和CPS资助模型。
新的库存映射API参考文档
新的参考文档体验现在完全适用于新的GraphQL Inventory Mapping API。 请注意，这个API目前仍然仅限于选定的合作伙伴。 对于已经使用此API的开发人员，请注意新的参考文档已经取代了库存映射手册，并且该手册已经存档。
慈善详细信息添加到浏览API项目方法
现在可以为getItem、getItembyLegacyId和getItemsByItemGroup方法返回charityTerms容器。 要返回这个新容器，列表必须是慈善列表，并且必须将其中一个字段组值设置为 CHARITY_DETAILS. 新的charityTerms容器中的慈善信息包括charityOrgId、名称、donationPercentage、网站和用于慈善标志图像的imageUrl。
向Notification API添加了两个新主题
以下两个新主题被添加到Notification API：
- BUYER_REQUESTED_PURCHASE_QUOTE：如果卖方希望在买方在支付订单之前请求订单的总价格时收到通知，则可以订阅此主题。 当要求订单总额时，卖方通常会向买方发送发票。
- LISTING_PREVIEW_CREATION_TASK_STATUS：如果卖家正在通过库存映射API为他们生成列表预览，则可以订阅此主题，并且在列表预览任务完成时发送此主题。
注意：此通知主题只能由具有受限库存映射API访问权限的开发人员使用。
增强了eBay Delivery International Shipping API
eBay Delivery International Shipping API已经增强了一个包含四个新方法的新bundle资源。 卖家可以使用这些方法为订单中的多个包创建一个捆绑包、检索一个捆绑包、取消一个捆绑包或检索一个捆绑包标签。还用四个新的枚举值更新了ConsignTypeEnum类型。
注意：此API仅限于选择支持大中华区eBay卖家的运输和履行的开发人员。
SellerAccept枚举值添加为新的最佳报价状态
一个新的SellerAccept枚举值被添加到交易API的BestOfferStatusCodeType中。 在GetBestOffers响应中，将返回这个新的枚举值，以指示卖方已接受买方的报价，但买方尚未付款。 一旦买方完成付款，状态将更改为已接受。
eBay弃用和退役更新
以下api已于第三季停用：
此外，在遵从性API中对ASPECTS_ADOPTION遵从性类型的支持以及在交易API中对UploadSiteHostedPictures调用中的ExtensionInDays字段的支持已经结束。
以下api在第三季度被标记为已弃用：
- 交易API的GetCategoryFeatures方法。
- Post-Order API中面向买家和使用率较低的方法，包括16个Return方法、4个Case Management方法和5个Inquiry方法。 有关完整列表，请参阅弃用状态页面。
- 产品元数据API的所有方法。
- Product API的getproductcompatible调用。
由于使用率极低或根本不存在，以下平台通知事件类型已被停用，用户将无法再订阅这些事件： AccountSuspended, BuyerNoShow, AccountSummary,, EBNOrderCanceled, EBNOrderPickedUp, EmailAddressChanged, PasswordChanged, PasswordHintChanged, PaymentDetailChanged.
我们希望每个人都有一个伟大的第三季度，我们期待着在2025年的剩余时间里与社区合作！
真诚地,
eBay开发人员计划
