Qeasy Cloud
Get Started

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

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

修改SP广告活动和广告位

POST/basicOpen/adReport/manage/putSpCampaign
Factory
{
  "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"
  }
}

Request Parameters

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

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1codecodenumber1Required
2successsuccessbooleantrueRequired
3datadataobject—Required
3.1apiResultapiResultarray<object>详见返回成功示例Required
3.1.1codeSUCCESS 成功 其他为失败stringSUCCESSRequiredSUCCESS 成功 其他为失败
3.1.2campaignId成功时返回 广告活动idstring468467189609276Optional成功时返回 广告活动id
3.1.3description不成功时返回错误的原因string—Optional不成功时返回错误的原因
4messagemessagestringsuccessRequired
5request_id链路idstringf0763238_fed4_4f06_ae05_0f864e1c78b2Required链路id
6response_time响应时间string—Required响应时间
7error_details错误信息array<any>—Required错误信息

The 修改SP广告活动和广告位 API (/basicOpen/adReport/manage/putSpCampaign) 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.