Lingxing
切换旧版

调整sp关键词

POSTbasicOpen/adReport/manage/putSpKeyword

接口信息

API Path请求协议请求方式[令牌桶容量]()
basicOpen/adReport/manage/putSpKeywordHTTPSPOST1

请求参数

sidinteger
sid 和 profileId 必传一个
profileIdinteger
sid 和 profileId 必传一个
keywordsarray<object>必填
state 和 bid 这两项不能同时为空，单次最多 1000 个关键词。
隐藏子属性
keywordIdinteger必填
关键词id
对应【基础数据-SP关键词】接口中的keyword_id
statestring
有效状态
enabled 启用
paused 暂停
bidnumber
关键词竞价
isBaseValueinteger必填
是否调整基准值
1 是
0 否
baseTypeinteger
调整基准值类型
1 固定值
2 系统反推
baseValuenumber
根据调整基准值的类型进行选填
固定值时填写基准值的实际数值
系统反推时不需要填写

请求示例

{
    "sid": 9100,
    "profileId": 0,
    "keywords": [{
        "keywordId": 468467189609276,
        "state": "paused",
        "bid": "",
        "isBaseValue": 0,
        "baseType": "",
        "baseValue": ""
    }]
}

返回结果

Json Object

sidinteger
sid 和 profileId 必传一个
示例 9100
profileIdinteger
sid 和 profileId 必传一个
keywordsarray<object>必填
竞价状态不能同时为空
示例 详见返回成功示例
隐藏子属性
keywordIdnumber必填
关键词id
示例 468467189609276
statestring
有效状态 enabled 启用 paused 暂停
示例 paused
bidnumber
关键词竞价
isBaseValuenumber必填
是否调整基准值 1 是 0 否
示例 0
baseTypestring
调整基准值类型 1 固定值 2 系统反推
baseValuestring
固定值时传 基准值

返回成功示例

{
    "code": 1,
    "success": true,
    "data": {
        "apiResult": [
            {
                "code": "SUCCESS",
                "keywordId": "559289149470898"
            },
            {
                "code": "entityStateError",
                "description": "Archived entity cannot be modified"
            },
            {
                "code": "SUCCESS",
                "keywordId": "281503475949886"
            },
            {
                "code": "SUCCESS",
                "keywordId": "551331287749326"
            }
        ]
    },
    "message": "success",
    "request_id": "ed914dcf_fe5a_4ec3_8e92_c72f1dd95081",
    "response_time":"2025-05-21 00:00:00"
}

返回失败示例

{
    "success": false,
    "data": [],
    "message": "程序内部错误",
    "error_details":["参数错误：只支持seller账号，不支持vendor账号【reqId】:aa163c0f_e16d_43f5_835c_1214d83cbd94"],
    "code": 0,
    "request_id": "aa163c0f_e16d_43f5_835c_1214d83cbd94"
    "response_time":"2025-05-21 00:00:00"
}