修改图片名

您可以使用本接口修改图片名称。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径|/v1.2/file/image/ad/update/|/v1.3/file/image/ad/update/| |请求参数类型 |`advertiser_id`: number|`advertiser_id`: string|

请求

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

方法 POST

Header

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

参数

|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string|广告账号。 |
|file_name {必填}|string|图片名称。长度限制： 1-100 个字符。如果账户下存在相同名称的素材，那么将会在名称末尾自动增加毫秒级时间戳。如果最终长度超过 100 个字符，将会自动截断。 |
|image_id {必填}|string|图片 ID。 |

示例

(code curl http)
curl -H "Access-Token:xxx" -H "Content-Type:application/json" -X POST \
-d '{
"advertiser_id": "ADVERTISER_ID",
"file_name": "FILE_NAME",
"image_id": "IMAGE_ID"
}' \
https://ads.tiktok.com/open_api/v1.3/file/image/ad/update/
(/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|返回数据。 |
|request_id |string|请求的日志ID，唯一标识一个请求。 |

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "message": "OK",
    "code": 0,
    "data": {},
    "request_id": "2020063011512801023125104012348"
}
(/code);