创建 SB 广告组
POST
/basicOpen/adReport/manage/postSbAdGroup接口信息
| API Path | 请求协议 | 请求方式 | 令牌桶容量 |
|---|---|---|---|
/basicOpen/adReport/manage/postSbAdGroup | HTTPS | POST | 1 |
请求参数
profileIdstring必填adGroupsarray<object>必填隐藏子属性
adProductstring必填campaignIdstring必填namestring必填statestring必填请求cURL示例
curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSbAdGroup?access_token=value×tamp=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必填messagestring必填error_detailsarray<any>必填request_idstring必填response_timestring必填dataobject必填隐藏子属性
apiResultarray<object>必填隐藏子属性
adGroupIdstring必填adProductstring必填campaignIdstring必填creationDateTimestring必填lastUpdatedDateTimestring必填marketplaceScopestring必填marketplacesarray<any>必填namestring必填statestring必填bidobject必填隐藏子属性
currencyCodestring必填defaultBidnumber必填codestring必填indexinteger必填totalinteger必填返回成功示例
{
"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 广告组时可以传入默认竞价。