/pb/openapi/newad/spProductAds{
"operation": {
"method": "POST",
"path": "/pb/openapi/newad/spProductAds"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 10,
"text": ""
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | sid | 店铺id | integer | — | 必填 | 店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】 |
| 2 | profile_id | VC广告店铺profile_id | integer | — | 必填 | VC广告店铺profile_id,对应查询广告账号列表接口对应字段【profile_id】,sid跟profile_id其中一个必填 |
| 3 | state | 状态 | string | — | 可选 | 状态:【不传默认为所有】 enabled paused archived |
| 4 | offset | 分页偏移量 | integer | — | 可选 | 分页偏移量,默认0 |
| 5 | length | 分页长度 | integer | — | 可选 | 分页长度,默认15 |
| 6 | next_token | 分页游标 | string | — | 可选 | 分页游标,上次分页结果中的next_token (第一次分页无需填写,当next_token 和 offset同时存在时以next_token为主 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 必填 | 状态码,0 成功 |
| 2 | message | 提示消息 | string | 操作成功 | 必填 | 提示消息 |
| 3 | error_details | 错误信息 | array<any> | — | 必填 | 错误信息 |
| 4 | request_id | 请求链路id | string | nd8492d4-7a15-11ed-b162-0242ac1c0004 | 必填 | 请求链路id |
| 5 | response_time | 响应时间 | string | 2022-11-03 14:09:15 | 必填 | 响应时间 |
| 6 | total | 总数 | integer | 1 | 必填 | 总数 |
| 7 | next_token | 分页游标 | string | "ODAwMDAwMDAwMDAwMDAyNDE3" | 必填 | 分页游标,填入下次请求中的next_token |
| 8 | data | 响应数据 | array<object> | — | 必填 | 响应数据 |
| 8.1 | campaign_id | 广告活动id | number | 57765830151100 | 必填 | 广告活动id |
| 8.2 | ad_group_id | 广告组id | number | 800000000000080800 | 必填 | 广告组id |
| 8.3 | profile_id | 亚马逊店铺数字id | number | 121923590660074 | 必填 | 亚马逊店铺数字id |
| 8.4 | ad_id | 商品广告id | number | 800000000000080800 | 必填 | 商品广告id |
| 8.5 | state | 状态 | string | enabled | 必填 | 状态 |
| 8.6 | sku | sku | string | PEE-11 | 必填 | MSKU |
| 8.7 | asin | asin | string | B08D87V2BV | 必填 | ASIN |
| 8.8 | creation_date | 创建日期 | number | 1628567183000 | 必填 | 创建日期 |
| 8.9 | last_updated_date | 最近更新时间 | number | 1655708791290 | 必填 | 最近更新时间 |
| 8.10 | serving_status | 服务状态 | string | CAMPAIGN_PAUSED | 必填 | 服务状态 |
| 8.11 | video_details | 当前商品广告配置的视频列表 | array<object> | — | 必填 | 当前商品广告配置的视频列表;无视频配置时返回空数组 |
| 8.11.1 | asset_id | 视频素材id | string | amzn1.assetlibrary.asset1.example | 必填 | 视频素材id |
| 8.11.2 | asset_version | 广告指定的视频素材版本 | string | version_v1 | 必填 | 广告指定的视频素材版本 |
| 8.11.3 | headline | 视频标题 | string | 商品演示 | 必填 | 视频标题 |
| 8.11.4 | description | 视频描述 | string | 使用说明 | 必填 | 视频描述 |
| 8.11.5 | name | 本地视频素材名称 | string | demo.mp4 | 必填 | 本地视频素材名称;未匹配到素材时返回null |
| 8.11.6 | url | 本地视频素材地址 | string | https://example.com/demo.mp4 | 必填 | 本地视频素材地址,对应storage_location_urls.defaultUrl;未匹配到素材时返回null |
领星ERP的接口:SP广告商品(/pb/openapi/newad/spProductAds),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。