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