Lingxing
切换旧版

创建 SD 广告

POST/basicOpen/adReport/manage/postSdAds

接口信息

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

请求参数

profileIdstring必填
当前授权企业下的广告店铺标识。建议使用数字字符串,避免长整数精度丢失。
adsarray<object>必填
待创建的展示型推广广告列表,每次提交 1~100 项。
最少1项
最多100项
隐藏子属性
adGroupIdstring必填
广告所属的广告组标识。必须是当前租户和 profileId 下的有效广告组;当前服务按正整数值校验,建议以字符串传递。
adProductstring必填
广告产品线,详见引用定义。
adTypestring必填
广告创意类型,详见引用定义。
creativeobject必填
广告创意,详见引用定义。
隐藏子属性
componentCreativeobject必填
组件式创意,详见引用定义。
隐藏子属性
assetBasedCreativeSettingsobject
素材型创意设置,详见引用定义。
隐藏子属性
landingPageobject必填
落地页,详见引用定义。
隐藏子属性
landingPageTypestring必填
落地页类型,详见引用定义。
landingPageUrlstring必填
点击广告后跳转的落地页地址。
productVideoSettingsobject
商品视频创意设置,详见引用定义。
隐藏子属性
landingPageobject
落地页,详见引用定义。
隐藏子属性
landingPageTypestring必填
落地页类型,详见引用定义。
landingPageUrlstring必填
点击广告后跳转的落地页地址。
productsarray<object>
视频广告中展示的商品列表。
隐藏子属性
productIdstring必填
被推广商品的标识,具体含义由 productIdType 决定。
productIdTypestring必填
商品标识类型,详见引用定义。
responsiveEcommerceSettingsobject
响应式电商创意设置,详见引用定义。
隐藏子属性
landingPageobject
落地页,详见引用定义。
隐藏子属性
landingPageTypestring必填
落地页类型,详见引用定义。
landingPageUrlstring必填
点击广告后跳转的落地页地址。
productsarray<object>
响应式电商创意推广的商品列表。
隐藏子属性
productIdstring必填
被推广商品的标识,具体含义由 productIdType 决定。
productIdTypestring必填
商品标识类型,详见引用定义。
namestring
广告名称。官方定义为可选。用户已联调的响应式电商商品广告传入非空名称时返回 FIELD_VALUE_IS_INVALID / name is non-null,成功样本省略了此字段;该场景请不传,不应据此推定所有创意场景都禁止名称。
statestring必填
广告状态,详见引用定义。

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSdAds?access_token=value&timestamp=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必填
平台业务状态码,0 表示成功
示例 0
messagestring必填
响应消息
示例 success
error_detailsarray<any>必填
参数校验等错误详情
示例 []
request_idstring必填
请求链路标识
示例 example-request-id
response_timestring必填
响应时间
示例 2026-10-19 12:00:00
dataobject必填
响应数据。
隐藏子属性
apiResultarray<object>必填
须逐项检查 code;整体成功标志不能替代每项创建结果。
隐藏子属性
codestring必填
SUCCESS 表示当前广告创建成功。
示例 SUCCESS
indexinteger必填
对应 ads 数组中的原始下标,从 0 开始。
adGroupIdstring必填
创建后广告所属的广告组标识。
adIdstring必填
亚马逊生成的广告标识。
adProductstring必填
广告产品线。
adTypestring必填
广告创意类型。
campaignIdstring必填
广告所属的广告活动标识,由响应返回。
creationDateTimestring必填
广告创建时间,采用包含时区偏移或 Z 的日期时间格式;保留用户响应中的 -07:00 偏移。
creativeobject必填
创建后返回的广告创意;嵌套字段依据官方响应定义,实际返回取决于创意类型。
隐藏子属性
componentCreativeobject必填
组件式创意,详见引用定义。
隐藏子属性
assetBasedCreativeSettingsobject必填
素材型创意设置,详见引用定义。
隐藏子属性
backgroundsarray<object>必填
广告中展示的背景。
隐藏子属性
colorstring必填
背景颜色的十六进制颜色代码。
enableCreativeAutoTranslationboolean必填
设为 true 时,如果标题或视频不是站点默认语言,亚马逊会尝试将其翻译为站点默认语言;无法完成翻译时,广告将无法通过审核。
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必填
设为 true 时,如果标题或视频不是站点默认语言,亚马逊会尝试将其翻译为站点默认语言;无法完成翻译时,广告将无法通过审核。
headlinesarray<any>必填
随广告创意提交的标题。投放期间,亚马逊会从提供的标题中进行优化,以匹配消费者意图。
landingPageobject必填
落地页,详见引用定义。
隐藏子属性
landingPageTypestring必填
落地页类型,详见引用定义。
landingPageUrlstring必填
点击广告后跳转的落地页地址。
moderationStatusobject必填
审核状态,详见引用定义。
隐藏子属性
moderationStatusstring必填
审核状态,详见引用定义。
productsarray<object>必填
视频广告中展示的商品列表。
隐藏子属性
productIdstring必填
被推广商品的标识,具体含义由 productIdType 决定。
productIdTypestring必填
商品标识类型,详见引用定义。
untranslatedHeadlinesarray<any>必填
广告主输入、尚未翻译的原始标题文案。
untranslatedVideosarray<object>必填
随创意提交的原始视频素材。
隐藏子属性
assetIdstring必填
视频在素材库中的标识。
assetVersionstring必填
视频在素材库中的版本。
videosarray<object>必填
广告中使用的视频素材。
隐藏子属性
assetIdstring必填
视频在素材库中的标识。
assetVersionstring必填
视频在素材库中的版本。
responsiveEcommerceSettingsobject必填
响应式电商创意设置,详见引用定义。
隐藏子属性
enableCreativeAutoTranslationboolean必填
设为 true 时,如果标题或视频不是站点默认语言,亚马逊会尝试将其翻译为站点默认语言;无法完成翻译时,广告将无法通过审核。
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必填
被推广商品的标识,具体含义由 productIdType 决定。
productIdTypestring必填
商品标识类型,详见引用定义。
untranslatedHeadlinesstring必填
广告主输入、尚未翻译的原始标题文案。
lastUpdatedDateTimestring必填
广告最后更新时间,采用包含时区偏移或 Z 的日期时间格式。
marketplaceScopestring必填
站点范围。
marketplacesarray<any>必填
广告适用的亚马逊站点代码;应与父广告组的站点一致或为其子集。
statestring必填
广告状态。
statusobject必填
广告投放状态信息。
隐藏子属性
deliveryReasonsarray<any>必填
投放状态原因码列表。真实响应包含 OTHER;官方当前枚举未包含该值,因此此响应字段保留为字符串,兼容亚马逊实际返回的原因码。
totalinteger必填
统一响应中的总数,本创建接口未设置分页总数,默认为0
示例 0

返回成功示例

{
    "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。