轻易云
注册体验

领星ERPSP广告添加否定关键词接口

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

SP广告添加否定关键词

POST/basicOpen/adReport/spTarget/addNegativeKeywords
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/adReport/spTarget/addNegativeKeywords"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/adReport/spTarget/addNegativeKeywords?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"sid\": 134225003201380864,\n    \"negativeKeywords\": [\n        {\n            \"campaignId\": \"12345\",\n            \"adGroupId\": \"67890\",\n            \"keyword\": \"example keyword\",\n            \"matchType\": \"negativeExact\",\n            \"state\": \"ENABLED\"\n        }\n    ]\n}'",
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-04-20 12:00:00",
    "data": {
      "success": [
        {
          "index": 0,
          "target": {
            "targetId": "12345",
            "campaignId": "67890",
            "adGroupId": "11111",
            "state": "ENABLED",
            "targetType": "KEYWORD",
            "targetLevel": "AD_GROUP"
          }
        }
      ],
      "error": []
    }
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1profileId店铺 Profile IDinteger—可选店铺 Profile ID,profileId和sid不能同时为空
2sid店铺idinteger—可选店铺id,profileId和sid不能同时为空
3negativeKeywords否定关键词列表(最多1000个)array<object>—必填否定关键词列表(最多1000个)
3.1campaignIdSP广告活动IDstring—必填SP广告活动ID 对应【基础数据-SP广告活动】接口中的campaign_id
3.2adGroupId广告组ID(可选string—可选广告组ID(可选,不传则为广告活动层级) 对应【基础数据-SP广告组】接口中的ad_group_id
3.3keyword否定关键词文本string—必填否定关键词文本
3.4matchType否定匹配类型string—必填否定匹配类型 negativeExact: 精确匹配 negativePhrase: 词组匹配
3.5state否定关键词状态string—必填否定关键词状态 ENABLED: 启用 PAUSED: 暂停

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0:成功
2message消息提示stringsuccess必填消息提示
3error_details数据校验失败时的错误详情array<any>—必填数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583必填请求链路id
5response_time响应时间string2026-04-20 12:00:00必填响应时间
6data响应数据object—必填响应数据
6.1success创建成功的列表array<object>—必填创建成功的列表
6.1.1index请求中的索引位置integer0必填请求中的索引位置
6.1.2target创建成功的Target信息object—必填创建成功的Target信息
6.1.2.1targetIdTarget唯一标识string12345必填Target唯一标识
6.1.2.2campaignId广告活动IDstring12345必填广告活动ID
6.1.2.3adGroupId广告组IDstring67890必填广告组ID
6.1.2.4state状态stringENABLED必填状态
6.1.2.5targetType投放类型stringKEYWORD必填投放类型
6.2error创建失败的列表array<object>—必填创建失败的列表
6.2.1index请求中的索引位置integer1必填请求中的索引位置
6.2.2errors错误信息列表array<object>—必填错误信息列表
6.2.2.1code错误码stringINVALID_ARGUMENT必填错误码
6.2.2.2message错误消息stringInvalid keyword必填错误消息

领星ERP的接口:SP广告添加否定关键词(/basicOpen/adReport/spTarget/addNegativeKeywords),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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