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

搜 索
Promoted Listing 调用索引 发布时间:2017-04-19

此API参考文档描述了Marketing API的每一个调用的基本元素和属性。


Marketing API使卖家能够管理 Promotions Manager促销和Promoted Listings 完整的生命周期(创建,查看,更新和删除)。


请注意:使用这套API,卖家必须接受相应站点的Promotions和/或Promoted Listings 条款和条件;必须是有效的ebay店铺订阅者。更多要求和限制在 Marketing Overview中有详细介绍。


下表根据功能属性列出这套API所涉及到的调用:



调用

简介

广告 AD

 

Bulk Create Ads By Inventory Reference

POST /ad_campaign/{campaign_id}/bulk_create_ads_by_inventory_reference

 

根据卖家库存引用清单创建广告, 并将该广告与指定活动关联。

 

一个卖家的库存引用ID (A seller's inventory reference ID) 是指一个刊登的标识或是一个多属性刊登的主刊登的标识,比如说主刊登为一件提供多种尺寸和颜色可选的T恤衫。 你必须要同时指定 inventory_reference_id 和 inventory_reference_type

 

一个卖家的库存引用ID,更广泛认知为刊登的 SKU 或是 custom label

Bulk Create Ads By Listing ID

POST /ad_campaign/{campaign_id}/bulk_create_ads_by_listing_id

 

根据卖家刊登IDs清单创建广告, 并将该广告与指定活动关联。

 

eBay  刊登IDs是在该刊登被创建时由eBay生成。

 

Bulk Delete Ads By Inventory Reference

POST /ad_campaign/{campaign_id}/bulk_delete_ads_by_inventory_reference

 

使用卖家的库存引用ID将广告从指定活动中删除。

 

一个卖家的库存引用ID (A seller's inventory reference ID) 是指一个刊登的标识或是一个多属性刊登的主刊登的标识,比如说主刊登为一件提供多种尺寸和颜色可选的T恤衫。 你必须要同时指定 inventory_reference_id 和 inventory_reference_type

 

一个卖家的库存引用ID,更广泛认知为刊登的 SKU 或是 custom label

Bulk Delete Ads By Listing ID

POST /ad_campaign/{campaign_id}/bulk_delete_ads_by_listing_id

 

使用卖家刊登IDs将广告从指定活动中删除。

 

Bulk Update Ad Bids By Inventory Reference

POST /ad_campaign/{campaign_id}/bulk_update_ads_bid_by_inventory_reference

给指定活动中的卖家库存引用清单更新(替换)广告价格。

 

一个卖家的库存引用ID (A seller's inventory reference ID) 是指一个刊登的标识或是一个多属性刊登的主刊登的标识,比如说主刊登为一件提供多种尺寸和颜色可选的T恤衫。 你必须要同时指定 inventory_reference_id 和 inventory_reference_type

 

一个卖家的库存引用ID,更广泛认知为刊登的 SKU 或是 custom label

Bulk Update Ad Bids By Listing ID

POST /ad_campaign/{campaign_id}/bulk_update_ads_bid_by_listing_id

给指定活动中的eBay刊登IDs 更新(替换)广告价格。

 

eBay  刊登ID是在该刊登创建时由eBay生成。

Create Ad By Listing ID

POST /ad_campaign/{campaign_id}/ad

 

给指定刊登创建广告,并关联该广告到指定的活动

 

eBay  刊登ID是在该刊登创建时由eBay生成。

 

Create Ads By Inventory Reference

POST /ad_campaign/{campaign_id}/create_ads_by_inventory_reference

给指定的卖家库存引用ID创建广告,并关联该广告到指定的活动。

 

一个卖家的库存引用ID (A seller's inventory reference ID) 是指一个刊登的标识或是一个多属性刊登的主刊登的标识,比如说主刊登为一件提供多种尺寸和颜色可选的T恤衫。 你必须要同时指定 inventory_reference_id 和 inventory_reference_type

 

一个卖家的库存引用ID,更广泛认知为刊登的 SKU 或是 custom label

Delete Ad by ID

DELETE /ad_campaign/{campaign_id}/ad/{ad_id}

根据广告ID 和活动ID删除指定的广告

 

Delete Ads By Inventory Reference

POST /ad_campaign/{campaign_id}/delete_ads_by_inventory_reference

根据指定活动中卖家库存引用IDs删除广告

 

一个卖家的库存引用ID (A seller's inventory reference ID) 是指一个刊登的标识或是一个多属性刊登的主刊登的标识,比如说主刊登为一件提供多种尺寸和颜色可选的T恤衫。 你必须要同时指定 inventory_reference_id 和 inventory_reference_type

 

一个卖家的库存引用ID,更广泛认知为刊登的 SKU 或是 custom label

Get Ad by ID

GET /ad_campaign/{campaign_id}/ad/{ad_id}

根据广告ID 和活动ID检索指定的广告

 

Get Ads

GET /ad_campaign/{campaign_id}/ad

检索与指定的活动相关联的所有的广告

Get Ads By Inventory Reference

GET /ad_campaign/{campaign_id}/get_ads_by_inventory_reference

 

使用指定活动中卖家库存引用IDs来检索广告

 

一个卖家的库存引用ID (A seller's inventory reference ID) 是指一个刊登的标识或是一个多属性刊登的主刊登的标识,比如说主刊登为一件提供多种尺寸和颜色可选的T恤衫。 你必须要同时指定 inventory_reference_id 和 inventory_reference_type

 

一个卖家的库存引用ID,更广泛认知为刊登的 SKU 或是 custom label

Update Bid

POST /ad_campaign/{campaign_id}/ad/{ad_id}/update_bid

 

更新与指定活动相关联的指定广告的价格

活动 CAMPAIGN

 

Clone Campaign

POST /ad_campaign/{campaign_id}/clone

克隆一个基于规则(选择规则)的活动。 要克隆一个活动,该活动必须已经结束。

Create Campaign

POST /ad_campaign

创建活动。 你可以使用一组规则或传入一组卖家库存引用IDs eBay刊登IDs来创建一个活动。

Delete Campaign

DELETE /ad_campaign/{campaign_id}

 

 

 

根据活动ID删除活动。

End Campaign

POST /ad_campaign/{campaign_id}/end

 

终止一个在线或暂停的活动。 已结束的活动可以使用 Clone Campaign call 被克隆来生成一个新的活动。

Find Campaign By Ad Reference

GET /ad_campaign/find_campaign_by_ad_reference

 

使用 eBay刊登ID,或是卖家库存引用ID 和库存引用类型来检索活动。

Get All Campaigns

GET /ad_campaign

 

检索所有的活动。你可以使用过滤条件来减少结果集。

Get Campaign By Name

GET /ad_campaign/get_campaign_by_name

 

根据活动名称检索活动。

Get Campaign by ID

GET /ad_campaign/{campaign_id}

 

根据活动ID检索活动。

Pause Campaign

POST /ad_campaign/{campaign_id}/pause

暂停在线活动。

Resume Campaign

POST /ad_campaign/{campaign_id}/resume

 

恢复已暂停的活动。

Update Campaign IDentification

POST /ad_campaign/{campaign_id}/update_campaign_identification

 

更新活动名称,开始和结束日期。






成为eBay开发者

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