轻易云
注册体验

领星ERP创建 SB 广告组接口

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

创建 SB 广告组

POST/basicOpen/adReport/manage/postSbAdGroup
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/adReport/manage/postSbAdGroup"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSbAdGroup?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"profileId\": \"1234567890123456\",\n    \"adGroups\": [\n        {\n            \"adProduct\": \"SPONSORED_BRANDS\",\n            \"campaignId\": \"1234567890123456\",\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",
          "adProduct": "SPONSORED_BRANDS",
          "campaignId": "1234567890123456",
          "creationDateTime": "2026-10-20T00:00:00Z",
          "lastUpdatedDateTime": "2026-10-20T00:00:00Z",
          "marketplaceScope": "SINGLE_MARKETPLACE",
          "marketplaces": [
            "US"
          ],
          "name": "示例广告",
          "state": "PAUSED",
          "bid": {
            "currencyCode": "USD",
            "defaultBid": 1
          },
          "code": "SUCCESS",
          "index": 0
        }
      ]
    },
    "total": 0
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1profileId当前授权企业下的广告店铺唯一标识string—必填当前授权企业下的广告店铺唯一标识;用数字字符串传递,避免长整数精度丢失。本文件记录用户提供的广告店铺标识方式。
2adGroups待创建的品牌推广广告组array<object>—必填待创建的品牌推广广告组,单次提交 1~10 项。 最少1项 最多10项
2.1adProductadProductstring—必填SPONSORED_BRANDS 表示品牌推广广告。
2.2campaignId广告组所属活动的唯一标识string—必填广告组所属活动的唯一标识,须为当前授权店铺下的活动;使用数字字符串传递,当前服务要求正整数值。
2.3name用于识别和管理广告组的名称string—必填用于识别和管理广告组的名称。
2.4stateENABLED=已启用string—必填ENABLED=已启用 PAUSED=已暂停。实际投放还取决于所属活动状态、投放时间等条件。

接口响应参数

序号字段名称类型默认值必填描述
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每项结果通过原始下标对应请求中的广告组array<object>—必填每项结果通过原始下标对应请求中的广告组;应检查每项结果码,批量或工具调用可能包含失败项。
6.1.1adGroupId亚马逊创建成功后生成的广告组唯一标识string—必填亚马逊创建成功后生成的广告组唯一标识,以字符串保存,避免长整数精度丢失。
6.1.2adProductadProductstring—必填SPONSORED_BRANDS 表示品牌推广广告。
6.1.3campaignId广告组所属活动的唯一标识string—必填广告组所属活动的唯一标识,须为当前授权店铺下的活动;使用数字字符串传递,当前服务要求正整数值。
6.1.4creationDateTime亚马逊记录的广告组创建时间string—必填亚马逊记录的广告组创建时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。
6.1.5lastUpdatedDateTime亚马逊记录的广告组最后更新时间string—必填亚马逊记录的广告组最后更新时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。
6.1.6marketplaceScopemarketplaceScopestring—必填SINGLE_MARKETPLACE 表示单站点广告组。
6.1.7marketplaces广告组适用的站点代码列表array<any>—必填广告组适用的站点代码列表,范围应与所属活动相同或为其子集;当前品牌推广仅包含一个站点,US 表示美国站。
6.1.8name用于识别和管理广告组的名称string—必填用于识别和管理广告组的名称。
6.1.9stateENABLED=已启用string—必填ENABLED=已启用 PAUSED=已暂停 ARCHIVED=已永久归档且不可重新启用。
6.1.10bid本次真实响应额外回显的竞价对象object—必填本次真实响应额外回显的竞价对象。当前官方品牌推广广告组创建及返回模型均未定义此对象;这里只描述样本结构,不据此推断可通过本创建接口设置广告组默认竞价,也不推断该值的来源或实际投放作用。
6.1.10.1currencyCodeAED=阿联酋迪拉姆string—必填AED=阿联酋迪拉姆 AUD=澳大利亚元 BRL=巴西雷亚尔 CAD=加拿大元 CHF=瑞士法郎 CNY=人民币 DKK=丹麦克朗 EGP=埃及镑 EUR=欧元 GBP=英镑 INR=印度卢比 JPY=日元 MXN=墨西哥比索 MXP=墨西哥比索 NGN=尼日利亚奈拉 NOK=挪威克朗 NZD=新西兰元 PLN=波兰兹罗提 SAR=沙特里亚尔 SEK=瑞典克朗 SGD=新加坡元 TRY=土耳其里拉 USD=美元 ZAR=南非兰特。
6.1.10.2defaultBid本次响应原样返回的竞价值为 49number—必填本次响应原样返回的竞价值为 49,结合币种字段表示 49 美元。该字段依据真实响应补充,未验证数值来源及实际投放作用;不作为品牌推广广告组创建入参。
6.1.11codeSUCCESS 表示当前广告组创建成功stringSUCCESS必填SUCCESS 表示当前广告组创建成功。
6.1.12index对应请求广告组数组中的原始下标integer—必填对应请求广告组数组中的原始下标,从 0 开始。
7total统一响应中的总数integer0必填统一响应中的总数,本创建接口未设置分页总数,默认为0

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

需要对接这个接口?

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