工具 API

file_image_ad_upload

Uploads an image to the Asset Library and returns an image ID for ad creation. Request timeout is 10 seconds, and upload speed depends on network bandwidth, so keep file sizes reasonable. This endpoint can be used for standard ad image assets and, if the uploaded asset qualifies, for Carousel Ads.

ecommerceOAuth1 积分

调用信息

工具标识: tiktok-ads.file_image_ad_upload
服务提供方: TikTok 广告
平均响应: 0 ms
近 7 天调用: 0

输入参数

advertiser_id必填

Advertiser ID.

file_id

Required when `upload_type` is `UPLOAD_BY_FILE_ID`. ID of an image file already uploaded to the file repository.

file_name

Image name. Length limit: 1-100 characters. If omitted, the default is the original file name; if the final file name exceeds 100 characters, it is truncated. Under the same `advertiser_id`, file names must be unique. You can call `/file/name/check/` to verify whether the name has already been used. If you get a duplicate file name error, rename the file or append a timestamp such as `<original_filename>_<timestamp>` and upload again.

image_url

Required when `upload_type` is `UPLOAD_BY_URL`. Public URL of the image to upload, for example `http://xxx.xxx`.

upload_type必填

Image upload method. When `UPLOAD_BY_URL`, you must provide `image_url`. When `UPLOAD_BY_FILE_ID`, you must provide `file_id`.