/basicOpen/adReport/manage/postSbAdGroup{
"operation": {
"method": "POST",
"path": "/basicOpen/adReport/manage/postSbAdGroup"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSbAdGroup?access_token=value×tamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n \"profileId\": \"1234567890123456\",\n \"adGroups\": [\n {\n \"adProduct\": \"SPONSORED_BRANDS\",\n \"campaignId\": \"1234567890123456\",\n \"name\": \"示例广告\",\n \"state\": \"PAUSED\"\n }\n ]\n}'",
"responseExample": {
"code": 0,
"message": "success",
"error_details": [],
"request_id": "example-request-id",
"response_time": "2026-10-19 12:00:00",
"data": {
"apiResult": [
{
"adGroupId": "1234567890123456",
"adProduct": "SPONSORED_BRANDS",
"campaignId": "1234567890123456",
"creationDateTime": "2026-10-20T00:00:00Z",
"lastUpdatedDateTime": "2026-10-20T00:00:00Z",
"marketplaceScope": "SINGLE_MARKETPLACE",
"marketplaces": [
"US"
],
"name": "示例广告",
"state": "PAUSED",
"bid": {
"currencyCode": "USD",
"defaultBid": 1
},
"code": "SUCCESS",
"index": 0
}
]
},
"total": 0
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | profileId | 当前授权企业下的广告店铺唯一标识 | string | — | 必填 | 当前授权企业下的广告店铺唯一标识;用数字字符串传递,避免长整数精度丢失。本文件记录用户提供的广告店铺标识方式。 |
| 2 | adGroups | 待创建的品牌推广广告组 | array<object> | — | 必填 | 待创建的品牌推广广告组,单次提交 1~10 项。 最少1项 最多10项 |
| 2.1 | adProduct | adProduct | string | — | 必填 | SPONSORED_BRANDS 表示品牌推广广告。 |
| 2.2 | campaignId | 广告组所属活动的唯一标识 | string | — | 必填 | 广告组所属活动的唯一标识,须为当前授权店铺下的活动;使用数字字符串传递,当前服务要求正整数值。 |
| 2.3 | name | 用于识别和管理广告组的名称 | string | — | 必填 | 用于识别和管理广告组的名称。 |
| 2.4 | state | ENABLED=已启用 | string | — | 必填 | ENABLED=已启用 PAUSED=已暂停。实际投放还取决于所属活动状态、投放时间等条件。 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 平台业务状态码 | integer | 0 | 必填 | 平台业务状态码,0 表示成功 |
| 2 | message | 响应消息 | string | success | 必填 | 响应消息 |
| 3 | error_details | 参数校验等错误详情 | array<any> | [] | 必填 | 参数校验等错误详情 |
| 4 | request_id | 请求链路标识 | string | example-request-id | 必填 | 请求链路标识 |
| 5 | response_time | 响应时间 | string | 2026-10-19 12:00:00 | 必填 | 响应时间 |
| 6 | data | 响应数据 | object | — | 必填 | 响应数据。 |
| 6.1 | apiResult | 每项结果通过原始下标对应请求中的广告组 | array<object> | — | 必填 | 每项结果通过原始下标对应请求中的广告组;应检查每项结果码,批量或工具调用可能包含失败项。 |
| 6.1.1 | adGroupId | 亚马逊创建成功后生成的广告组唯一标识 | string | — | 必填 | 亚马逊创建成功后生成的广告组唯一标识,以字符串保存,避免长整数精度丢失。 |
| 6.1.2 | adProduct | adProduct | string | — | 必填 | SPONSORED_BRANDS 表示品牌推广广告。 |
| 6.1.3 | campaignId | 广告组所属活动的唯一标识 | string | — | 必填 | 广告组所属活动的唯一标识,须为当前授权店铺下的活动;使用数字字符串传递,当前服务要求正整数值。 |
| 6.1.4 | creationDateTime | 亚马逊记录的广告组创建时间 | string | — | 必填 | 亚马逊记录的广告组创建时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。 |
| 6.1.5 | lastUpdatedDateTime | 亚马逊记录的广告组最后更新时间 | string | — | 必填 | 亚马逊记录的广告组最后更新时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。 |
| 6.1.6 | marketplaceScope | marketplaceScope | string | — | 必填 | SINGLE_MARKETPLACE 表示单站点广告组。 |
| 6.1.7 | marketplaces | 广告组适用的站点代码列表 | array<any> | — | 必填 | 广告组适用的站点代码列表,范围应与所属活动相同或为其子集;当前品牌推广仅包含一个站点,US 表示美国站。 |
| 6.1.8 | name | 用于识别和管理广告组的名称 | string | — | 必填 | 用于识别和管理广告组的名称。 |
| 6.1.9 | state | ENABLED=已启用 | string | — | 必填 | ENABLED=已启用 PAUSED=已暂停 ARCHIVED=已永久归档且不可重新启用。 |
| 6.1.10 | bid | 本次真实响应额外回显的竞价对象 | object | — | 必填 | 本次真实响应额外回显的竞价对象。当前官方品牌推广广告组创建及返回模型均未定义此对象;这里只描述样本结构,不据此推断可通过本创建接口设置广告组默认竞价,也不推断该值的来源或实际投放作用。 |
| 6.1.10.1 | currencyCode | AED=阿联酋迪拉姆 | string | — | 必填 | AED=阿联酋迪拉姆 AUD=澳大利亚元 BRL=巴西雷亚尔 CAD=加拿大元 CHF=瑞士法郎 CNY=人民币 DKK=丹麦克朗 EGP=埃及镑 EUR=欧元 GBP=英镑 INR=印度卢比 JPY=日元 MXN=墨西哥比索 MXP=墨西哥比索 NGN=尼日利亚奈拉 NOK=挪威克朗 NZD=新西兰元 PLN=波兰兹罗提 SAR=沙特里亚尔 SEK=瑞典克朗 SGD=新加坡元 TRY=土耳其里拉 USD=美元 ZAR=南非兰特。 |
| 6.1.10.2 | defaultBid | 本次响应原样返回的竞价值为 49 | number | — | 必填 | 本次响应原样返回的竞价值为 49,结合币种字段表示 49 美元。该字段依据真实响应补充,未验证数值来源及实际投放作用;不作为品牌推广广告组创建入参。 |
| 6.1.11 | code | SUCCESS 表示当前广告组创建成功 | string | SUCCESS | 必填 | SUCCESS 表示当前广告组创建成功。 |
| 6.1.12 | index | 对应请求广告组数组中的原始下标 | integer | — | 必填 | 对应请求广告组数组中的原始下标,从 0 开始。 |
| 7 | total | 统一响应中的总数 | integer | 0 | 必填 | 统一响应中的总数,本创建接口未设置分页总数,默认为0 |
领星ERP的接口:创建 SB 广告组(/basicOpen/adReport/manage/postSbAdGroup),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。