发布时间: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。 |
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。 |
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生成。 |
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_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_campaign/{campaign_id}/ad/{ad_id} |
根据广告ID 和活动ID检索指定的广告
|
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。 |
POST /ad_campaign/{campaign_id}/ad/{ad_id}/update_bid
|
更新与指定活动相关联的指定广告的价格 |
活动 CAMPAIGN |
|
POST /ad_campaign/{campaign_id}/clone |
克隆一个基于规则(选择规则)的活动。 要克隆一个活动,该活动必须已经结束。 |
POST /ad_campaign |
创建活动。 你可以使用一组规则或传入一组卖家库存引用IDs 或eBay刊登IDs来创建一个活动。 |
DELETE /ad_campaign/{campaign_id}
|
根据活动ID删除活动。 |
POST /ad_campaign/{campaign_id}/end
|
终止一个在线或暂停的活动。 已结束的活动可以使用 Clone Campaign call 被克隆来生成一个新的活动。 |
GET /ad_campaign/find_campaign_by_ad_reference
|
使用 eBay刊登ID,或是卖家库存引用ID 和库存引用类型来检索活动。 |
GET /ad_campaign
|
检索所有的活动。你可以使用过滤条件来减少结果集。 |
GET /ad_campaign/get_campaign_by_name
|
根据活动名称检索活动。 |
GET /ad_campaign/{campaign_id}
|
根据活动ID检索活动。 |
POST /ad_campaign/{campaign_id}/pause |
暂停在线活动。 |
POST /ad_campaign/{campaign_id}/resume
|
恢复已暂停的活动。 |
Update Campaign IDentification POST /ad_campaign/{campaign_id}/update_campaign_identification
|
更新活动名称,开始和结束日期。 |