轻易云
注册体验

领星ERP修改SP广告活动和广告位接口

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

修改SP广告活动和广告位

POST/basicOpen/adReport/manage/putSpCampaign
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/adReport/manage/putSpCampaign"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/putSpCampaign?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"sid\": 9090,\n    \"campaigns\": [\n        {\n            \"campaignId\": 414070570476640,\n            \"isBaseValue\": 0,\n            \"isBasePlacementAll\": 1,\n            \"dynamicBidding\": {\n                \"strategy\": \"LEGACY_FOR_SALES\",\n                \"placementBidding\": [\n                    {\n                        \"placement\": \"PLACEMENT_PRODUCT_PAGE\",\n                        \"percentage\": 38\n                    },\n                    {\n                        \"placement\": \"PLACEMENT_TOP\",\n                        \"percentage\": 25\n                    },\n                    {\n                        \"placement\": \"PLACEMENT_REST_OF_SEARCH\",\n                        \"percentage\": 15\n                    },\n                    {\n                        \"placement\": \"SITE_AMAZON_BUSINESS\",\n                        \"percentage\": 10\n                    }\n                ]\n            }\n        }\n    ]\n}'",
  "responseExample": {
    "code": 1,
    "success": true,
    "data": {
      "apiResult": [
        {
          "code": "SUCCESS",
          "campaignId": "468467189609276"
        },
        {
          "code": "SUCCESS",
          "campaignId": "67532229161080"
        },
        {
          "code": "SUCCESS",
          "campaignId": "393233412099415"
        },
        {
          "code": "entityStateError",
          "description": "Archived entity cannot be modified"
        }
      ]
    },
    "message": "success",
    "request_id": "ed914dcf_fe5a_4ec3_8e92_c72f1dd95081",
    "response_time": "2025-05-21 00:00:00"
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1sidsid 和 profileId 必传一个number—必填sid 和 profileId 必传一个
2profileIdsid 和 profileId 必传一个integer—可选sid 和 profileId 必传一个
3campaigns广告活动列表array<object>—必填广告活动列表
3.1campaignId广告活动idnumber—必填广告活动id
3.2state有效状态string—可选有效状态:enabled-启用 paused-暂停
3.3budget预算对象object—可选预算对象
3.3.1budgetType预算类型 固定传dailystring—可选预算类型 固定传daily
3.3.2budget预算金额number—可选预算金额
3.4isBaseValue是否调整基准值number—必填是否调整基准值:1-是 0-否
3.5baseType调整基准值类型string—可选调整基准值类型:1-固定值 2-系统反推
3.6baseValue固定值时传 基准值string—可选固定值时传 基准值
3.7isBasePlacementAll是否同步更新分时策略广告位基准值number—可选是否同步更新分时策略广告位基准值:1-是 0或不传-不调整
3.8dynamicBidding广告位竞价配置object—可选广告位竞价配置
3.8.1strategy竞价策略string—可选竞价策略:AUTO_FOR_SALES-动态竞价-提高和降低 LEGACY_FOR_SALES-动态竞价-只降低 MANUAL-固定竞价
3.8.2placementBidding广告位相关参数array<object>—可选广告位相关参数
3.8.2.1placement广告位string—可选广告位:PLACEMENT_PRODUCT_PAGE-商品页面 PLACEMENT_TOP-搜索结果顶部(首页) PLACEMENT_REST_OF_SEARCH-搜索结果的其余位置 SITE_AMAZON_BUSINESS-亚马逊企业购
3.8.2.2percentage广告位百分比number—可选广告位百分比

接口响应参数

序号字段名称类型默认值必填描述
1codecodenumber1必填
2successsuccessbooleantrue必填
3datadataobject—必填
3.1apiResultapiResultarray<object>详见返回成功示例必填
3.1.1codeSUCCESS 成功 其他为失败stringSUCCESS必填SUCCESS 成功 其他为失败
3.1.2campaignId成功时返回 广告活动idstring468467189609276可选成功时返回 广告活动id
3.1.3description不成功时返回错误的原因string—可选不成功时返回错误的原因
4messagemessagestringsuccess必填
5request_id链路idstringf0763238_fed4_4f06_ae05_0f864e1c78b2必填链路id
6response_time响应时间string—必填响应时间
7error_details错误信息array<any>—必填错误信息

领星ERP的接口:修改SP广告活动和广告位(/basicOpen/adReport/manage/putSpCampaign),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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