Lingxing
切换旧版

SP否定投放

POST/pb/openapi/newad/spNegativeTargetsOrKeywords

接口信息

API Path请求协议请求方式令牌桶容量
/pb/openapi/newad/spNegativeTargetsOrKeywordsHTTPSPOST10

请求头

标签必填说明类型示例
X-API-VERSION是【兼容旧版本】不加此头部标签，offset 为分页页码，从1开始；值为 2 时，表示 offset 为分页偏移量，从0开始[int]2

请求参数

sidinteger必填
店铺id ，对应查询亚马逊店铺列表接口对应字段【sid】
profile_idinteger必填
VC广告店铺profile_id，对应查询广告账号列表接口对应字段【profile_id】，sid跟profile_id其中一个必填
campaign_idnumber
广告活动id
target_typestring必填
投放类型：keyword target
offsetinteger
分页偏移量，默认0
lengthinteger
分页长度，默认15
next_tokenstring
分页游标，上次分页结果中的next_token
(第一次分页无需填写，当next_token 和 offset同时存在时以next_token为主

返回结果

Json Object

codeinteger必填
状态码，0 成功
示例 0
messagestring必填
消息
示例 操作成功
error_detailsarray<any>必填
错误信息
request_idstring必填
请求链路id
示例 AA8EA3F5-7996-81F8-8E2F-DE7534EB2AE0
response_timestring必填
响应时间
示例 2023-05-09 17:02:10
totalinteger必填
总数
示例 239
next_tokenstring必填
分页游标，填入下次请求中的next_token
示例 "ODAwMDAwMDAwMDAwMDAyNDE3"
dataarray<object>必填
响应数据
隐藏子属性
campaign_idnumber必填
广告活动id
示例 1640591546
ad_group_idnumber必填
广告组id
示例 1640591547
target_idnumber必填
投放id
示例 9803295247915
profile_idnumber必填
亚马逊店铺数字id
示例 121923590660074
negative_typestring必填
否定类型：
negativeKeyword 否定关键词
negativeAsin 否定ASIN
negativeBrand 否定品牌
示例 negativeKeyword
negative_textstring必填
否定内容：【按类型显示】
否定关键词：显示否定关键词的文本
否定ASIN：显示ASIN码
否定品牌：显示品牌名称
示例 关键词A
negative_match_typestring必填
否定匹配方式：
否定关键词：negativeExact、negativePhrase
否定ASIN和否定品牌：返回空字符串
示例 negativeExact
statestring必填
状态
示例 enabled
creation_datenumber必填
创建时间
示例 1655548464
last_updated_datenumber必填
最后更新时间
示例 1655548467
serving_statusstring必填
服务状态
示例 TARGETING_CLAUSE_STATUS_LIVE

返回成功示例

{
    "code": 0,
    "message": "操作成功",
    "error_details": [],
    "request_id": "SD7EA3F5-7996-81F8-8E2F-DE7534EB2AE1",
    "response_time": "2023-05-08 12:02:10",
    "total": 1,
    "next_token": "ODAwMDAwMDAwMDAwMDAyNDE3",
    "data": [
        {
            "campaign_id": 83080499191276,
            "ad_group_id": 214029880198148,
            "target_id": 9803295247915,
            "profile_id": 121923590660074,
            "negative_type": "negativeAsin",
            "negative_text": "B077PWXCYS",
            "negative_match_type": "",
            "state": "enabled",
            "creation_date": 1634815522980,
            "last_updated_date": 1634815522980,
            "serving_status": "CAMPAIGN_PAUSED"
        }
    ]
}