/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
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | profileId | 当前授权企业下的广告店铺唯一标识 | string | — | Required | 当前授权企业下的广告店铺唯一标识;用数字字符串传递,避免长整数精度丢失。本文件记录用户提供的广告店铺标识方式。 |
| 2 | adGroups | 待创建的品牌推广广告组 | array<object> | — | Required | 待创建的品牌推广广告组,单次提交 1~10 项。 最少1项 最多10项 |
| 2.1 | adProduct | adProduct | string | — | Required | SPONSORED_BRANDS 表示品牌推广广告。 |
| 2.2 | campaignId | 广告组所属活动的唯一标识 | string | — | Required | 广告组所属活动的唯一标识,须为当前授权店铺下的活动;使用数字字符串传递,当前服务要求正整数值。 |
| 2.3 | name | 用于识别和管理广告组的名称 | string | — | Required | 用于识别和管理广告组的名称。 |
| 2.4 | state | ENABLED=已启用 | string | — | Required | ENABLED=已启用 PAUSED=已暂停。实际投放还取决于所属活动状态、投放时间等条件。 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 平台业务状态码 | integer | 0 | Required | 平台业务状态码,0 表示成功 |
| 2 | message | 响应消息 | string | success | Required | 响应消息 |
| 3 | error_details | 参数校验等错误详情 | array<any> | [] | Required | 参数校验等错误详情 |
| 4 | request_id | 请求链路标识 | string | example-request-id | Required | 请求链路标识 |
| 5 | response_time | 响应时间 | string | 2026-10-19 12:00:00 | Required | 响应时间 |
| 6 | data | 响应数据 | object | — | Required | 响应数据。 |
| 6.1 | apiResult | 每项结果通过原始下标对应请求中的广告组 | array<object> | — | Required | 每项结果通过原始下标对应请求中的广告组;应检查每项结果码,批量或工具调用可能包含失败项。 |
| 6.1.1 | adGroupId | 亚马逊创建成功后生成的广告组唯一标识 | string | — | Required | 亚马逊创建成功后生成的广告组唯一标识,以字符串保存,避免长整数精度丢失。 |
| 6.1.2 | adProduct | adProduct | string | — | Required | SPONSORED_BRANDS 表示品牌推广广告。 |
| 6.1.3 | campaignId | 广告组所属活动的唯一标识 | string | — | Required | 广告组所属活动的唯一标识,须为当前授权店铺下的活动;使用数字字符串传递,当前服务要求正整数值。 |
| 6.1.4 | creationDateTime | 亚马逊记录的广告组创建时间 | string | — | Required | 亚马逊记录的广告组创建时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。 |
| 6.1.5 | lastUpdatedDateTime | 亚马逊记录的广告组最后更新时间 | string | — | Required | 亚马逊记录的广告组最后更新时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。 |
| 6.1.6 | marketplaceScope | marketplaceScope | string | — | Required | SINGLE_MARKETPLACE 表示单站点广告组。 |
| 6.1.7 | marketplaces | 广告组适用的站点代码列表 | array<any> | — | Required | 广告组适用的站点代码列表,范围应与所属活动相同或为其子集;当前品牌推广仅包含一个站点,US 表示美国站。 |
| 6.1.8 | name | 用于识别和管理广告组的名称 | string | — | Required | 用于识别和管理广告组的名称。 |
| 6.1.9 | state | ENABLED=已启用 | string | — | Required | ENABLED=已启用 PAUSED=已暂停 ARCHIVED=已永久归档且不可重新启用。 |
| 6.1.10 | bid | 本次真实响应额外回显的竞价对象 | object | — | Required | 本次真实响应额外回显的竞价对象。当前官方品牌推广广告组创建及返回模型均未定义此对象;这里只描述样本结构,不据此推断可通过本创建接口设置广告组默认竞价,也不推断该值的来源或实际投放作用。 |
| 6.1.10.1 | currencyCode | AED=阿联酋迪拉姆 | string | — | Required | 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 | — | Required | 本次响应原样返回的竞价值为 49,结合币种字段表示 49 美元。该字段依据真实响应补充,未验证数值来源及实际投放作用;不作为品牌推广广告组创建入参。 |
| 6.1.11 | code | SUCCESS 表示当前广告组创建成功 | string | SUCCESS | Required | SUCCESS 表示当前广告组创建成功。 |
| 6.1.12 | index | 对应请求广告组数组中的原始下标 | integer | — | Required | 对应请求广告组数组中的原始下标,从 0 开始。 |
| 7 | total | 统一响应中的总数 | integer | 0 | Required | 统一响应中的总数,本创建接口未设置分页总数,默认为0 |
The 创建 SB 广告组 API (/basicOpen/adReport/manage/postSbAdGroup) 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.