Lingxing
切换旧版

创建 SB 广告组

POST/basicOpen/adReport/manage/postSbAdGroup

接口信息

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

请求参数

profileIdstring必填
当前授权企业下的广告店铺唯一标识;用数字字符串传递,避免长整数精度丢失。本文件记录用户提供的广告店铺标识方式。
adGroupsarray<object>必填
待创建的品牌推广广告组,单次提交 1~10 项。
最少1项
最多10项
隐藏子属性
adProductstring必填
SPONSORED_BRANDS 表示品牌推广广告。
campaignIdstring必填
广告组所属活动的唯一标识,须为当前授权店铺下的活动;使用数字字符串传递,当前服务要求正整数值。
namestring必填
用于识别和管理广告组的名称。
statestring必填
ENABLED=已启用
PAUSED=已暂停。实际投放还取决于所属活动状态、投放时间等条件。

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSbAdGroup?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "profileId": "1234567890123456",
    "adGroups": [
        {
            "adProduct": "SPONSORED_BRANDS",
            "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_BRANDS 表示品牌推广广告。
campaignIdstring必填
广告组所属活动的唯一标识,须为当前授权店铺下的活动;使用数字字符串传递,当前服务要求正整数值。
creationDateTimestring必填
亚马逊记录的广告组创建时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。
lastUpdatedDateTimestring必填
亚马逊记录的广告组最后更新时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。
marketplaceScopestring必填
SINGLE_MARKETPLACE 表示单站点广告组。
marketplacesarray<any>必填
广告组适用的站点代码列表,范围应与所属活动相同或为其子集;当前品牌推广仅包含一个站点,US 表示美国站。
namestring必填
用于识别和管理广告组的名称。
statestring必填
ENABLED=已启用
PAUSED=已暂停
ARCHIVED=已永久归档且不可重新启用。
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必填
本次响应原样返回的竞价值为 49,结合币种字段表示 49 美元。该字段依据真实响应补充,未验证数值来源及实际投放作用;不作为品牌推广广告组创建入参。
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_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
}

附加说明

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