/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}"
}| 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 | offset | 分页偏移量 | integer | — | Optional | 分页偏移量,默认0 |
| 4 | length | 分页长度 | integer | — | Optional | 分页长度,默认15 |
| 5 | 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 | f02f8062-36c0-45f4-9aa8-32d295389b36 | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2023-07-20 16:57:17 | Required | 响应时间 |
| 6 | total | 总数 | integer | 109 | Required | 总数 |
| 7 | next_token | 分页游标 | string | "ODAwMDAwMDAwMDAwMDAyNDE3" | Required | 分页游标,填入下次请求中的next_token |
| 8 | data | 响应数据 | array<object> | — | Required | 响应数据 |
| 8.1 | portfolio_id | 广告组合id | number | 64803903424665 | Required | 广告组合id |
| 8.2 | profile_id | 亚马逊店铺数字id | number | 121923590660074 | Required | 亚马逊店铺数字id |
| 8.3 | name | 名称 | string | 广告组合01 | Required | 名称 |
| 8.4 | budget | 广告组合预算信息【json格式】 | string | {"amount": 5.0, "policy": "dateRange", "startDate": "20221120", "currencyCode": "USD"} | Required | 广告组合预算信息【json格式】: null 无预算上限 amout 预算金额 policy 预算策略【dateRange、monthlyRecurring】 startDate 应用预算开始日期 endDate 应用预算的结束日期 |
| 8.5 | in_budget | 当前广告组合是否在预算范围内 | number | 1 | Required | 当前广告组合是否在预算范围内: 0 超出预算 1 在范围内 |
| 8.6 | state | 状态 | string | enabled | Required | 状态 |
| 8.7 | creation_date | 创建时间 | number | 1639644442056 | Required | 创建时间 |
| 8.8 | last_updated_date | 最后更新时间 | number | 1668998717687 | Required | 最后更新时间 |
| 8.9 | serving_status | 服务状态 | string | PORTFOLIO_STATUS_ENABLED | Required | 服务状态 |
The 广告组合 API (/pb/openapi/newad/portfolios) 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.