/basicOpen/adReport/manage/postSpAdGroup{
"operation": {
"method": "POST",
"path": "/basicOpen/adReport/manage/postSpAdGroup"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSpAdGroup?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_PRODUCTS\",\n \"bid\": {\n \"defaultBid\": 1\n },\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_PRODUCTS",
"bid": {
"currencyCode": "USD",
"defaultBid": 1
},
"campaignId": "1234567890123456",
"creationDateTime": "2026-10-20T00:00:00Z",
"lastUpdatedDateTime": "2026-10-20T00:00:00Z",
"marketplaceScope": "SINGLE_MARKETPLACE",
"marketplaces": [
"US"
],
"name": "示例广告",
"state": "PAUSED",
"code": "SUCCESS",
"index": 0
}
]
},
"total": 0
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | profileId | 必须属于当前授权企业的广告店铺唯一标识 | string | — | Required | 必须属于当前授权企业的广告店铺唯一标识;使用数字字符串传递,避免长整数精度丢失。本文件记录用户提供的广告店铺标识方式。 |
| 2 | adGroups | 待创建的商品推广广告组列表 | array<object> | — | Required | 待创建的商品推广广告组列表,单次提交 1~1000 项。 最少1项 最多1000项 |
| 2.1 | adProduct | adProduct | string | — | Required | SPONSORED_PRODUCTS 表示商品推广广告。 |
| 2.2 | adSettings | 广告组关联的商品属性配置 | object | — | Optional | 广告组关联的商品属性配置。 |
| 2.2.1 | productAttributeSetRefinementConfigurationId | 与该广告组关联的商品属性配置集标识 | string | — | Optional | 与该广告组关联的商品属性配置集标识;按官方正则要求使用小写十六进制的 8-4-4-4-12 分段格式。 |
| 2.3 | bid | 广告组中的广告和投放目标使用的默认最高竞价设置 | object | — | Required | 广告组中的广告和投放目标使用的默认最高竞价设置。 |
| 2.3.1 | defaultBid | 广告组内广告和投放目标默认使用的最高竞价金额 | number | — | Required | 广告组内广告和投放目标默认使用的最高竞价金额,作为商品推广竞价拍卖的最高出价。金额以广告店铺对应币种计价;当前外部接口要求金额非负。 |
| 2.4 | campaignId | 广告组所属活动的唯一标识 | string | — | Required | 广告组所属活动的唯一标识,须为当前授权广告店铺下的活动;使用数字字符串传递,当前外部接口要求正整数值。 |
| 2.5 | name | 用于识别和管理广告组的名称 | string | — | Required | 用于识别和管理广告组的名称。 |
| 2.6 | 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_PRODUCTS 表示商品推广广告。 |
| 6.1.3 | bid | 亚马逊返回的广告组默认最高竞价及其币种 | object | — | Required | 亚马逊返回的广告组默认最高竞价及其币种。 |
| 6.1.3.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.3.2 | defaultBid | 广告组内广告及投放目标使用的默认最高竞价 | number | — | Required | 广告组内广告及投放目标使用的默认最高竞价,金额以返回的币种计价;本例表示 1 美元。 |
| 6.1.4 | campaignId | 该广告组所属广告活动的唯一标识 | string | — | Required | 该广告组所属广告活动的唯一标识,使用字符串保存。 |
| 6.1.5 | creationDateTime | 亚马逊记录的广告组创建时间 | string | — | Required | 亚马逊记录的广告组创建时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。 |
| 6.1.6 | lastUpdatedDateTime | 亚马逊记录的广告组最后更新时间 | string | — | Required | 亚马逊记录的广告组最后更新时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。 |
| 6.1.7 | marketplaceScope | marketplaceScope | string | — | Required | SINGLE_MARKETPLACE 表示单站点广告组。 |
| 6.1.8 | marketplaces | 广告组适用的亚马逊站点代码列表 | array<any> | — | Required | 广告组适用的亚马逊站点代码列表,范围应与所属活动相同或为其子集;商品推广当前仅包含一个站点,US 表示美国站。 |
| 6.1.9 | name | 创建成功的商品推广广告组名称 | string | — | Required | 创建成功的商品推广广告组名称。 |
| 6.1.10 | state | ENABLED=已启用 | string | — | Required | ENABLED=已启用 PAUSED=已暂停 ARCHIVED=已永久归档且不可重新启用。是否实际投放还取决于所属活动及其他投放条件。 |
| 6.1.11 | code | SUCCESS 表示当前广告组创建成功 | string | SUCCESS | Required | SUCCESS 表示当前广告组创建成功。 |
| 6.1.12 | index | 对应请求广告组数组中的原始下标 | integer | — | Required | 对应请求广告组数组中的原始下标,从 0 开始。 |
| 7 | total | 统一响应中的总数 | integer | 0 | Required | 统一响应中的总数,本创建接口未设置分页总数,默认为0 |
The 创建 SP 广告组 API (/basicOpen/adReport/manage/postSpAdGroup) 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.