轻易云
注册体验

领星ERP广告组合接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
广告 / 基础数据 · POST · 请求参数 5 个(必填 2) · 响应参数 17 个 · 限流令牌桶容量 10
更新日期
2026-11-21

广告组合

POST/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}"
}

接口请求参数

序号字段名称类型默认值必填描述
1sid店铺idinteger—必填店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】
2profile_idVC广告店铺profile_idinteger—必填VC广告店铺profile_id,对应查询广告账号列表接口对应字段【profile_id】,sid跟profile_id其中一个必填
3offset分页偏移量integer—可选分页偏移量,默认0
4length分页长度integer—可选分页长度,默认15
5next_token分页游标string—可选分页游标,上次分页结果中的next_token (第一次分页无需填写,当next_token 和 offset同时存在时以next_token为主

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0 成功
2message消息string操作成功必填消息
3error_details错误信息array<any>—必填错误信息
4request_id请求链路idstringf02f8062-36c0-45f4-9aa8-32d295389b36必填请求链路id
5response_time响应时间string2023-07-20 16:57:17必填响应时间
6total总数integer109必填总数
7next_token分页游标string"ODAwMDAwMDAwMDAwMDAyNDE3"必填分页游标,填入下次请求中的next_token
8data响应数据array<object>—必填响应数据
8.1portfolio_id广告组合idnumber64803903424665必填广告组合id
8.2profile_id亚马逊店铺数字idnumber121923590660074必填亚马逊店铺数字id
8.3name名称string广告组合01必填名称
8.4budget广告组合预算信息【json格式】string{"amount": 5.0, "policy": "dateRange", "startDate": "20221120", "currencyCode": "USD"}必填广告组合预算信息【json格式】: null 无预算上限 amout 预算金额 policy 预算策略【dateRange、monthlyRecurring】 startDate 应用预算开始日期 endDate 应用预算的结束日期
8.5in_budget当前广告组合是否在预算范围内number1必填当前广告组合是否在预算范围内: 0 超出预算 1 在范围内
8.6state状态stringenabled必填状态
8.7creation_date创建时间number1639644442056必填创建时间
8.8last_updated_date最后更新时间number1668998717687必填最后更新时间
8.9serving_status服务状态stringPORTFOLIO_STATUS_ENABLED必填服务状态

领星ERP的接口:广告组合(/pb/openapi/newad/portfolios),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。