更新智能创意广告素材状态

您可以使用本接口更新智能创意广告素材状态，包括广告文本，图片，视频。该接口是v1.3中的全新接口。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/ad/aco/material_status/update/

方法 POST

Header

|字段|类型|描述|
|---|---|---|
|Access-Token{必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
|Content-Type {必填}|string|请求消息类型。<br>允许值: `"application/json"`。|

参数

|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string| 广告主 ID。 |
|ad_group_id {必填}|string| 广告组 ID。<br><br><p><span style="color:darkred"><b>注意</b></span>：传入已开启智能创意的广告组的 ID。该广告组的 `creative_material_mode` 需为 `SMART_CREATIVE`。|
|material_ids {必填}|string[]| 素材 ID。您只能传入一个素材 ID。 |
|material_status {必填}|string|素材状态。枚举值： `ENABLE` （素材可使用）， `DISABLE`（素材不可使用）。|

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/aco/material_status/update/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "ad_group_id": "{{ad_group_id}}",
    "material_ids": ["{{material_id}}"],
    "material_status": "DISABLE"
}'
(/code)

返回

|字段|类型|描述|
|---|---|---|
|code |number|返回码。完整返回码列表及描述，可见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097) 。|
|message |string|返回信息。更多信息可见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|data |object|返回数据。  |
#|ad_group_id |string| 广告组 ID，数量：1-100。 |
#|material_ids|string[]|素材ID。|
#|material_status|string|素材状态。枚举值： `ENABLE` (素材可使用)， `DISABLE`(素材不可使用)。|
|request_id |string|请求的日志ID，唯一标识一个请求。 |

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "material_ids": [
            "{{material_id}}"
        ],
        "ad_group_id": "{{ad_group_id}}",
        "material_status": "DISABLE"
    }
}
(/code);