/pb/openapi/newad/portfolios{
"operation": {
"method": "POST",
"path": "/pb/openapi/newad/portfolios"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 10,
"text": ""
},
"responseExample": "{\n \"code\": 0,\n \"message\": \"操作成功\",\n \"error_details\": [],\n \"request_id\": \"f02f8062-36c0-45f4-9aa8-32d295389b36\",\n \"response_time\": \"2023-07-20 16:57:17\",\n \"total\": 1,\n \"next_token\": \"ODAwMDAwMDAwMDAwMDAyNDE3\"\n \"data\": [\n {\n \"portfolio_id\": 251907479208076,\n \"profile_id\": 121923590660074,\n \"name\": \"广告组合01\",\n \"budget\": \"{\\\"amount\\\": 3.0, \\\"policy\\\": \\\"dateRange\\\", \\\"endDate\\\": \\\"20230617\\\", \\\"startDate\\\": \\\"20230611\\\", \\\"currencyCode\\\": \\\"USD\\\"}\",\n \"in_budget\": 1,\n \"state\": \"enabled\",\n \"creation_date\": 1635327388175,\n \"last_updated_date\": 1686541822051,\n \"serving_status\": \"PORTFOLIO_ENDED\" \n }\n ]\n}"
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | sid | 店铺id | integer | — | 必填 | 店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】 |
| 2 | profile_id | VC广告店铺profile_id | integer | — | 必填 | VC广告店铺profile_id,对应查询广告账号列表接口对应字段【profile_id】,sid跟profile_id其中一个必填 |
| 3 | offset | 分页偏移量 | integer | — | 可选 | 分页偏移量,默认0 |
| 4 | length | 分页长度 | integer | — | 可选 | 分页长度,默认15 |
| 5 | 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 | f02f8062-36c0-45f4-9aa8-32d295389b36 | 必填 | 请求链路id |
| 5 | response_time | 响应时间 | string | 2023-07-20 16:57:17 | 必填 | 响应时间 |
| 6 | total | 总数 | integer | 109 | 必填 | 总数 |
| 7 | next_token | 分页游标 | string | "ODAwMDAwMDAwMDAwMDAyNDE3" | 必填 | 分页游标,填入下次请求中的next_token |
| 8 | data | 响应数据 | array<object> | — | 必填 | 响应数据 |
| 8.1 | portfolio_id | 广告组合id | number | 64803903424665 | 必填 | 广告组合id |
| 8.2 | profile_id | 亚马逊店铺数字id | number | 121923590660074 | 必填 | 亚马逊店铺数字id |
| 8.3 | name | 名称 | string | 广告组合01 | 必填 | 名称 |
| 8.4 | budget | 广告组合预算信息【json格式】 | string | {"amount": 5.0, "policy": "dateRange", "startDate": "20221120", "currencyCode": "USD"} | 必填 | 广告组合预算信息【json格式】: null 无预算上限 amout 预算金额 policy 预算策略【dateRange、monthlyRecurring】 startDate 应用预算开始日期 endDate 应用预算的结束日期 |
| 8.5 | in_budget | 当前广告组合是否在预算范围内 | number | 1 | 必填 | 当前广告组合是否在预算范围内: 0 超出预算 1 在范围内 |
| 8.6 | state | 状态 | string | enabled | 必填 | 状态 |
| 8.7 | creation_date | 创建时间 | number | 1639644442056 | 必填 | 创建时间 |
| 8.8 | last_updated_date | 最后更新时间 | number | 1668998717687 | 必填 | 最后更新时间 |
| 8.9 | serving_status | 服务状态 | string | PORTFOLIO_STATUS_ENABLED | 必填 | 服务状态 |
领星ERP的接口:广告组合(/pb/openapi/newad/portfolios),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。