TOOL API
file_ name_ check
Checks whether one or more image or video file names have already been used under the same ad account (`advertiser_id`). File names must be unique within an advertiser account for ad images and videos. If you skip this check and later get a duplicate-name error when uploading via `/file/image/ad/upload/` or `/file/video/ad/upload/`, you must upload the file again.
Call information
- Tool slug
- tiktok-ads.file_name_check
- Provider
- TikTok for Business
- Average response
- 0 ms
- Calls in 7 days
- 0
Input parameters
advertiser_idrequiredAdvertiser ID.
file_nameUse this top-level field when checking a single file name. In that case, `file_type` is also required. If checking multiple file names, use `files` instead.
file_typeUse this top-level field when checking a single file name. In that case, `file_name` is also required. If checking multiple file names, use `files` instead. Enum values: `VIDEO` (video), `IMAGE` (image). Default value: `VIDEO`.
filesUse this field to check multiple file names at once. If checking multiple names, `files` is required. Each item should include `file_name` and may include `file_type`; if omitted, `file_type` defaults to `VIDEO`. If checking a single file name instead, use top-level `file_name` and `file_type`. Maximum 20 items.