更新广告状态

开发环境

POST

/v1.3/ads/update_configured_status

请求参数

标有*的参数为必填项

名称	类型	描述
account_id*	integer	广告主帐号 id，有操作权限的帐号 id，不支持代理商 id
update_configured_status_spec*	struct[]	返回信息列表数组最大长度 100
ad_id*	int64	广告 id
configured_status*	enum	客户设置的状态，[枚举详情] 枚举列表：{ AD_STATUS_NORMAL, AD_STATUS_SUSPEND }

使用说明
1.
返回结果的顺序和 update_configured_status_spec 中的参数顺序是一致的。
2.
update_configured_status_spec 中 ad_id 不允许重复。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST '/v1.3/ads/update_configured_status' \
--header 'access_token;' \
--header 'timestamp;' \
--header 'nonce;' \
--data-urlencode 'account_id=<ACCOUNT_ID>' \
--data-urlencode 'update_configured_status_spec=[{"ad_id":123,"configured_status":"AD_STATUS_NORMAL"},{"ad_id":456,"configured_status":"AD_STATUS_NORMAL"}]'

响应示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "code": 0,
                "message": "",
                "message_cn": "",
                "ad_id": "<AD_ID>"
            }
        ],
        "fail_id_list": []
    }
}

请求参数

Header 参数

Body 参数application/x-www-form-urlencoded

返回响应

🟢200成功

application/json

Body

修改于 2023-11-07 02:56:03

更新广告组状态

更新广告组投放时间

更新广告状态

请求参数#

请求参数

返回响应

请求参数