创建 SB 广告
POST
/basicOpen/adReport/manage/postSbAds接口信息
| API Path | 请求协议 | 请求方式 | 令牌桶容量 |
|---|---|---|---|
/basicOpen/adReport/manage/postSbAds | HTTPS | POST | 1 |
请求参数
profileIdstring必填adsarray<object>必填隐藏子属性
adGroupIdstring必填adProductstring必填adTypestring必填creativeobject必填隐藏子属性
componentCreativeobject必填隐藏子属性
autoCollectionSettingsobject隐藏子属性
productExclusionsarray<object>隐藏子属性
productIdstringproductIdTypestring必填sharedSettingsobject必填隐藏子属性
brandstring必填brandLogosobject隐藏子属性
assetIdstring必填assetVersionstring必填formatPropertiesarray<object>隐藏子属性
heightintegerleftintegertopintegerwidthintegerbrandGallerySettingsobject隐藏子属性
brandstring必填brandLogosarray<object>必填隐藏子属性
assetIdstring必填assetVersionstring必填formatPropertiesarray<object>隐藏子属性
heightintegerleftintegertopintegerwidthintegercardsarray<object>隐藏子属性
customImageobject隐藏子属性
assetIdstring必填assetVersionstring必填formatPropertiesarray<object>隐藏子属性
heightintegerleftintegertopintegerwidthintegerheadlinestringlandingPageobject隐藏子属性
landingPageTypestring必填landingPageUrlstring必填creativePropertiesToOptimizearray<any>customImagesarray<object>隐藏子属性
assetIdstring必填assetVersionstring必填formatPropertiesarray<object>隐藏子属性
heightintegerleftintegertopintegerwidthintegerenableCreativeAutoTranslationbooleanheadlinesarray<any>landingPageobject必填隐藏子属性
landingPageTypestring必填landingPageUrlstring必填manualCollectionSettingsobject隐藏子属性
landingPageobject必填隐藏子属性
landingPageTypestring必填landingPageUrlstringproductInclusionsarray<object>必填隐藏子属性
productIdstringproductIdTypestring必填sharedSettingsobject必填隐藏子属性
brandstring必填brandLogosobject隐藏子属性
assetIdstring必填assetVersionstring必填formatPropertiesarray<object>隐藏子属性
heightintegerleftintegertopintegerwidthintegertitlestringproductCollectionSettingsobject隐藏子属性
brandstring必填brandLogosarray<object>必填隐藏子属性
assetIdstring必填assetVersionstring必填formatPropertiesarray<object>隐藏子属性
heightintegerleftintegertopintegerwidthintegercreativePropertiesToOptimizearray<any>customImagesarray<object>必填隐藏子属性
assetIdstring必填assetVersionstring必填formatPropertiesarray<object>隐藏子属性
heightintegerleftintegertopintegerwidthintegerenableCreativeAutoTranslationbooleanheadlinesarray<any>必填landingPageobject必填隐藏子属性
landingPageAsinsobject隐藏子属性
asinsarray<any>必填landingPageTypestring必填landingPageUrlstringproductsarray<object>隐藏子属性
productIdstringproductIdTypestring必填productVideoSettingsobject隐藏子属性
brandstringbrandLogosarray<object>隐藏子属性
assetIdstring必填assetVersionstring必填formatPropertiesarray<object>隐藏子属性
heightintegerleftintegertopintegerwidthintegerenableCreativeAutoTranslationbooleanheadlinesarray<any>landingPageobject隐藏子属性
landingPageTypestring必填landingPageUrlstringproductsarray<object>隐藏子属性
productIdstringproductIdTypestring必填videosarray<object>必填隐藏子属性
assetIdstring必填assetVersionstring必填storeSpotlightSettingsobject隐藏子属性
brandstring必填brandLogosarray<object>必填隐藏子属性
assetIdstring必填assetVersionstring必填formatPropertiesarray<object>隐藏子属性
heightintegerleftintegertopintegerwidthintegercardsarray<object>必填隐藏子属性
headlinestring必填landingPageobject必填隐藏子属性
landingPageTypestring必填landingPageUrlstring必填productsobject必填隐藏子属性
productIdstringproductIdTypestring必填creativePropertiesToOptimizearray<any>enableCreativeAutoTranslationbooleanheadlinesarray<any>必填landingPageobject必填隐藏子属性
landingPageTypestring必填landingPageUrlstring必填namestring必填statestring必填请求cURL示例
curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSbAds?access_token=value×tamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
"profileId": "1234567890123456",
"ads": [
{
"adGroupId": "1234567890123456",
"adProduct": "SPONSORED_BRANDS",
"adType": "COMPONENT",
"creative": {
"componentCreative": {
"productCollectionSettings": {
"brand": "Example Brand",
"brandLogos": [
{
"assetId": "asset-id-placeholder",
"assetVersion": "1"
}
],
"customImages": [
{
"assetId": "asset-id-placeholder",
"assetVersion": "1"
}
],
"headlines": [
"example"
],
"landingPage": {
"landingPageType": "STORE",
"landingPageUrl": "https://www.amazon.com/stores/example"
},
"products": [
{
"productId": "B000000001",
"productIdType": "ASIN"
},
{
"productId": "B000000002",
"productIdType": "ASIN"
},
{
"productId": "B000000003",
"productIdType": "ASIN"
}
]
}
}
},
"name": "示例广告",
"state": "PAUSED"
}
]
}'
返回结果
Json Object
codeinteger必填messagestring必填error_detailsarray<any>必填request_idstring必填response_timestring必填dataobject必填隐藏子属性
apiResultarray<object>必填隐藏子属性
adGroupIdstring必填adIdstring必填adProductstring必填adTypestring必填campaignIdstring必填creationDateTimestring必填creativeobject必填隐藏子属性
componentCreativeobject必填隐藏子属性
productCollectionSettingsobject必填隐藏子属性
brandstring必填brandLogosarray<object>必填隐藏子属性
assetIdstring必填assetVersionstring必填formatPropertiesarray<object>必填隐藏子属性
heightinteger必填leftinteger必填topinteger必填widthinteger必填customImagesarray<object>必填隐藏子属性
assetIdstring必填assetVersionstring必填formatPropertiesarray<object>必填隐藏子属性
heightinteger必填leftinteger必填topinteger必填widthinteger必填headlinesarray<any>必填landingPageobject必填隐藏子属性
landingPageTypestring必填landingPageUrlstring必填moderationStatusobject必填隐藏子属性
moderationStatusstring必填productsarray<object>必填隐藏子属性
productIdstring必填productIdTypestring必填untranslatedHeadlinesarray<any>必填lastUpdatedDateTimestring必填marketplaceScopestring必填marketplacesarray<any>必填namestring必填statestring必填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",
"adId": "1234567890123456",
"adProduct": "SPONSORED_BRANDS",
"adType": "COMPONENT",
"campaignId": "1234567890123456",
"creationDateTime": "2026-10-20T00:00:00Z",
"creative": {
"componentCreative": {
"productCollectionSettings": {
"brand": "Example Brand",
"brandLogos": [
{
"assetId": "asset-id-placeholder",
"assetVersion": "1",
"formatProperties": [
{
"height": 1,
"left": 1,
"top": 1,
"width": 1
}
]
}
],
"customImages": [
{
"assetId": "asset-id-placeholder",
"assetVersion": "1",
"formatProperties": [
{
"height": 1,
"left": 1,
"top": 1,
"width": 1
}
]
}
],
"headlines": [
"example"
],
"landingPage": {
"landingPageType": "STORE",
"landingPageUrl": "https://www.amazon.com/stores/example"
},
"moderationStatus": {
"moderationStatus": "SUBMITTED_FOR_MODERATION"
},
"products": [
{
"productId": "B000000001",
"productIdType": "ASIN"
}
],
"untranslatedHeadlines": [
"example"
]
}
}
},
"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开始的原始下标。
- 示例仅说明数据结构,不是经过真实创建验证的返回。调用前替换标识及投放配置;字段说明中的源接口样本信息来自上游接口定义。
- 返回字段表描述创建成功项,实际字段取决于创意类型及上游返回,失败项可能只包含结果码和下标。
- componentCreative 中须恰好指定一种创意配置,所属广告组必须属于当前授权店铺。