工具 API
catalog_
Uploads catalog videos to an E-commerce catalog from a CSV file URL by creating an asynchronous file-processing task at `/open_api/v1.3/catalog/video/file/`. The response returns a `feed_log_id` that you can use to check processing status and final results via `/catalog/video/log/`. This endpoint currently accepts only CSV files that contain video URLs. It can handle only one file task at a time; if a previous file task is still in progress, new tasks fail until the current task completes. Before using this endpoint, you must already have an E-commerce catalog with products available for ad creation. If you do not have one yet, create and populate it first using the product catalog upload flow referenced in "Upload products to different catalog types via JSON schema".
调用信息
- 工具标识
- tiktok-ads.catalog_video_file_upload
- 服务提供方
- TikTok 广告
- 平均响应
- 0 ms
- 近 7 天调用
- 0
输入参数
advertiser_idsIDs of ad accounts to sync the uploaded videos to so the videos become available in those accounts' creative libraries. Omit this field if you do not want to sync videos to any ad account. Max size: 100. Each ad account must belong to the same Business Center as `catalog_id` and `bc_id`, and you must have `ADMIN` or `OPERATOR` permission for the ad account. Ineligible ad accounts are ignored.
bc_id必填Business Center ID.
catalog_id必填Catalog ID for the E-commerce catalog that will receive the uploaded videos. Retrieve `catalog_id` values from `/catalog/get/` where `catalog_type` is `ECOM`. You must have Catalog Management permission for the catalog; to find catalogs where you have that permission, use `/bc/asset/get/` with `asset_type=CATALOG` and use `asset_id` values whose `catalog_role` is `ADMIN`.
file_url必填Download URL of the CSV file to import. Only CSV files containing video URLs are accepted. The file should follow the catalog video CSV template and include catalog video parameters such as required `video_name`, `video_link`, and `sku_id_list` columns.