广告组合

POST/pb/openapi/newad/portfolios

接口信息

API Path	请求协议	请求方式	令牌桶容量
`/pb/openapi/newad/portfolios`	HTTPS	POST	10

请求参数

sidinteger必填

店铺id ，对应查询亚马逊店铺列表接口对应字段【sid】

profile_idinteger必填

VC广告店铺profile_id，对应查询广告账号列表接口对应字段【profile_id】，sid跟profile_id其中一个必填

offsetinteger

分页偏移量，默认0

lengthinteger

分页长度，默认15

next_tokenstring

分页游标，上次分页结果中的next_token
(第一次分页无需填写，当next_token 和 offset同时存在时以next_token为主

返回结果

Json Object

codeinteger必填

状态码，0 成功

示例 0

messagestring必填

消息

示例操作成功

error_detailsarray<any>必填

错误信息

request_idstring必填

请求链路id

示例 f02f8062-36c0-45f4-9aa8-32d295389b36

response_timestring必填

响应时间

示例 2023-07-20 16:57:17

totalinteger必填

总数

示例 109

next_tokenstring必填

分页游标，填入下次请求中的next_token

示例 "ODAwMDAwMDAwMDAwMDAyNDE3"

dataarray<object>必填

响应数据

隐藏子属性

portfolio_idnumber必填

广告组合id

示例 64803903424665

profile_idnumber必填

亚马逊店铺数字id

示例 121923590660074

namestring必填

名称

示例广告组合01

budgetstring必填

广告组合预算信息【json格式】：
null 无预算上限
amout 预算金额
policy 预算策略【dateRange、monthlyRecurring】
startDate 应用预算开始日期
endDate 应用预算的结束日期

示例 {"amount": 5.0, "policy": "dateRange", "startDate": "20221120", "currencyCode": "USD"}

in_budgetnumber必填

当前广告组合是否在预算范围内：
0 超出预算
1 在范围内

示例 1

statestring必填

状态

示例 enabled

creation_datenumber必填

创建时间

示例 1639644442056

last_updated_datenumber必填

最后更新时间

示例 1668998717687

serving_statusstring必填

服务状态

示例 PORTFOLIO_STATUS_ENABLED

返回成功示例

{
    "code": 0,
    "message": "操作成功",
    "error_details": [],
    "request_id": "f02f8062-36c0-45f4-9aa8-32d295389b36",
    "response_time": "2023-07-20 16:57:17",
    "total": 1,
    "next_token": "ODAwMDAwMDAwMDAwMDAyNDE3"
    "data": [
        {
            "portfolio_id": 251907479208076,
            "profile_id": 121923590660074,
            "name": "广告组合01",
            "budget": "{\"amount\": 3.0, \"policy\": \"dateRange\", \"endDate\": \"20230617\", \"startDate\": \"20230611\", \"currencyCode\": \"USD\"}",
            "in_budget": 1,
            "state": "enabled",
            "creation_date": 1635327388175,
            "last_updated_date": 1686541822051,
            "serving_status": "PORTFOLIO_ENDED"            
        }
    ]
}