工具 API
dmp_
Updates an audience's name or, for Customer File audiences only, its uploaded audience files through `/open_api/v1.3/dmp/custom_audience/update/`. Customer File audiences support file modifications with `REPLACE`, `APPEND`, and `REMOVE`; Engagement, App Activity, Website Traffic, and Lookalike audiences support name updates only. `REPLACE` replaces all previous data files, `APPEND` adds new data files, and `REMOVE` removes specified data files. An expiring or expired audience cannot be modified and can only be deleted; use `is_expiring` and `expired_time` to determine this. `APPEND`, `REMOVE`, and `REPLACE` fail if the audience size would be less than 1,000 after the operation, and `REMOVE` cannot remove all data files. Quotas and concurrency limits apply at the audience level: up to 24 update operations in any consecutive 24 hours, only one file-based `REPLACE` operation per day, and you must wait for the current operation to complete before retrying; `REPLACE` requests are rejected if another `REPLACE` is still unfinished. The API returns success or error immediately, but file processing is asynchronous with an SLA of 48 hours.
调用信息
- 工具标识
- tiktok-ads.dmp_custom_audience_update
- 服务提供方
- TikTok 广告
- 平均响应
- 0 ms
- 近 7 天调用
- 0
输入参数
actionModification type for uploaded files. Valid only when `file_paths` is provided. `APPEND` adds only data not already in the original audience file, `REMOVE` removes only data that matches the original file, and `REPLACE` replaces all original audience data. Default: `REPLACE`. `APPEND`, `REMOVE`, and `REPLACE` fail if the audience size would be less than 1,000 after the operation.
advertiser_id必填Advertiser ID.
audience_sub_typeAudience subtype that determines what campaign types the audience can be used for. Allowed value: `REACH_FREQUENCY` to enable use in Reach & Frequency campaigns. You can change the subtype only from `NORMAL` to `REACH_FREQUENCY`, not the reverse. If you update this field, changes to all other request fields are ignored. If the audience is a Lookalike audience, you cannot change `audience_sub_type` to `REACH_FREQUENCY`.
custom_audience_id必填Custom audience ID.
custom_audience_nameNew audience name. Maximum length: 128 characters. You must provide either `custom_audience_name` or `file_paths`.
file_pathsFiles to upload when updating a Customer File audience. You must provide either `file_paths` or `custom_audience_name`. Valid only for Customer File audiences. When `file_paths` is provided, you can specify the file modification mode with `action`. Recommended request size: fewer than 50 files per request for stability. Uploaded files must use the same encryption method and type as the audience being updated.