eBay大中华区API开发者平台 开发者专区

搜 索
Promoted Listing API 开发示例 发布时间:2017-04-19

Promoted Listing API属于Sell API中的Marketing API的一部分,采用eBay新Oauth token验证。


有关Sell APIOauth的内容,详细请查看:http://developer.ebay.com/devzone/rest/ebay-rest/content/oauth-tokens.html

更多关于Promoted Listing API的内容,请查看:英文 中文

API索引:英文 中文

API支持Promoted Listing (PL) 管理的整个过程,实现方式直接简洁。举例说明:


首先,创建一个活动

Create Campaign

Request:

Post https://api.ebay.com/sell/marketing/v1/ad_campaign

Headers:

Authorization:Bearer v^1.1#i^*--------------You need Oauth user token here------------AA=

Content-Type:application/json

Body:

{

 "campaignName": "Spring Sale Eden",

 "startDate": "2017-04-11T21:43:00Z",

 "fundingStrategy": {

   "bidPercentage": "10.0",

   "fundingModel": "COST_PER_SALE"

 },

 "marketplaceId": "EBAY_US"

}

确保StartDate处于一个将来的时间。这样我们的PL活动就创建成功了。


接下来往活动里添加物品刊登

Create Ad By Listing Id

Posthttps://api.ebay.com/sell/marketing/v1/ad_campaign/1009XXXX13/ad

Headers:

Authorization:Bearer v^1.1#i^*--------------You need Oauth user token here------------AA=

Content-Type:application/json


Body:

{

"bidPercentage": "10.0"

"listingId": "112xxxxx55"

}


这样我们的刊登就加入到推广活动中了! 

 

效果图如下:




在创建的过程中,你可能会遇到不同的问题或错误:


 • 比如说因为Token不合法:

"longMessage" : "Access token is missing in the Authorization HTTP request header."


 • 比如说没有同意PL的合约规则:

"message": " The seller must accept the Promoted Listings terms and conditions. Please accept Promoted Listings terms and conditions by visiting this link http://www.ebay.com/pl/agreement ."


使用PL API 需同意相关站点的合约规则:



详细内容:http://developer.ebay.com/devzone/rest/sell/content/marketing/overview.html#Promoted


   • 使用API查询不到某些活动:

目前,通过后台创建的活动和使用API创建的活动是独立的。API不会返回通过后台创建的内容; API创建的活动在后台页面不可编辑,只能通过API操作管理。

成为eBay开发者

  • 大的电子商务技术平台
  • 丰富的编程接口和工具
  • 支持你所熟悉的开发语言
立即注册