创建 SP 广告
POST
/basicOpen/adReport/manage/postSpAds接口信息
| API Path | 请求协议 | 请求方式 | 令牌桶容量 |
|---|---|---|---|
/basicOpen/adReport/manage/postSpAds | HTTPS | POST | 1 |
请求参数
profileIdstring必填adsarray<object>必填隐藏子属性
adGroupIdstring必填adProductstring必填adTypestring必填creativeobject必填隐藏子属性
productCreativeobject必填隐藏子属性
productCreativeSettingsobject必填隐藏子属性
advertisedProductobject必填隐藏子属性
globalStoreSettingobject隐藏子属性
catalogSourceMarketplacestringproductIdstring必填productIdTypestring必填headlinestringspotlightVideosobject隐藏子属性
optimizeTextboolean必填videosarray<object>必填隐藏子属性
assetIdstring必填assetVersionstring必填descriptionstringheadlinestring必填statestring必填请求cURL示例
curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSpAds?access_token=value×tamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
"profileId": "1234567890123456",
"ads": [
{
"adGroupId": "1234567890123456",
"adProduct": "SPONSORED_PRODUCTS",
"adType": "PRODUCT_AD",
"creative": {
"productCreative": {
"productCreativeSettings": {
"advertisedProduct": {
"productId": "B000000001",
"productIdType": "ASIN"
}
}
}
},
"state": "PAUSED"
}
]
}'
返回结果
Json Object
codeinteger必填messagestring必填error_detailsarray<any>必填request_idstring必填response_timestring必填dataobject必填隐藏子属性
apiResultarray<object>必填隐藏子属性
adGroupIdstring必填adIdstring必填adProductstring必填adTypestring必填campaignIdstring必填creationDateTimestring必填creativeobject必填隐藏子属性
productCreativeobject必填隐藏子属性
productCreativeSettingsobject必填隐藏子属性
advertisedProductobject必填隐藏子属性
globalStoreSettingobject必填隐藏子属性
catalogSourceMarketplacestring必填productIdstring必填productIdTypestring必填resolvedProductIdstring必填resolvedProductIdTypestring必填headlinestring必填spotlightVideosobject必填隐藏子属性
optimizeTextboolean必填videosarray<object>必填隐藏子属性
assetIdstring必填assetVersionstring必填descriptionstring必填headlinestring必填globalAdIdstring必填lastUpdatedDateTimestring必填marketplaceScopestring必填marketplacesarray<any>必填statestring必填statusobject必填隐藏子属性
deliveryReasonsarray<any>必填deliveryStatusstring必填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_PRODUCTS",
"adType": "PRODUCT_AD",
"campaignId": "1234567890123456",
"creationDateTime": "2026-10-20T00:00:00Z",
"creative": {
"productCreative": {
"productCreativeSettings": {
"advertisedProduct": {
"globalStoreSetting": {
"catalogSourceMarketplace": "AE"
},
"productId": "B000000001",
"productIdType": "ASIN",
"resolvedProductId": "example",
"resolvedProductIdType": "ASIN"
},
"headline": "Example headline",
"spotlightVideos": {
"optimizeText": false,
"videos": [
{
"assetId": "asset-id-placeholder",
"assetVersion": "1",
"description": "example",
"headline": "Example headline"
}
]
}
}
}
},
"globalAdId": "example",
"lastUpdatedDateTime": "2026-10-20T00:00:00Z",
"marketplaceScope": "SINGLE_MARKETPLACE",
"marketplaces": [
"US"
],
"state": "PAUSED",
"status": {
"deliveryReasons": [
"example"
],
"deliveryStatus": "DELIVERING"
},
"code": "SUCCESS",
"index": 0
}
]
},
"total": 0
}
附加说明
- profileId 必须属于当前授权企业。标识使用字符串传递,避免长整数精度丢失。
- 在 Query 中传入 access_token、app_key、timestamp、sign。修改请求体或鉴权参数后须重新计算签名,签名传输时只进行一次 URL 编码。
- 先检查顶层 code,再逐项检查 data.apiResult[].code。顶层成功不代表每项均创建成功;index 是请求数组中从0开始的原始下标。
- 示例仅说明数据结构,不是经过真实创建验证的返回。调用前替换标识及投放配置;字段说明中的源接口样本信息来自上游接口定义。
- 返回字段表描述创建成功项,实际字段取决于创意类型及上游返回,失败项可能只包含结果码和下标。