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