Lingxing
切换旧版

SP广告商品

POST/pb/openapi/newad/spProductAds

接口信息

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

请求头

标签必填说明类型示例
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 成功
示例 0
messagestring必填
提示消息
示例 操作成功
error_detailsarray<any>必填
错误信息
request_idstring必填
请求链路id
示例 nd8492d4-7a15-11ed-b162-0242ac1c0004
response_timestring必填
响应时间
示例 2022-11-03 14:09:15
totalinteger必填
总数
示例 1
next_tokenstring必填
分页游标,填入下次请求中的next_token
示例 "ODAwMDAwMDAwMDAwMDAyNDE3"
dataarray<object>必填
响应数据
隐藏子属性
campaign_idnumber必填
广告活动id
示例 57765830151100
ad_group_idnumber必填
广告组id
示例 800000000000080800
profile_idnumber必填
亚马逊店铺数字id
示例 121923590660074
ad_idnumber必填
商品广告id
示例 800000000000080800
statestring必填
状态
示例 enabled
skustring必填
MSKU
示例 PEE-11
asinstring必填
ASIN
示例 B08D87V2BV
creation_datenumber必填
创建日期
示例 1628567183000
last_updated_datenumber必填
最近更新时间
示例 1655708791290
serving_statusstring必填
服务状态
示例 CAMPAIGN_PAUSED
video_detailsarray<object>必填
当前商品广告配置的视频列表;无视频配置时返回空数组
隐藏子属性
asset_idstring必填
视频素材id
示例 amzn1.assetlibrary.asset1.example
asset_versionstring必填
广告指定的视频素材版本
示例 version_v1
headlinestring必填
视频标题
示例 商品演示
descriptionstring必填
视频描述
示例 使用说明
namestring必填
本地视频素材名称;未匹配到素材时返回null
示例 demo.mp4
urlstring必填
本地视频素材地址,对应storage_location_urls.defaultUrl;未匹配到素材时返回null
示例 https://example.com/demo.mp4