创建 SD 广告
POST
/basicOpen/adReport/manage/postSdAds接口信息
| API Path | 请求协议 | 请求方式 | 令牌桶容量 |
|---|---|---|---|
/basicOpen/adReport/manage/postSdAds | HTTPS | POST | 1 |
请求参数
profileIdstring必填adsarray<object>必填隐藏子属性
adGroupIdstring必填adProductstring必填adTypestring必填creativeobject必填隐藏子属性
componentCreativeobject必填隐藏子属性
assetBasedCreativeSettingsobject隐藏子属性
landingPageobject必填隐藏子属性
landingPageTypestring必填landingPageUrlstring必填productVideoSettingsobject隐藏子属性
landingPageobject隐藏子属性
landingPageTypestring必填landingPageUrlstring必填productsarray<object>隐藏子属性
productIdstring必填productIdTypestring必填responsiveEcommerceSettingsobject隐藏子属性
landingPageobject隐藏子属性
landingPageTypestring必填landingPageUrlstring必填productsarray<object>隐藏子属性
productIdstring必填productIdTypestring必填namestringstatestring必填请求cURL示例
curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSdAds?access_token=value×tamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
"profileId": "1234567890123456",
"ads": [
{
"adGroupId": "1234567890123456",
"adProduct": "SPONSORED_DISPLAY",
"adType": "COMPONENT",
"creative": {
"componentCreative": {
"responsiveEcommerceSettings": {
"products": [
{
"productId": "EXAMPLE-SKU-001",
"productIdType": "SKU"
}
]
}
}
},
"state": "PAUSED"
}
]
}'
返回结果
Json Object
codeinteger必填messagestring必填error_detailsarray<any>必填request_idstring必填response_timestring必填dataobject必填隐藏子属性
apiResultarray<object>必填隐藏子属性
codestring必填indexinteger必填adGroupIdstring必填adIdstring必填adProductstring必填adTypestring必填campaignIdstring必填creationDateTimestring必填creativeobject必填隐藏子属性
componentCreativeobject必填隐藏子属性
assetBasedCreativeSettingsobject必填隐藏子属性
backgroundsarray<object>必填隐藏子属性
colorstring必填enableCreativeAutoTranslationboolean必填hasTermsAndConditionsboolean必填headlinesarray<any>必填imagesarray<object>必填隐藏子属性
assetIdstring必填assetVersionstring必填formatPropertiesarray<object>必填隐藏子属性
heightinteger必填leftinteger必填topinteger必填widthinteger必填landingPageobject必填隐藏子属性
landingPageTypestring必填landingPageUrlstring必填logosarray<object>必填隐藏子属性
assetIdstring必填assetVersionstring必填formatPropertiesarray<object>必填隐藏子属性
heightinteger必填leftinteger必填topinteger必填widthinteger必填moderationStatusobject必填隐藏子属性
moderationStatusstring必填untranslatedHeadlinesarray<any>必填productVideoSettingsobject必填隐藏子属性
brandLogosarray<object>必填隐藏子属性
assetIdstring必填assetVersionstring必填formatPropertiesarray<object>必填隐藏子属性
heightinteger必填leftinteger必填topinteger必填widthinteger必填enableCreativeAutoTranslationboolean必填headlinesarray<any>必填landingPageobject必填隐藏子属性
landingPageTypestring必填landingPageUrlstring必填moderationStatusobject必填隐藏子属性
moderationStatusstring必填productsarray<object>必填隐藏子属性
productIdstring必填productIdTypestring必填untranslatedHeadlinesarray<any>必填untranslatedVideosarray<object>必填隐藏子属性
assetIdstring必填assetVersionstring必填videosarray<object>必填隐藏子属性
assetIdstring必填assetVersionstring必填responsiveEcommerceSettingsobject必填隐藏子属性
enableCreativeAutoTranslationboolean必填headlinesstring必填imagesarray<object>必填隐藏子属性
assetIdstring必填assetVersionstring必填formatPropertiesarray<object>必填隐藏子属性
heightinteger必填leftinteger必填topinteger必填widthinteger必填landingPageobject必填隐藏子属性
landingPageTypestring必填landingPageUrlstring必填logosobject必填隐藏子属性
assetIdstring必填assetVersionstring必填formatPropertiesarray<object>必填隐藏子属性
heightinteger必填leftinteger必填topinteger必填widthinteger必填moderationStatusobject必填隐藏子属性
moderationStatusstring必填productsarray<object>必填隐藏子属性
productIdstring必填productIdTypestring必填untranslatedHeadlinesstring必填lastUpdatedDateTimestring必填marketplaceScopestring必填marketplacesarray<any>必填statestring必填statusobject必填隐藏子属性
deliveryReasonsarray<any>必填totalinteger必填返回成功示例
{
"code": 0,
"message": "success",
"error_details": [],
"request_id": "example-request-id",
"response_time": "2026-10-19 12:00:00",
"data": {
"apiResult": [
{
"code": "SUCCESS",
"index": 0,
"adGroupId": "1234567890123456",
"adId": "1234567890123456",
"adProduct": "SPONSORED_DISPLAY",
"adType": "COMPONENT",
"campaignId": "1234567890123456",
"creationDateTime": "2026-10-20T00:00:00Z",
"creative": {
"componentCreative": {
"assetBasedCreativeSettings": {
"backgrounds": [
{
"color": "#FFFFFF"
}
],
"enableCreativeAutoTranslation": false,
"hasTermsAndConditions": false,
"headlines": [
"example"
],
"images": [
{
"assetId": "asset-id-placeholder",
"assetVersion": "1",
"formatProperties": [
{
"height": 1,
"left": 1,
"top": 1,
"width": 1
}
]
}
],
"landingPage": {
"landingPageType": "STORE",
"landingPageUrl": "https://www.amazon.com/stores/example"
},
"logos": [
{
"assetId": "asset-id-placeholder",
"assetVersion": "1",
"formatProperties": [
{
"height": 1,
"left": 1,
"top": 1,
"width": 1
}
]
}
],
"moderationStatus": {
"moderationStatus": "SUBMITTED_FOR_MODERATION"
},
"untranslatedHeadlines": [
"example"
]
},
"productVideoSettings": {
"brandLogos": [
{
"assetId": "asset-id-placeholder",
"assetVersion": "1",
"formatProperties": [
{
"height": 1,
"left": 1,
"top": 1,
"width": 1
}
]
}
],
"enableCreativeAutoTranslation": false,
"headlines": [
"example"
],
"landingPage": {
"landingPageType": "STORE",
"landingPageUrl": "https://www.amazon.com/stores/example"
},
"moderationStatus": {
"moderationStatus": "SUBMITTED_FOR_MODERATION"
},
"products": [
{
"productId": "B000000001",
"productIdType": "ASIN"
}
],
"untranslatedHeadlines": [
"example"
],
"untranslatedVideos": [
{
"assetId": "asset-id-placeholder",
"assetVersion": "1"
}
],
"videos": [
{
"assetId": "asset-id-placeholder",
"assetVersion": "1"
}
]
},
"responsiveEcommerceSettings": {
"enableCreativeAutoTranslation": false,
"headlines": "example",
"images": [
{
"assetId": "asset-id-placeholder",
"assetVersion": "1",
"formatProperties": [
{
"height": 1,
"left": 1,
"top": 1,
"width": 1
}
]
}
],
"landingPage": {
"landingPageType": "STORE",
"landingPageUrl": "https://www.amazon.com/stores/example"
},
"logos": {
"assetId": "asset-id-placeholder",
"assetVersion": "1",
"formatProperties": [
{
"height": 1,
"left": 1,
"top": 1,
"width": 1
}
]
},
"moderationStatus": {
"moderationStatus": "SUBMITTED_FOR_MODERATION"
},
"products": [
{
"productId": "B000000001",
"productIdType": "ASIN"
}
],
"untranslatedHeadlines": "example"
}
}
},
"lastUpdatedDateTime": "2026-10-20T00:00:00Z",
"marketplaceScope": "SINGLE_MARKETPLACE",
"marketplaces": [
"US"
],
"state": "PAUSED",
"status": {
"deliveryReasons": [
"example"
]
}
}
]
},
"total": 0
}
附加说明
- profileId 必须属于当前授权企业。标识使用字符串传递,避免长整数精度丢失。
- 在 Query 中传入 access_token、app_key、timestamp、sign。修改请求体或鉴权参数后须重新计算签名,签名传输时只进行一次 URL 编码。
- 先检查顶层 code,再逐项检查 data.apiResult[].code。顶层成功不代表每项均创建成功;index 是请求数组中从0开始的原始下标。
- 示例仅说明数据结构,不是经过真实创建验证的返回。调用前替换标识及投放配置;字段说明中的源接口样本信息来自上游接口定义。
- 返回字段表描述创建成功项,实际字段取决于创意类型及上游返回,失败项可能只包含结果码和下标。
- componentCreative 中须恰好指定一种创意配置,所属广告组必须属于当前授权店铺。
- 源接口样本中的响应式电商商品广告场景请省略 name;Vendor 商品使用 ASIN,Seller 商品使用 SKU。