Qeasy Cloud
Get Started

领星ERP 创建 SB 广告 API

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

创建 SB 广告

POST/basicOpen/adReport/manage/postSbAds
Factory
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/adReport/manage/postSbAds"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSbAds?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_BRANDS\",\n            \"adType\": \"COMPONENT\",\n            \"creative\": {\n                \"componentCreative\": {\n                    \"productCollectionSettings\": {\n                        \"brand\": \"Example Brand\",\n                        \"brandLogos\": [\n                            {\n                                \"assetId\": \"asset-id-placeholder\",\n                                \"assetVersion\": \"1\"\n                            }\n                        ],\n                        \"customImages\": [\n                            {\n                                \"assetId\": \"asset-id-placeholder\",\n                                \"assetVersion\": \"1\"\n                            }\n                        ],\n                        \"headlines\": [\n                            \"example\"\n                        ],\n                        \"landingPage\": {\n                            \"landingPageType\": \"STORE\",\n                            \"landingPageUrl\": \"https://www.amazon.com/stores/example\"\n                        },\n                        \"products\": [\n                            {\n                                \"productId\": \"B000000001\",\n                                \"productIdType\": \"ASIN\"\n                            },\n                            {\n                                \"productId\": \"B000000002\",\n                                \"productIdType\": \"ASIN\"\n                            },\n                            {\n                                \"productId\": \"B000000003\",\n                                \"productIdType\": \"ASIN\"\n                            }\n                        ]\n                    }\n                }\n            },\n            \"name\": \"示例广告\",\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": [
        {
          "adGroupId": "1234567890123456",
          "adId": "1234567890123456",
          "adProduct": "SPONSORED_BRANDS",
          "adType": "COMPONENT",
          "campaignId": "1234567890123456",
          "creationDateTime": "2026-10-20T00:00:00Z",
          "creative": {
            "componentCreative": {
              "productCollectionSettings": {
                "brand": "Example Brand",
                "brandLogos": [
                  {
                    "assetId": "asset-id-placeholder",
                    "assetVersion": "1",
                    "formatProperties": [
                      {
                        "height": 1,
                        "left": 1,
                        "top": 1,
                        "width": 1
                      }
                    ]
                  }
                ],
                "customImages": [
                  {
                    "assetId": "asset-id-placeholder",
                    "assetVersion": "1",
                    "formatProperties": [
                      {
                        "height": 1,
                        "left": 1,
                        "top": 1,
                        "width": 1
                      }
                    ]
                  }
                ],
                "headlines": [
                  "example"
                ],
                "landingPage": {
                  "landingPageType": "STORE",
                  "landingPageUrl": "https://www.amazon.com/stores/example"
                },
                "moderationStatus": {
                  "moderationStatus": "SUBMITTED_FOR_MODERATION"
                },
                "products": [
                  {
                    "productId": "B000000001",
                    "productIdType": "ASIN"
                  }
                ],
                "untranslatedHeadlines": [
                  "example"
                ]
              }
            }
          },
          "lastUpdatedDateTime": "2026-10-20T00:00:00Z",
          "marketplaceScope": "SINGLE_MARKETPLACE",
          "marketplaces": [
            "US"
          ],
          "name": "示例广告",
          "state": "PAUSED",
          "code": "SUCCESS",
          "index": 0
        }
      ]
    },
    "total": 0
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1profileId当前租户已授权的亚马逊广告店铺标识string—Required当前租户已授权的亚马逊广告店铺标识。使用正整数形式的字符串,避免长整数精度丢失。
2ads待创建的品牌推广广告列表array<object>—Required待创建的品牌推广广告列表,单次提交 1~10 条。 最少1项 最多10项
2.1adGroupId广告所属广告组的唯一标识string—Required广告所属广告组的唯一标识,必须属于当前授权广告店铺;使用数字字符串,当前服务要求正整数值。
2.2adProductadProductstring—RequiredSPONSORED_BRANDS 表示品牌推广广告。
2.3adTypeadTypestring—RequiredCOMPONENT 表示由视频、图片及商品等组件构成的创意广告。
2.4creative创意类型包装对象object—Required创意类型包装对象;品牌推广使用组件式创意。
2.4.1componentCreative包含具体的创意配置object—Required包含具体的创意配置。当前外部服务要求每条广告恰好指定一种创意配置。
2.4.1.1autoCollectionSettings自动生成的商品集object—Optional自动生成的商品集,支持设置排除商品和通用配置。
2.4.1.1.1productExclusions自动商品集需排除的商品array<object>—Optional自动商品集需排除的商品,最多 1000 项。
2.4.1.1.1.1productId推广商品的亚马逊标准商品标识string—Optional推广商品的亚马逊标准商品标识。本地服务要求填写非空字符串。
2.4.1.1.1.2productIdTypeASIN 表示亚马逊标准商品标识string—RequiredASIN 表示亚马逊标准商品标识。
2.4.1.1.2sharedSettings不同商品集类型共享的品牌配置object—Required不同商品集类型共享的品牌配置;官方定义中的品牌标志字段为单个素材对象。
2.4.1.1.2.1brand广告中展示和推广的品牌名称string—Required广告中展示和推广的品牌名称。
2.4.1.1.2.2brandLogos商品集通用配置的品牌标志图片object—Optional商品集通用配置的品牌标志图片,官方定义为单个素材对象。
2.4.1.1.2.2.1assetId素材库中图片或视频素材的唯一标识string—Required素材库中图片或视频素材的唯一标识。
2.4.1.1.2.2.2assetVersion素材库中该图片或视频对应的版本标识string—Required素材库中该图片或视频对应的版本标识。
2.4.1.1.2.2.3formatProperties素材裁剪和定位的属性列表array<object>—Optional素材裁剪和定位的属性列表,最多 10 项。
2.4.1.1.2.2.3.1height裁剪后图片的高度integer—Optional裁剪后图片的高度,单位为像素。
2.4.1.1.2.2.3.2left从原图左边缘到裁剪起点的距离integer—Optional从原图左边缘到裁剪起点的距离,单位为像素。
2.4.1.1.2.2.3.3top从原图上边缘到裁剪起点的距离integer—Optional从原图上边缘到裁剪起点的距离,单位为像素。
2.4.1.1.2.2.3.4width裁剪后图片的宽度integer—Optional裁剪后图片的宽度,单位为像素。
2.4.1.2brandGallerySettings展示品牌及其不同分类和商品集的创意object—Optional展示品牌及其不同分类和商品集的创意。
2.4.1.2.1brand广告中展示和推广的品牌名称string—Required广告中展示和推广的品牌名称。
2.4.1.2.2brandLogos广告使用的品牌标志图片素材array<object>—Required广告使用的品牌标志图片素材;各创意类型的数组数量限制或对象结构以当前字段定义为准。 最少1项
2.4.1.2.2.1assetId素材库中图片或视频素材的唯一标识string—Required素材库中图片或视频素材的唯一标识。
2.4.1.2.2.2assetVersion素材库中该图片或视频对应的版本标识string—Required素材库中该图片或视频对应的版本标识。
2.4.1.2.2.3formatProperties素材裁剪和定位的属性列表array<object>—Optional素材裁剪和定位的属性列表,最多 10 项。
2.4.1.2.2.3.1height裁剪后图片的高度integer—Optional裁剪后图片的高度,单位为像素。
2.4.1.2.2.3.2left从原图左边缘到裁剪起点的距离integer—Optional从原图左边缘到裁剪起点的距离,单位为像素。
2.4.1.2.2.3.3top从原图上边缘到裁剪起点的距离integer—Optional从原图上边缘到裁剪起点的距离,单位为像素。
2.4.1.2.2.3.4width裁剪后图片的宽度integer—Optional裁剪后图片的宽度,单位为像素。
2.4.1.2.3cards创意中的卡片子元素array<object>—Optional创意中的卡片子元素;各创意类型对应的卡片数量及字段要求以当前定义为准。
2.4.1.2.3.1customImage当前卡片展示的图片素材object—Optional当前卡片展示的图片素材。
2.4.1.2.3.1.1assetId素材库中图片或视频素材的唯一标识string—Required素材库中图片或视频素材的唯一标识。
2.4.1.2.3.1.2assetVersion素材库中该图片或视频对应的版本标识string—Required素材库中该图片或视频对应的版本标识。
2.4.1.2.3.1.3formatProperties素材裁剪和定位的属性列表array<object>—Optional素材裁剪和定位的属性列表,最多 10 项。
2.4.1.2.3.1.3.1height裁剪后图片的高度integer—Optional裁剪后图片的高度,单位为像素。
2.4.1.2.3.1.3.2left从原图左边缘到裁剪起点的距离integer—Optional从原图左边缘到裁剪起点的距离,单位为像素。
2.4.1.2.3.1.3.3top从原图上边缘到裁剪起点的距离integer—Optional从原图上边缘到裁剪起点的距离,单位为像素。
2.4.1.2.3.1.3.4width裁剪后图片的宽度integer—Optional裁剪后图片的宽度,单位为像素。
2.4.1.2.3.2headline当前创意卡片展示的标题文本string—Optional当前创意卡片展示的标题文本。
2.4.1.2.3.3landingPage用户点击广告或卡片后到达的页面object—Optional用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
2.4.1.2.3.3.1landingPageTypeSTORE 表示品牌旗舰店页面string—RequiredSTORE 表示品牌旗舰店页面。
2.4.1.2.3.3.2landingPageUrl点击广告后到达的页面地址string—Required点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
2.4.1.2.4creativePropertiesToOptimizecreativePropertiesToOptimizearray<any>—Optional允许亚马逊根据受众、广告位等因素增强或生成的创意属性。
2.4.1.2.5customImages广告展示的自定义图片素材array<object>—Optional广告展示的自定义图片素材;数量限制按当前创意类型的定义执行。
2.4.1.2.5.1assetId素材库中图片或视频素材的唯一标识string—Required素材库中图片或视频素材的唯一标识。
2.4.1.2.5.2assetVersion素材库中该图片或视频对应的版本标识string—Required素材库中该图片或视频对应的版本标识。
2.4.1.2.5.3formatProperties素材裁剪和定位的属性列表array<object>—Optional素材裁剪和定位的属性列表,最多 10 项。
2.4.1.2.5.3.1height裁剪后图片的高度integer—Optional裁剪后图片的高度,单位为像素。
2.4.1.2.5.3.2left从原图左边缘到裁剪起点的距离integer—Optional从原图左边缘到裁剪起点的距离,单位为像素。
2.4.1.2.5.3.3top从原图上边缘到裁剪起点的距离integer—Optional从原图上边缘到裁剪起点的距离,单位为像素。
2.4.1.2.5.3.4width裁剪后图片的宽度integer—Optional裁剪后图片的宽度,单位为像素。
2.4.1.2.6enableCreativeAutoTranslationtrue=当标题或视频语言与站点默认语言不一致时boolean—Optionaltrue=当标题或视频语言与站点默认语言不一致时,允许亚马逊尝试翻译;无法完成翻译可能导致审核拒绝。false=不启用。
2.4.1.2.7headlines广告主提交的创意标题array<any>—Optional广告主提交的创意标题,亚马逊可在投放过程中根据用户意图优化选择;数量限制按当前创意定义执行。
2.4.1.2.8landingPage用户点击广告或卡片后到达的页面object—Required用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
2.4.1.2.8.1landingPageTypeSTORE 表示品牌旗舰店页面string—RequiredSTORE 表示品牌旗舰店页面。
2.4.1.2.8.2landingPageUrl点击广告后到达的页面地址string—Required点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
2.4.1.3manualCollectionSettings由广告主指定商品的商品集object—Optional由广告主指定商品的商品集,包含选入商品、通用配置及落地页。
2.4.1.3.1landingPage用户点击广告或卡片后到达的页面object—Required用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
2.4.1.3.1.1landingPageTypelandingPageTypestring—RequiredASIN_LIST=以广告推广商品生成的商品列表页 STORE=品牌旗舰店页面。
2.4.1.3.1.2landingPageUrl点击广告后到达的页面地址string—Optional点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
2.4.1.3.2productInclusions手动商品集展示的商品array<object>—Required手动商品集展示的商品,须包含 3~10 项。 最少1项
2.4.1.3.2.1productId推广商品的亚马逊标准商品标识string—Optional推广商品的亚马逊标准商品标识。本地服务要求填写非空字符串。
2.4.1.3.2.2productIdTypeASIN 表示亚马逊标准商品标识string—RequiredASIN 表示亚马逊标准商品标识。
2.4.1.3.3sharedSettings不同商品集类型共享的品牌配置object—Required不同商品集类型共享的品牌配置;官方定义中的品牌标志字段为单个素材对象。
2.4.1.3.3.1brand广告中展示和推广的品牌名称string—Required广告中展示和推广的品牌名称。
2.4.1.3.3.2brandLogos商品集通用配置的品牌标志图片object—Optional商品集通用配置的品牌标志图片,官方定义为单个素材对象。
2.4.1.3.3.2.1assetId素材库中图片或视频素材的唯一标识string—Required素材库中图片或视频素材的唯一标识。
2.4.1.3.3.2.2assetVersion素材库中该图片或视频对应的版本标识string—Required素材库中该图片或视频对应的版本标识。
2.4.1.3.3.2.3formatProperties素材裁剪和定位的属性列表array<object>—Optional素材裁剪和定位的属性列表,最多 10 项。
2.4.1.3.3.2.3.1height裁剪后图片的高度integer—Optional裁剪后图片的高度,单位为像素。
2.4.1.3.3.2.3.2left从原图左边缘到裁剪起点的距离integer—Optional从原图左边缘到裁剪起点的距离,单位为像素。
2.4.1.3.3.2.3.3top从原图上边缘到裁剪起点的距离integer—Optional从原图上边缘到裁剪起点的距离,单位为像素。
2.4.1.3.3.2.3.4width裁剪后图片的宽度integer—Optional裁剪后图片的宽度,单位为像素。
2.4.1.3.4title手动商品集的可选标题string—Optional手动商品集的可选标题;未提供时可自动生成。
2.4.1.4productCollectionSettings包含多个商品及自定义图片的品牌推广创意object—Optional包含多个商品及自定义图片的品牌推广创意。
2.4.1.4.1brand广告中展示和推广的品牌名称string—Required广告中展示和推广的品牌名称。
2.4.1.4.2brandLogos广告使用的品牌标志图片素材array<object>—Required广告使用的品牌标志图片素材;各创意类型的数组数量限制或对象结构以当前字段定义为准。 最少1项
2.4.1.4.2.1assetId素材库中图片或视频素材的唯一标识string—Required素材库中图片或视频素材的唯一标识。
2.4.1.4.2.2assetVersion素材库中该图片或视频对应的版本标识string—Required素材库中该图片或视频对应的版本标识。
2.4.1.4.2.3formatProperties素材裁剪和定位的属性列表array<object>—Optional素材裁剪和定位的属性列表,最多 10 项。
2.4.1.4.2.3.1height裁剪后图片的高度integer—Optional裁剪后图片的高度,单位为像素。
2.4.1.4.2.3.2left从原图左边缘到裁剪起点的距离integer—Optional从原图左边缘到裁剪起点的距离,单位为像素。
2.4.1.4.2.3.3top从原图上边缘到裁剪起点的距离integer—Optional从原图上边缘到裁剪起点的距离,单位为像素。
2.4.1.4.2.3.4width裁剪后图片的宽度integer—Optional裁剪后图片的宽度,单位为像素。
2.4.1.4.3creativePropertiesToOptimizecreativePropertiesToOptimizearray<any>—Optional允许亚马逊根据受众、广告位等因素增强或生成的创意属性。
2.4.1.4.4customImages广告展示的自定义图片素材array<object>—Required广告展示的自定义图片素材;数量限制按当前创意类型的定义执行。 最少1项
2.4.1.4.4.1assetId素材库中图片或视频素材的唯一标识string—Required素材库中图片或视频素材的唯一标识。
2.4.1.4.4.2assetVersion素材库中该图片或视频对应的版本标识string—Required素材库中该图片或视频对应的版本标识。
2.4.1.4.4.3formatProperties素材裁剪和定位的属性列表array<object>—Optional素材裁剪和定位的属性列表,最多 10 项。
2.4.1.4.4.3.1height裁剪后图片的高度integer—Optional裁剪后图片的高度,单位为像素。
2.4.1.4.4.3.2left从原图左边缘到裁剪起点的距离integer—Optional从原图左边缘到裁剪起点的距离,单位为像素。
2.4.1.4.4.3.3top从原图上边缘到裁剪起点的距离integer—Optional从原图上边缘到裁剪起点的距离,单位为像素。
2.4.1.4.4.3.4width裁剪后图片的宽度integer—Optional裁剪后图片的宽度,单位为像素。
2.4.1.4.5enableCreativeAutoTranslationtrue=当标题或视频语言与站点默认语言不一致时boolean—Optionaltrue=当标题或视频语言与站点默认语言不一致时,允许亚马逊尝试翻译;无法完成翻译可能导致审核拒绝。false=不启用。
2.4.1.4.6headlines广告主提交的创意标题array<any>—Required广告主提交的创意标题,亚马逊可在投放过程中根据用户意图优化选择;数量限制按当前创意定义执行。 最少1项
2.4.1.4.7landingPage用户点击广告或卡片后到达的页面object—Required用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
2.4.1.4.7.1landingPageAsins落地页为 ASIN_LIST 商品列表页时object—Optional落地页为 ASIN_LIST 商品列表页时,用于生成该页面的商品标识列表。
2.4.1.4.7.1.1asins用于生成商品列表落地页的亚马逊商品标识array<any>—Required用于生成商品列表落地页的亚马逊商品标识,包含 1~100 项。 最少1项
2.4.1.4.7.2landingPageTypeASIN_LIST=根据推广商品生成的商品列表页string—RequiredASIN_LIST=根据推广商品生成的商品列表页 CUSTOM_URL=自定义落地页,仅供应商账户可用 STORE=品牌旗舰店页面。
2.4.1.4.7.3landingPageUrl点击广告后到达的页面地址string—Optional点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
2.4.1.4.8products创意中展示的商品array<object>—Optional创意中展示的商品;具体为商品数组或单个商品对象,以当前创意字段的官方结构为准。
2.4.1.4.8.1productId推广商品的亚马逊标准商品标识string—Optional推广商品的亚马逊标准商品标识。本地服务要求填写非空字符串。
2.4.1.4.8.2productIdTypeASIN 表示亚马逊标准商品标识string—RequiredASIN 表示亚马逊标准商品标识。
2.4.1.5productVideoSettings包含视频素材的品牌推广广告创意object—Optional包含视频素材的品牌推广广告创意。
2.4.1.5.1brand广告中展示和推广的品牌名称string—Optional广告中展示和推广的品牌名称。
2.4.1.5.2brandLogos广告使用的品牌标志图片素材array<object>—Optional广告使用的品牌标志图片素材;各创意类型的数组数量限制或对象结构以当前字段定义为准。
2.4.1.5.2.1assetId素材库中图片或视频素材的唯一标识string—Required素材库中图片或视频素材的唯一标识。
2.4.1.5.2.2assetVersion素材库中该图片或视频对应的版本标识string—Required素材库中该图片或视频对应的版本标识。
2.4.1.5.2.3formatProperties素材裁剪和定位的属性列表array<object>—Optional素材裁剪和定位的属性列表,最多 10 项。
2.4.1.5.2.3.1height裁剪后图片的高度integer—Optional裁剪后图片的高度,单位为像素。
2.4.1.5.2.3.2left从原图左边缘到裁剪起点的距离integer—Optional从原图左边缘到裁剪起点的距离,单位为像素。
2.4.1.5.2.3.3top从原图上边缘到裁剪起点的距离integer—Optional从原图上边缘到裁剪起点的距离,单位为像素。
2.4.1.5.2.3.4width裁剪后图片的宽度integer—Optional裁剪后图片的宽度,单位为像素。
2.4.1.5.3enableCreativeAutoTranslationtrue=当标题或视频语言与站点默认语言不一致时boolean—Optionaltrue=当标题或视频语言与站点默认语言不一致时,允许亚马逊尝试翻译;无法完成翻译可能导致审核拒绝。false=不启用。
2.4.1.5.4headlines广告主提交的创意标题array<any>—Optional广告主提交的创意标题,亚马逊可在投放过程中根据用户意图优化选择;数量限制按当前创意定义执行。
2.4.1.5.5landingPage用户点击广告或卡片后到达的页面object—Optional用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
2.4.1.5.5.1landingPageTypeDETAIL_PAGE=商品详情页string—RequiredDETAIL_PAGE=商品详情页 STORE=品牌旗舰店页面。
2.4.1.5.5.2landingPageUrl点击广告后到达的页面地址string—Optional点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
2.4.1.5.6products创意中展示的商品array<object>—Optional创意中展示的商品;具体为商品数组或单个商品对象,以当前创意字段的官方结构为准。
2.4.1.5.6.1productId推广商品的亚马逊标准商品标识string—Optional推广商品的亚马逊标准商品标识。本地服务要求填写非空字符串。
2.4.1.5.6.2productIdTypeASIN 表示亚马逊标准商品标识string—RequiredASIN 表示亚马逊标准商品标识。
2.4.1.5.7videos广告使用的视频素材array<object>—Required广告使用的视频素材,须且仅包含一项。 最少1项
2.4.1.5.7.1assetId素材库中图片或视频素材的唯一标识string—Required素材库中图片或视频素材的唯一标识。
2.4.1.5.7.2assetVersion素材库中该图片或视频对应的版本标识string—Required素材库中该图片或视频对应的版本标识。
2.4.1.6storeSpotlightSettings通过卡片展示品牌旗舰店中的商品和页面object—Optional通过卡片展示品牌旗舰店中的商品和页面。
2.4.1.6.1brand广告中展示和推广的品牌名称string—Required广告中展示和推广的品牌名称。
2.4.1.6.2brandLogos广告使用的品牌标志图片素材array<object>—Required广告使用的品牌标志图片素材;各创意类型的数组数量限制或对象结构以当前字段定义为准。 最少1项
2.4.1.6.2.1assetId素材库中图片或视频素材的唯一标识string—Required素材库中图片或视频素材的唯一标识。
2.4.1.6.2.2assetVersion素材库中该图片或视频对应的版本标识string—Required素材库中该图片或视频对应的版本标识。
2.4.1.6.2.3formatProperties素材裁剪和定位的属性列表array<object>—Optional素材裁剪和定位的属性列表,最多 10 项。
2.4.1.6.2.3.1height裁剪后图片的高度integer—Optional裁剪后图片的高度,单位为像素。
2.4.1.6.2.3.2left从原图左边缘到裁剪起点的距离integer—Optional从原图左边缘到裁剪起点的距离,单位为像素。
2.4.1.6.2.3.3top从原图上边缘到裁剪起点的距离integer—Optional从原图上边缘到裁剪起点的距离,单位为像素。
2.4.1.6.2.3.4width裁剪后图片的宽度integer—Optional裁剪后图片的宽度,单位为像素。
2.4.1.6.3cards创意中的卡片子元素array<object>—Required创意中的卡片子元素;各创意类型对应的卡片数量及字段要求以当前定义为准。 最少1项
2.4.1.6.3.1headline当前创意卡片展示的标题文本string—Required当前创意卡片展示的标题文本。
2.4.1.6.3.2landingPage用户点击广告或卡片后到达的页面object—Required用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
2.4.1.6.3.2.1landingPageTypeSTORE 表示品牌旗舰店页面string—RequiredSTORE 表示品牌旗舰店页面。
2.4.1.6.3.2.2landingPageUrl点击广告后到达的页面地址string—Required点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
2.4.1.6.3.3products当前品牌旗舰店聚焦卡片关联的商品object—Required当前品牌旗舰店聚焦卡片关联的商品,官方定义为单个商品对象。
2.4.1.6.3.3.1productId推广商品的亚马逊标准商品标识string—Optional推广商品的亚马逊标准商品标识。本地服务要求填写非空字符串。
2.4.1.6.3.3.2productIdTypeASIN 表示亚马逊标准商品标识string—RequiredASIN 表示亚马逊标准商品标识。
2.4.1.6.4creativePropertiesToOptimizecreativePropertiesToOptimizearray<any>—Optional允许亚马逊根据受众、广告位等因素增强或生成的创意属性。
2.4.1.6.5enableCreativeAutoTranslationtrue=当标题或视频语言与站点默认语言不一致时boolean—Optionaltrue=当标题或视频语言与站点默认语言不一致时,允许亚马逊尝试翻译;无法完成翻译可能导致审核拒绝。false=不启用。
2.4.1.6.6headlines广告主提交的创意标题array<any>—Required广告主提交的创意标题,亚马逊可在投放过程中根据用户意图优化选择;数量限制按当前创意定义执行。 最少1项
2.4.1.6.7landingPage用户点击广告或卡片后到达的页面object—Required用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
2.4.1.6.7.1landingPageTypeSTORE 表示品牌旗舰店页面string—RequiredSTORE 表示品牌旗舰店页面。
2.4.1.6.7.2landingPageUrl点击广告后到达的页面地址string—Required点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
2.5name用于识别和管理广告的名称string—Required用于识别和管理广告的名称。
2.6stateENABLED=已启用string—RequiredENABLED=已启用 PAUSED=已暂停。已启用仍需满足创意审核、父级状态等投放条件。

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每项结果通过原始下标对应请求中的广告array<object>—Required每项结果通过原始下标对应请求中的广告;应检查每项结果码,批量或工具调用可能包含失败项。
6.1.1adGroupId广告所属广告组的唯一标识string—Required广告所属广告组的唯一标识,必须属于当前授权广告店铺;使用数字字符串,当前服务要求正整数值。
6.1.2adId亚马逊创建成功后生成的广告唯一标识string—Required亚马逊创建成功后生成的广告唯一标识;以字符串保存,避免长整数精度丢失。
6.1.3adProductadProductstring—RequiredSPONSORED_BRANDS 表示品牌推广广告。
6.1.4adTypeadTypestring—RequiredCOMPONENT 表示由视频、图片及商品等组件构成的创意广告。
6.1.5campaignId广告所属活动的唯一标识string—Required广告所属活动的唯一标识,为只读返回字段。
6.1.6creationDateTime广告创建时间string—Required广告创建时间,采用带时区的日期时间格式。示例中的 -07:00 表示当地时间为协调世界时减 7 小时。
6.1.7creative创意类型包装对象object—Required创意类型包装对象;品牌推广使用组件式创意。
6.1.7.1componentCreative包含具体的创意配置object—Required包含具体的创意配置。当前外部服务要求每条广告恰好指定一种创意配置。
6.1.7.1.1productCollectionSettings包含多个商品及自定义图片的品牌推广创意object—Required包含多个商品及自定义图片的品牌推广创意。
6.1.7.1.1.1brand广告中展示和推广的品牌名称string—Required广告中展示和推广的品牌名称。
6.1.7.1.1.2brandLogos广告使用的品牌标志图片素材array<object>—Required广告使用的品牌标志图片素材;各创意类型的数组数量限制或对象结构以当前字段定义为准。
6.1.7.1.1.2.1assetId素材库中图片或视频素材的唯一标识string—Required素材库中图片或视频素材的唯一标识。
6.1.7.1.1.2.2assetVersion素材库中该图片或视频对应的版本标识string—Required素材库中该图片或视频对应的版本标识。
6.1.7.1.1.2.3formatProperties本次实际返回为含 null 元素的数组array<object>—Required本次实际返回为含 null 元素的数组;响应兼容空元素,请求侧仍采用官方对象数组。
6.1.7.1.1.2.3.1height裁剪后图片的高度integer—Required裁剪后图片的高度,单位为像素。
6.1.7.1.1.2.3.2left从原图左边缘到裁剪起点的距离integer—Required从原图左边缘到裁剪起点的距离,单位为像素。
6.1.7.1.1.2.3.3top从原图上边缘到裁剪起点的距离integer—Required从原图上边缘到裁剪起点的距离,单位为像素。
6.1.7.1.1.2.3.4width裁剪后图片的宽度integer—Required裁剪后图片的宽度,单位为像素。
6.1.7.1.1.3customImages广告展示的自定义图片素材array<object>—Required广告展示的自定义图片素材;数量限制按当前创意类型的定义执行。
6.1.7.1.1.3.1assetId素材库中图片或视频素材的唯一标识string—Required素材库中图片或视频素材的唯一标识。
6.1.7.1.1.3.2assetVersion素材库中该图片或视频对应的版本标识string—Required素材库中该图片或视频对应的版本标识。
6.1.7.1.1.3.3formatProperties本次实际返回为含 null 元素的数组array<object>—Required本次实际返回为含 null 元素的数组;响应兼容空元素,请求侧仍采用官方对象数组。
6.1.7.1.1.3.3.1height裁剪后图片的高度integer—Required裁剪后图片的高度,单位为像素。
6.1.7.1.1.3.3.2left从原图左边缘到裁剪起点的距离integer—Required从原图左边缘到裁剪起点的距离,单位为像素。
6.1.7.1.1.3.3.3top从原图上边缘到裁剪起点的距离integer—Required从原图上边缘到裁剪起点的距离,单位为像素。
6.1.7.1.1.3.3.4width裁剪后图片的宽度integer—Required裁剪后图片的宽度,单位为像素。
6.1.7.1.1.4headlines广告主提交的创意标题array<any>—Required广告主提交的创意标题,亚马逊可在投放过程中根据用户意图优化选择;数量限制按当前创意定义执行。
6.1.7.1.1.5landingPage用户点击广告或卡片后到达的页面object—Required用户点击广告或卡片后到达的页面;各创意支持的页面类型和必填项以对应定义为准。
6.1.7.1.1.5.1landingPageTypeASIN_LIST=根据推广商品生成的商品列表页string—RequiredASIN_LIST=根据推广商品生成的商品列表页 CUSTOM_URL=自定义落地页,仅供应商账户可用 STORE=品牌旗舰店页面。
6.1.7.1.1.5.2landingPageUrl点击广告后到达的页面地址string—Required点击广告后到达的页面地址。商品集合落地页为 ASIN_LIST 商品列表页时,此地址为只读字段。
6.1.7.1.1.6moderationStatus广告创意的审核状态信息object—Required广告创意的审核状态信息。
6.1.7.1.1.6.1moderationStatusmoderationStatusstring—RequiredAPPROVED_WITH_EXCEPTIONS=部分流量审核通过,仅在获准流量投放 PENDING_TRANSLATION=等待创意翻译 PUBLISHED=已通过审核并发布投放 REJECTED_BY_MODERATION=审核拒绝 SUBMITTED_FOR_MODERATION=已提交审核,尚未完成审核。
6.1.7.1.1.7products创意中展示的商品array<object>—Required创意中展示的商品;具体为商品数组或单个商品对象,以当前创意字段的官方结构为准。
6.1.7.1.1.7.1productId推广商品的亚马逊标准商品标识string—Required推广商品的亚马逊标准商品标识。本地服务要求填写非空字符串。
6.1.7.1.1.7.2productIdTypeASIN 表示亚马逊标准商品标识string—RequiredASIN 表示亚马逊标准商品标识。
6.1.7.1.1.8untranslatedHeadlines广告主原始输入、未经过翻译的标题array<any>—Required广告主原始输入、未经过翻译的标题。
6.1.8lastUpdatedDateTime广告最后更新时间string—Required广告最后更新时间,采用带时区的日期时间格式;保留接口返回的时区偏移,不改写为本地时间。
6.1.9marketplaceScopemarketplaceScopestring—RequiredSINGLE_MARKETPLACE 表示单站点广告。
6.1.10marketplaces广告对应的亚马逊零售站点代码列表array<any>—Required广告对应的亚马逊零售站点代码列表,范围应与所属广告组相同或为其子集 US 表示美国站。
6.1.11name用于识别和管理广告的名称string—Required用于识别和管理广告的名称。
6.1.12stateENABLED=已启用string—RequiredENABLED=已启用 PAUSED=已暂停 ARCHIVED=已永久归档且不可重新启用。
6.1.13codeSUCCESS 表示当前广告创建成功stringSUCCESSRequiredSUCCESS 表示当前广告创建成功。
6.1.14index对应请求广告数组中的原始下标integer—Required对应请求广告数组中的原始下标,从 0 开始。
7total统一响应中的总数integer0Required统一响应中的总数,本创建接口未设置分页总数,默认为0

The 创建 SB 广告 API (/basicOpen/adReport/manage/postSbAds) 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.