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 · 请求参数 18 个(必填 15) · 响应参数 30 个 · 限流令牌桶容量 1
Updated At
2026-11-21

创建 SD 广告活动

POST/basicOpen/adReport/manage/postSdCampaign
Factory
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/adReport/manage/postSdCampaign"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/postSdCampaign?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"profileId\": \"1234567890123456\",\n    \"campaigns\": [\n        {\n            \"adProduct\": \"SPONSORED_DISPLAY\",\n            \"budgets\": [\n                {\n                    \"budgetType\": \"MONETARY\",\n                    \"budgetValue\": {\n                        \"monetaryBudgetValue\": {\n                            \"monetaryBudget\": {\n                                \"value\": 1\n                            }\n                        }\n                    }\n                }\n            ],\n            \"costType\": \"CPC\",\n            \"marketplaceScope\": \"SINGLE_MARKETPLACE\",\n            \"name\": \"示例广告\",\n            \"startDateTime\": \"2026-10-20T00:00:00Z\",\n            \"state\": \"PAUSED\",\n            \"marketplaces\": [\n                \"US\"\n            ]\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": [
        {
          "adProduct": "SPONSORED_DISPLAY",
          "budgets": [
            {
              "budgetType": "MONETARY",
              "budgetValue": {
                "monetaryBudgetValue": {
                  "monetaryBudget": {
                    "currencyCode": "USD",
                    "value": 1
                  }
                }
              },
              "recurrenceTimePeriod": "DAILY"
            }
          ],
          "campaignId": "1234567890123456",
          "costType": "CPC",
          "countries": [
            "US"
          ],
          "creationDateTime": "2026-10-20T00:00:00Z",
          "endDateTime": "2026-10-20T00:00:00Z",
          "lastUpdatedDateTime": "2026-10-20T00:00:00Z",
          "marketplaceScope": "SINGLE_MARKETPLACE",
          "marketplaces": [
            "US"
          ],
          "name": "示例广告",
          "startDateTime": "2026-10-20T00:00:00Z",
          "state": "PAUSED",
          "code": "SUCCESS",
          "index": 0
        }
      ]
    },
    "total": 0
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1profileId必须属于当前授权企业的广告店铺唯一标识string—Required必须属于当前授权企业的广告店铺唯一标识;使用数字字符串传递,避免长整数精度丢失。本文件记录用户提供的广告店铺标识方式。
2campaigns待创建的展示型推广活动列表array<object>—Required待创建的展示型推广活动列表;每次提交 1~100 个活动。 最少1项 最多100项
2.1adProductadProductstring—RequiredSPONSORED_DISPLAY 表示展示型推广广告。
2.2budgets活动的货币预算列表array<object>—Required活动的货币预算列表,须且仅包含一项预算。创建时传预算类型和预算值,响应中另有预算周期。 最少1项
2.2.1budgetTypeMONETARY 表示货币金额预算string—RequiredMONETARY 表示货币金额预算。
2.2.2budgetValue货币预算值的类型包装对象object—Required货币预算值的类型包装对象。
2.2.2.1monetaryBudgetValue货币预算金额的包装对象object—Required货币预算金额的包装对象。
2.2.2.1.1monetaryBudget以广告店铺对应币种计价的预算金额object—Required以广告店铺对应币种计价的预算金额;创建时不传币种字段。
2.2.2.1.1.1value以广告店铺对应币种计价的预算金额number—Required以广告店铺对应币种计价的预算金额。结合本次响应的美元币种及每日周期,示例表示每日预算为 2 美元。
2.3costTypeCPC=按点击计费string—RequiredCPC=按点击计费 VCPM=按千次可见展示计费。
2.4countries活动投放范围的国家代码列表array<any>—Optional活动投放范围的国家代码列表,最多一个国家 US 表示美国。
2.5endDateTime广告活动结束时间string—Optional广告活动结束时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。当前外部接口要求不早于开始时间。
2.6marketplaceScopemarketplaceScopestring—RequiredSINGLE_MARKETPLACE 表示单站点广告活动。
2.7marketplaces活动投放的亚马逊零售站点代码列表array<any>—Required活动投放的亚马逊零售站点代码列表,须匹配广告店铺的授权站点 US 表示美国站。 最少1项
2.8name用于识别和管理广告活动的名称string—Required用于识别和管理广告活动的名称。
2.9portfolioId活动所属广告组合的唯一标识string—Optional活动所属广告组合的唯一标识,可不传或传空字符串;有值时须为正整数字符串。
2.10startDateTime活动计划开始投放的时间string—Required活动计划开始投放的时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。实际创建时应使用符合亚马逊要求的开始日期。
2.11stateENABLED=已启用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.1adProductadProductstring—RequiredSPONSORED_DISPLAY 表示展示型推广广告。
6.1.2budgets活动的货币预算列表array<object>—Required活动的货币预算列表,须且仅包含一项预算。创建时传预算类型和预算值,响应中另有预算周期。
6.1.2.1budgetTypeMONETARY 表示货币金额预算string—RequiredMONETARY 表示货币金额预算。
6.1.2.2budgetValue货币预算值的类型包装对象object—Required货币预算值的类型包装对象。
6.1.2.2.1monetaryBudgetValue货币预算金额的包装对象object—Required货币预算金额的包装对象。
6.1.2.2.1.1monetaryBudget响应中的预算金额及其币种object—Required响应中的预算金额及其币种。
6.1.2.2.1.1.1currencyCodeAED=阿联酋迪拉姆string—RequiredAED=阿联酋迪拉姆 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.2.2.1.1.2value以广告店铺对应币种计价的预算金额number—Required以广告店铺对应币种计价的预算金额。结合本次响应的美元币种及每日周期,示例表示每日预算为 2 美元。
6.1.2.3recurrenceTimePeriodDAILY 表示每日预算string—RequiredDAILY 表示每日预算;该字段出现在展示型推广活动的预算响应中,官方创建预算对象未定义此字段。
6.1.3campaignId亚马逊创建成功后生成的活动唯一标识string—Required亚马逊创建成功后生成的活动唯一标识;以字符串保存,避免长整数精度丢失。
6.1.4costTypeCPC=按点击计费string—RequiredCPC=按点击计费 VCPM=按千次可见展示计费。
6.1.5countries活动投放范围的国家代码列表array<any>—Required活动投放范围的国家代码列表,最多一个国家 US 表示美国。
6.1.6creationDateTime亚马逊记录的活动创建时间string—Required亚马逊记录的活动创建时间;末尾 Z 表示协调世界时。
6.1.7endDateTime广告活动结束时间string—Required广告活动结束时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。当前外部接口要求不早于开始时间。
6.1.8lastUpdatedDateTime亚马逊记录的活动最后更新时间string—Required亚马逊记录的活动最后更新时间;末尾 Z 表示协调世界时。
6.1.9marketplaceScopemarketplaceScopestring—RequiredSINGLE_MARKETPLACE 表示单站点广告活动。
6.1.10marketplaces活动投放的亚马逊零售站点代码列表array<any>—Required活动投放的亚马逊零售站点代码列表,须匹配广告店铺的授权站点 US 表示美国站。
6.1.11name用于识别和管理广告活动的名称string—Required用于识别和管理广告活动的名称。
6.1.12startDateTime活动计划开始投放的时间string—Required活动计划开始投放的时间,采用带时区的日期时间格式;末尾 Z 表示协调世界时。实际创建时应使用符合亚马逊要求的开始日期。
6.1.13stateENABLED=已启用string—RequiredENABLED=已启用 PAUSED=已暂停 ARCHIVED=已永久归档且不可重新启用。
6.1.14codeSUCCESS 表示当前广告活动创建成功stringSUCCESSRequiredSUCCESS 表示当前广告活动创建成功。
6.1.15index对应请求活动数组中的原始下标integer—Required对应请求活动数组中的原始下标,从 0 开始。
7total统一响应中的总数integer0Required统一响应中的总数,本创建接口未设置分页总数,默认为0

The 创建 SD 广告活动 API (/basicOpen/adReport/manage/postSdCampaign) 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.