发布时间：2017-04-19 最近刷新时间：
Marketing API 是给卖家和商家管理Promoted listings生命周期和物品推广的API。 本文的叙述包括以下几个方面。
* 技术概述
* 商业用例
* API 要求和限制
技术概述
以下列举了Marketing API涉及到的几个主要对象：
*活动 (CAMPAIGN)
* 广告 Ads (the promoted listings)
* 活动Id Campaign Id
* 站点Id Marketplace Id (site where campaign is hosted)
* 活动名称 Campaign Name
* 费用策略 Funding strategy (seller fee)
* 起始及结束日期 Start and end dates
* 广告 (AD) - 有3种方式生成
* 根据一组规则（品牌，品类，物品状况，高售价，低售价）从卖家的库存中选取刊登列表
* 卖家的库存刊登Id列表
* eBay 刊登ID 列表
*刊登ID (LISTING ID )
* 一个特定刊登的Id
* 一个多属性刊登的主刊登的ID， 比如说刊登为一件提供多种尺寸和颜色的T恤衫。
商业用例
这个部分列举出了Marketing API 支持的一些标准用例
创建基于规则的 Promoted listing 活动
你可以使用Create Campaign call来创建基于规则的Promoted listing 活动， 活动包括一个或多个campaignCriterion容器 （容器定义了一组挑选刊登的规则）。
你也可以使用Clone Campaign call重新创建已有的基于规则的活动。 一个活动如果终结了，就只能被克隆。
创建基于库存的Promoted listing 活动
你可以使用Create Campaign call 来创建基于库存的Promoted listing活动。 然后，使用其中一个广告的calls ( 比如说Create Ads in Bulk By Inventory Reference Id 或 Create Ads in Bulk By Listing Id ), 传入一组卖家的库存Ids或是eBay 刊登Ids来创建活动。
管理Promoted listing 活动的生命周期
Marketing API 有下面这些功能来帮助你管理Promoted listing 活动的完整的生命周期
* 创建，结束，暂停，恢复和删除活动
* 创建，暂停，恢复，删除活动
* 更新活动或促销的某个字段
* 根据名字，活动ID，或是刊登ID 检索特定活动
* 根据ID检索促销
* 根据刊登ID检索广告
* 检索所有的活动或促销
API 要求和限制
下面这个部分讲述创建promoted listing 活动的要求和限制。
Promoted Listings 支持 以下站点：
* eBay US (United States)
* US-Motors (non-fitment listings)
* UK (United Kingdom)
* DE (Germany)
* AU (Australia)
请注意： 沙盒环境暂不提供***的Promoted Listing 服务，因此无法在沙盒环境执行完整的从头到尾的测试。
Promoted Listings 对卖家要求：
* 卖家必须是有效的店铺订阅者
* 卖家必须接受相应站点的条款和条件：
Promoted Listings 对刊登的要求：
* 必须是固价商品
* 必须是多库存商品
* 必须是Promoted Listings支持的类目
* 不可以是地产或汽配类商品
