轻易云
注册体验

领星ERP创建 SD 广告接口

所属平台
领星ERP
类型
WebAPI
作用
EXECUTE
接口版本
1.0
适配器
\Adapter\LingXing\LXExecuteAdapter
授权方式
OTHER
描述
广告 / 广告管理 · POST · 请求参数 27 个(必填 19) · 响应参数 106 个 · 限流令牌桶容量 1
更新日期
2026-11-21

创建 SD 广告

POST/basicOpen/adReport/manage/postSdAds
加工厂
{
  "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
  }
}

接口请求参数

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

接口响应参数

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

领星ERP的接口:创建 SD 广告(/basicOpen/adReport/manage/postSdAds),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。