Lingxing
切换旧版

SB广告活动

POST/pb/openapi/newad/hsaCampaigns

接口信息

API Path请求协议请求方式令牌桶容量
/pb/openapi/newad/hsaCampaignsHTTPSPOST10

请求头

标签必填说明类型示例
X-API-VERSION是【兼容旧版本】不加此头部标签,offset 为分页页码,从1开始;值为 2 时,表示 offset 为分页偏移量,从0开始[int]2

请求参数

sidinteger必填
店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】
profile_idinteger必填
VC广告店铺profile_id,对应查询广告账号列表接口对应字段【profile_id】,sid跟profile_id其中一个必填
statestring
状态:【不传默认为所有】
enabled
paused
archived
offsetinteger
分页偏移量,默认0
lengthinteger
分页长度,默认15
next_tokenstring
分页游标,上次分页结果中的next_token
(第一次分页无需填写,当next_token 和 offset同时存在时以next_token为主

返回结果

Json Object

codeinteger必填
示例 0
messagestring必填
示例 操作成功
error_detailsarray<any>必填
request_idstring必填
示例 nd8492d4-7a15-11ed-b162-0242ac1c0004
response_timestring必填
示例 2022-11-03 14:09:15
totalinteger必填
示例 1
next_tokenstring必填
示例 "ODAwMDAwMDAwMDAwMDAyNDE3"
dataarray<object>必填
隐藏子属性
campaign_idnumber必填
示例 112910451299387
lastOverBudgetAtstring必填
示例 2026-10-08 12:34:56
profile_idnumber必填
示例 121923590660074
namestring必填
示例 L038-Video-Test-Produkt-Blue
budgetnumber必填
示例 10
budget_typestring必填
示例 daily
start_datestring必填
示例 2021-06-11 00:00:00
statestring必填
示例 enabled
serving_statusstring必填
示例 running
bid_optimizationnumber必填
creativestring
示例 {"type": "video", "asins": ["B07Q8KTP65"], "videoMediaIds": ["amzn1.adex.media1.d9cd46ae-1a24-4ffe-b29f-74d7e131e16d"]}
landing_pagestring必填
示例 {"url": "https://www.amazon.de/dp/B07Q8KTP65", "pageType": "detailPage"}
bid_multipliernumber必填
end_datestring必填
portfolio_idnumber必填
示例 136707579327356
creative_typestring必填
示例 COLLECTION
tagsarray<object>必填
隐藏子属性
parentstring必填
示例 t1
childstring必填
示例 tttsadw

附加说明

creative 广告创意结构 json 内容字段说明如下:

  1. type:创意类型,值为video;
  2. asin:asin;
  3. videoMediaIds:视频文件资源id;

landing_page 广告着陆页 json 内容字段说明如下:

  1. url:url;
  2. pageType:着陆页类型;