Qeasy Cloud
Get Started

领星ERP 创建 SD 广告 API

Platform
领星ERP
Type
WebAPI
Effect
EXECUTE
API Version
1.0
Adapter
\Adapter\LingXing\LXExecuteAdapter
Auth Mode
OTHER
Description
广告 / 广告管理 · POST · 请求参数 27 个(必填 19) · 响应参数 106 个 · 限流令牌桶容量 1
Updated At
2026-11-21

创建 SD 广告

POST/basicOpen/adReport/manage/postSdAds
Factory
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/adReport/manage/postSdAds"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSdAds?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"profileId\": \"1234567890123456\",\n    \"ads\": [\n        {\n            \"adGroupId\": \"1234567890123456\",\n            \"adProduct\": \"SPONSORED_DISPLAY\",\n            \"adType\": \"COMPONENT\",\n            \"creative\": {\n                \"componentCreative\": {\n                    \"responsiveEcommerceSettings\": {\n                        \"products\": [\n                            {\n                                \"productId\": \"EXAMPLE-SKU-001\",\n                                \"productIdType\": \"SKU\"\n                            }\n                        ]\n                    }\n                }\n            },\n            \"state\": \"PAUSED\"\n        }\n    ]\n}'",
  "responseExample": {
    "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
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1profileId当前授权企业下的广告店铺标识string—Required当前授权企业下的广告店铺标识。建议使用数字字符串,避免长整数精度丢失。
2ads待创建的展示型推广广告列表array<object>—Required待创建的展示型推广广告列表,每次提交 1~100 项。 最少1项 最多100项
2.1adGroupId广告所属的广告组标识string—Required广告所属的广告组标识。必须是当前租户和 profileId 下的有效广告组;当前服务按正整数值校验,建议以字符串传递。
2.2adProduct广告产品线string—Required广告产品线,详见引用定义。
2.3adType广告创意类型string—Required广告创意类型,详见引用定义。
2.4creative广告创意object—Required广告创意,详见引用定义。
2.4.1componentCreative组件式创意object—Required组件式创意,详见引用定义。
2.4.1.1assetBasedCreativeSettings素材型创意设置object—Optional素材型创意设置,详见引用定义。
2.4.1.1.1landingPage落地页object—Required落地页,详见引用定义。
2.4.1.1.1.1landingPageType落地页类型string—Required落地页类型,详见引用定义。
2.4.1.1.1.2landingPageUrl点击广告后跳转的落地页地址string—Required点击广告后跳转的落地页地址。
2.4.1.2productVideoSettings商品视频创意设置object—Optional商品视频创意设置,详见引用定义。
2.4.1.2.1landingPage落地页object—Optional落地页,详见引用定义。
2.4.1.2.1.1landingPageType落地页类型string—Required落地页类型,详见引用定义。
2.4.1.2.1.2landingPageUrl点击广告后跳转的落地页地址string—Required点击广告后跳转的落地页地址。
2.4.1.2.2products视频广告中展示的商品列表array<object>—Optional视频广告中展示的商品列表。
2.4.1.2.2.1productId被推广商品的标识string—Required被推广商品的标识,具体含义由 productIdType 决定。
2.4.1.2.2.2productIdType商品标识类型string—Required商品标识类型,详见引用定义。
2.4.1.3responsiveEcommerceSettings响应式电商创意设置object—Optional响应式电商创意设置,详见引用定义。
2.4.1.3.1landingPage落地页object—Optional落地页,详见引用定义。
2.4.1.3.1.1landingPageType落地页类型string—Required落地页类型,详见引用定义。
2.4.1.3.1.2landingPageUrl点击广告后跳转的落地页地址string—Required点击广告后跳转的落地页地址。
2.4.1.3.2products响应式电商创意推广的商品列表array<object>—Optional响应式电商创意推广的商品列表。
2.4.1.3.2.1productId被推广商品的标识string—Required被推广商品的标识,具体含义由 productIdType 决定。
2.4.1.3.2.2productIdType商品标识类型string—Required商品标识类型,详见引用定义。
2.5name广告名称string—Optional广告名称。官方定义为可选。用户已联调的响应式电商商品广告传入非空名称时返回 FIELD_VALUE_IS_INVALID / name is non-null,成功样本省略了此字段;该场景请不传,不应据此推定所有创意场景都禁止名称。
2.6state广告状态string—Required广告状态,详见引用定义。

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code平台业务状态码integer0Required平台业务状态码,0 表示成功
2message响应消息stringsuccessRequired响应消息
3error_details参数校验等错误详情array<any>[]Required参数校验等错误详情
4request_id请求链路标识stringexample-request-idRequired请求链路标识
5response_time响应时间string2026-10-19 12:00:00Required响应时间
6data响应数据object—Required响应数据。
6.1apiResult须逐项检查 codearray<object>—Required须逐项检查 code;整体成功标志不能替代每项创建结果。
6.1.1codeSUCCESS 表示当前广告创建成功stringSUCCESSRequiredSUCCESS 表示当前广告创建成功。
6.1.2index对应 ads 数组中的原始下标integer—Required对应 ads 数组中的原始下标,从 0 开始。
6.1.3adGroupId创建后广告所属的广告组标识string—Required创建后广告所属的广告组标识。
6.1.4adId亚马逊生成的广告标识string—Required亚马逊生成的广告标识。
6.1.5adProduct广告产品线string—Required广告产品线。
6.1.6adType广告创意类型string—Required广告创意类型。
6.1.7campaignId广告所属的广告活动标识string—Required广告所属的广告活动标识,由响应返回。
6.1.8creationDateTime广告创建时间string—Required广告创建时间,采用包含时区偏移或 Z 的日期时间格式;保留用户响应中的 -07:00 偏移。
6.1.9creative创建后返回的广告创意object—Required创建后返回的广告创意;嵌套字段依据官方响应定义,实际返回取决于创意类型。
6.1.9.1componentCreative组件式创意object—Required组件式创意,详见引用定义。
6.1.9.1.1assetBasedCreativeSettings素材型创意设置object—Required素材型创意设置,详见引用定义。
6.1.9.1.1.1backgrounds广告中展示的背景array<object>—Required广告中展示的背景。
6.1.9.1.1.1.1color背景颜色的十六进制颜色代码string—Required背景颜色的十六进制颜色代码。
6.1.9.1.1.2enableCreativeAutoTranslation设为 true 时boolean—Required设为 true 时,如果标题或视频不是站点默认语言,亚马逊会尝试将其翻译为站点默认语言;无法完成翻译时,广告将无法通过审核。
6.1.9.1.1.3hasTermsAndConditions表示广告推广免费商品或服务boolean—Required表示广告推广免费商品或服务,且消费者需要满足相关条款。落地页必须说明这些条款,或包含指向条款页面的链接。
6.1.9.1.1.4headlines素材型创意使用的标题文案array<any>—Required素材型创意使用的标题文案。
6.1.9.1.1.5images创意使用的图片素材array<object>—Required创意使用的图片素材。
6.1.9.1.1.5.1assetId图片在素材库中的标识string—Required图片在素材库中的标识。
6.1.9.1.1.5.2assetVersion图片在素材库中的版本string—Required图片在素材库中的版本。
6.1.9.1.1.5.3formatProperties素材对应的裁剪和定位设置array<object>—Required素材对应的裁剪和定位设置。
6.1.9.1.1.5.3.1height裁剪后图片的高度integer—Required裁剪后图片的高度,单位为像素。
6.1.9.1.1.5.3.2left裁剪起点距离图片左侧的像素数integer—Required裁剪起点距离图片左侧的像素数。
6.1.9.1.1.5.3.3top裁剪起点距离图片顶部的像素数integer—Required裁剪起点距离图片顶部的像素数。
6.1.9.1.1.5.3.4width裁剪后图片的宽度integer—Required裁剪后图片的宽度,单位为像素。
6.1.9.1.1.6landingPage落地页object—Required落地页,详见引用定义。
6.1.9.1.1.6.1landingPageType落地页类型string—Required落地页类型,详见引用定义。
6.1.9.1.1.6.2landingPageUrl点击广告后跳转的落地页地址string—Required点击广告后跳转的落地页地址。
6.1.9.1.1.7logos素材型创意使用的标志图片array<object>—Required素材型创意使用的标志图片。
6.1.9.1.1.7.1assetId图片在素材库中的标识string—Required图片在素材库中的标识。
6.1.9.1.1.7.2assetVersion图片在素材库中的版本string—Required图片在素材库中的版本。
6.1.9.1.1.7.3formatProperties素材对应的裁剪和定位设置array<object>—Required素材对应的裁剪和定位设置。
6.1.9.1.1.7.3.1height裁剪后图片的高度integer—Required裁剪后图片的高度,单位为像素。
6.1.9.1.1.7.3.2left裁剪起点距离图片左侧的像素数integer—Required裁剪起点距离图片左侧的像素数。
6.1.9.1.1.7.3.3top裁剪起点距离图片顶部的像素数integer—Required裁剪起点距离图片顶部的像素数。
6.1.9.1.1.7.3.4width裁剪后图片的宽度integer—Required裁剪后图片的宽度,单位为像素。
6.1.9.1.1.8moderationStatus审核状态object—Required审核状态,详见引用定义。
6.1.9.1.1.8.1moderationStatus审核状态string—Required审核状态,详见引用定义。
6.1.9.1.1.9untranslatedHeadlines广告主输入、尚未翻译的原始标题文案array<any>—Required广告主输入、尚未翻译的原始标题文案。
6.1.9.1.2productVideoSettings商品视频创意设置object—Required商品视频创意设置,详见引用定义。
6.1.9.1.2.1brandLogos广告使用的品牌标志图片素材array<object>—Required广告使用的品牌标志图片素材。
6.1.9.1.2.1.1assetId图片在素材库中的标识string—Required图片在素材库中的标识。
6.1.9.1.2.1.2assetVersion图片在素材库中的版本string—Required图片在素材库中的版本。
6.1.9.1.2.1.3formatProperties素材对应的裁剪和定位设置array<object>—Required素材对应的裁剪和定位设置。
6.1.9.1.2.1.3.1height裁剪后图片的高度integer—Required裁剪后图片的高度,单位为像素。
6.1.9.1.2.1.3.2left裁剪起点距离图片左侧的像素数integer—Required裁剪起点距离图片左侧的像素数。
6.1.9.1.2.1.3.3top裁剪起点距离图片顶部的像素数integer—Required裁剪起点距离图片顶部的像素数。
6.1.9.1.2.1.3.4width裁剪后图片的宽度integer—Required裁剪后图片的宽度,单位为像素。
6.1.9.1.2.2enableCreativeAutoTranslation设为 true 时boolean—Required设为 true 时,如果标题或视频不是站点默认语言,亚马逊会尝试将其翻译为站点默认语言;无法完成翻译时,广告将无法通过审核。
6.1.9.1.2.3headlines随广告创意提交的标题array<any>—Required随广告创意提交的标题。投放期间,亚马逊会从提供的标题中进行优化,以匹配消费者意图。
6.1.9.1.2.4landingPage落地页object—Required落地页,详见引用定义。
6.1.9.1.2.4.1landingPageType落地页类型string—Required落地页类型,详见引用定义。
6.1.9.1.2.4.2landingPageUrl点击广告后跳转的落地页地址string—Required点击广告后跳转的落地页地址。
6.1.9.1.2.5moderationStatus审核状态object—Required审核状态,详见引用定义。
6.1.9.1.2.5.1moderationStatus审核状态string—Required审核状态,详见引用定义。
6.1.9.1.2.6products视频广告中展示的商品列表array<object>—Required视频广告中展示的商品列表。
6.1.9.1.2.6.1productId被推广商品的标识string—Required被推广商品的标识,具体含义由 productIdType 决定。
6.1.9.1.2.6.2productIdType商品标识类型string—Required商品标识类型,详见引用定义。
6.1.9.1.2.7untranslatedHeadlines广告主输入、尚未翻译的原始标题文案array<any>—Required广告主输入、尚未翻译的原始标题文案。
6.1.9.1.2.8untranslatedVideos随创意提交的原始视频素材array<object>—Required随创意提交的原始视频素材。
6.1.9.1.2.8.1assetId视频在素材库中的标识string—Required视频在素材库中的标识。
6.1.9.1.2.8.2assetVersion视频在素材库中的版本string—Required视频在素材库中的版本。
6.1.9.1.2.9videos广告中使用的视频素材array<object>—Required广告中使用的视频素材。
6.1.9.1.2.9.1assetId视频在素材库中的标识string—Required视频在素材库中的标识。
6.1.9.1.2.9.2assetVersion视频在素材库中的版本string—Required视频在素材库中的版本。
6.1.9.1.3responsiveEcommerceSettings响应式电商创意设置object—Required响应式电商创意设置,详见引用定义。
6.1.9.1.3.1enableCreativeAutoTranslation设为 true 时boolean—Required设为 true 时,如果标题或视频不是站点默认语言,亚马逊会尝试将其翻译为站点默认语言;无法完成翻译时,广告将无法通过审核。
6.1.9.1.3.2headlines响应式电商创意使用的标题文案string—Required响应式电商创意使用的标题文案。
6.1.9.1.3.3images创意使用的图片素材array<object>—Required创意使用的图片素材。
6.1.9.1.3.3.1assetId图片在素材库中的标识string—Required图片在素材库中的标识。
6.1.9.1.3.3.2assetVersion图片在素材库中的版本string—Required图片在素材库中的版本。
6.1.9.1.3.3.3formatProperties素材对应的裁剪和定位设置array<object>—Required素材对应的裁剪和定位设置。
6.1.9.1.3.3.3.1height裁剪后图片的高度integer—Required裁剪后图片的高度,单位为像素。
6.1.9.1.3.3.3.2left裁剪起点距离图片左侧的像素数integer—Required裁剪起点距离图片左侧的像素数。
6.1.9.1.3.3.3.3top裁剪起点距离图片顶部的像素数integer—Required裁剪起点距离图片顶部的像素数。
6.1.9.1.3.3.3.4width裁剪后图片的宽度integer—Required裁剪后图片的宽度,单位为像素。
6.1.9.1.3.4landingPage落地页object—Required落地页,详见引用定义。
6.1.9.1.3.4.1landingPageType落地页类型string—Required落地页类型,详见引用定义。
6.1.9.1.3.4.2landingPageUrl点击广告后跳转的落地页地址string—Required点击广告后跳转的落地页地址。
6.1.9.1.3.5logos标志图片object—Required标志图片,详见引用定义。
6.1.9.1.3.5.1assetId图片在素材库中的标识string—Required图片在素材库中的标识。
6.1.9.1.3.5.2assetVersion图片在素材库中的版本string—Required图片在素材库中的版本。
6.1.9.1.3.5.3formatProperties素材对应的裁剪和定位设置array<object>—Required素材对应的裁剪和定位设置。
6.1.9.1.3.5.3.1height裁剪后图片的高度integer—Required裁剪后图片的高度,单位为像素。
6.1.9.1.3.5.3.2left裁剪起点距离图片左侧的像素数integer—Required裁剪起点距离图片左侧的像素数。
6.1.9.1.3.5.3.3top裁剪起点距离图片顶部的像素数integer—Required裁剪起点距离图片顶部的像素数。
6.1.9.1.3.5.3.4width裁剪后图片的宽度integer—Required裁剪后图片的宽度,单位为像素。
6.1.9.1.3.6moderationStatus审核状态object—Required审核状态,详见引用定义。
6.1.9.1.3.6.1moderationStatus审核状态string—Required审核状态,详见引用定义。
6.1.9.1.3.7products响应式电商创意推广的商品列表array<object>—Required响应式电商创意推广的商品列表。
6.1.9.1.3.7.1productId被推广商品的标识string—Required被推广商品的标识,具体含义由 productIdType 决定。
6.1.9.1.3.7.2productIdType商品标识类型string—Required商品标识类型,详见引用定义。
6.1.9.1.3.8untranslatedHeadlines广告主输入、尚未翻译的原始标题文案string—Required广告主输入、尚未翻译的原始标题文案。
6.1.10lastUpdatedDateTime广告最后更新时间string—Required广告最后更新时间,采用包含时区偏移或 Z 的日期时间格式。
6.1.11marketplaceScope站点范围string—Required站点范围。
6.1.12marketplaces广告适用的亚马逊站点代码array<any>—Required广告适用的亚马逊站点代码;应与父广告组的站点一致或为其子集。
6.1.13state广告状态string—Required广告状态。
6.1.14status广告投放状态信息object—Required广告投放状态信息。
6.1.14.1deliveryReasons投放状态原因码列表array<any>—Required投放状态原因码列表。真实响应包含 OTHER;官方当前枚举未包含该值,因此此响应字段保留为字符串,兼容亚马逊实际返回的原因码。
7total统一响应中的总数integer0Required统一响应中的总数,本创建接口未设置分页总数,默认为0

The 创建 SD 广告 API (/basicOpen/adReport/manage/postSdAds) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.