Lingxing
切换旧版

创建 SP 广告组

POST/basicOpen/adReport/manage/postSpAdGroup

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/adReport/manage/postSpAdGroupHTTPSPOST1

请求参数

profileIdstring必填
必须属于当前授权企业的广告店铺唯一标识;使用数字字符串传递,避免长整数精度丢失。本文件记录用户提供的广告店铺标识方式。
adGroupsarray<object>必填
待创建的商品推广广告组列表,单次提交 1~1000 项。
最少1项
最多1000项
隐藏子属性
adProductstring必填
SPONSORED_PRODUCTS 表示商品推广广告。
adSettingsobject
广告组关联的商品属性配置。
隐藏子属性
productAttributeSetRefinementConfigurationIdstring
与该广告组关联的商品属性配置集标识;按官方正则要求使用小写十六进制的 8-4-4-4-12 分段格式。
bidobject必填
广告组中的广告和投放目标使用的默认最高竞价设置。
隐藏子属性
defaultBidnumber必填
广告组内广告和投放目标默认使用的最高竞价金额,作为商品推广竞价拍卖的最高出价。金额以广告店铺对应币种计价;当前外部接口要求金额非负。
campaignIdstring必填
广告组所属活动的唯一标识,须为当前授权广告店铺下的活动;使用数字字符串传递,当前外部接口要求正整数值。
namestring必填
用于识别和管理广告组的名称。
statestring必填
ENABLED=已启用
PAUSED=已暂停。是否实际投放还取决于所属活动状态、投放时间及其他投放条件。

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSpAdGroup?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "profileId": "1234567890123456",
    "adGroups": [
        {
            "adProduct": "SPONSORED_PRODUCTS",
            "bid": {
                "defaultBid": 1
            },
            "campaignId": "1234567890123456",
            "name": "示例广告",
            "state": "PAUSED"
        }
    ]
}'

返回结果

Json Object

codeinteger必填
平台业务状态码,0 表示成功
示例 0
messagestring必填
响应消息
示例 success
error_detailsarray<any>必填
参数校验等错误详情
示例 []
request_idstring必填
请求链路标识
示例 example-request-id
response_timestring必填
响应时间
示例 2026-10-19 12:00:00
dataobject必填
响应数据。
隐藏子属性
apiResultarray<object>必填
每项结果通过原始下标对应请求中的广告组;应检查每项结果码,批量或工具调用可能包含失败项。
隐藏子属性
adGroupIdstring必填
亚马逊创建成功后生成的广告组唯一标识;使用字符串保存,避免长整数精度丢失。
adProductstring必填
SPONSORED_PRODUCTS 表示商品推广广告。
bidobject必填
亚马逊返回的广告组默认最高竞价及其币种。
隐藏子属性
currencyCodestring必填
AED=阿联酋迪拉姆
AUD=澳大利亚元
BRL=巴西雷亚尔
CAD=加拿大元
CHF=瑞士法郎
CNY=人民币
DKK=丹麦克朗
EGP=埃及镑
EUR=欧元
GBP=英镑
INR=印度卢比
JPY=日元
MXN=墨西哥比索
MXP=墨西哥比索
NGN=尼日利亚奈拉
NOK=挪威克朗
NZD=新西兰元
PLN=波兰兹罗提
SAR=沙特里亚尔
SEK=瑞典克朗
SGD=新加坡元
TRY=土耳其里拉
USD=美元
ZAR=南非兰特。
defaultBidnumber必填
广告组内广告及投放目标使用的默认最高竞价,金额以返回的币种计价;本例表示 1 美元。
campaignIdstring必填
该广告组所属广告活动的唯一标识,使用字符串保存。
creationDateTimestring必填
亚马逊记录的广告组创建时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。
lastUpdatedDateTimestring必填
亚马逊记录的广告组最后更新时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。
marketplaceScopestring必填
SINGLE_MARKETPLACE 表示单站点广告组。
marketplacesarray<any>必填
广告组适用的亚马逊站点代码列表,范围应与所属活动相同或为其子集;商品推广当前仅包含一个站点,US 表示美国站。
namestring必填
创建成功的商品推广广告组名称。
statestring必填
ENABLED=已启用
PAUSED=已暂停
ARCHIVED=已永久归档且不可重新启用。是否实际投放还取决于所属活动及其他投放条件。
codestring必填
SUCCESS 表示当前广告组创建成功。
示例 SUCCESS
indexinteger必填
对应请求广告组数组中的原始下标,从 0 开始。
totalinteger必填
统一响应中的总数,本创建接口未设置分页总数,默认为0
示例 0

返回成功示例

{
    "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
}

附加说明

  • profileId 必须属于当前授权企业。标识使用字符串传递,避免长整数精度丢失。
  • 在 Query 中传入 access_token、app_key、timestamp、sign。修改请求体或鉴权参数后须重新计算签名,签名传输时只进行一次 URL 编码。
  • 先检查顶层 code,再逐项检查 data.apiResult[].code。顶层成功不代表每项均创建成功;index 是请求数组中从0开始的原始下标。
  • 示例仅说明数据结构,不是经过真实创建验证的返回。调用前替换标识及投放配置;字段说明中的源接口样本信息来自上游接口定义。
  • 返回字段表描述创建成功项,实际字段取决于创意类型及上游返回,失败项可能只包含结果码和下标。