Lingxing
切换旧版

修改广告商品状态

POST/basicOpen/adReport/manage/putSpProductAds

支持批量调整SP广告商品的启用/暂停状态,单次最多1000个

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/adReport/manage/putSpProductAdsHTTPSPOST1

请求参数

sidnumber
店铺ID,sid和profile_id必传一个
profile_idnumber
广告配置Profile ID,sid和profile_id必传一个
productAdsarray<object>必填
商品广告列表,单次最多1000
隐藏子属性
adIdnumber必填
商品广告id
statestring
商品广告状态:enabled-启用
paused-暂停

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/adReport/manage/putSpProductAds?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "sid": 123456,
    "productAds": [
        {
            "adId": 987654321,
            "state": "enabled"
        },
        {
            "adId": 987654322,
            "state": "paused"
        }
    ]
}'

返回结果

Json Object

codenumber必填
示例 1
successboolean必填
示例 true
dataobject必填
隐藏子属性
apiResultarray<object>必填
隐藏子属性
codestring必填
SUCCESS 成功 其他为失败
示例 SUCCESS
ad_idstring
成功时返回 广告商品id
示例 987654321
descriptionstring
不成功时返回错误的原因
msgstring必填
示例 success
traceIdstring必填
链路id
示例 f0763238_fed4_4f06_ae05_0f864e1c78b2

返回成功示例

{
    "code": 1,
    "success": true,
    "data": {
        "apiResult": [
            {
                "code": "SUCCESS",
                "ad_id": "987654321",
                "description": ""
            }
        ]
    },
    "msg": "success",
    "traceId": "f0763238_fed4_4f06_ae05_0f864e1c78b2"
}