删除 URL 资源的已验证所有权
您可以使用本接口删除广告账户的 URL 资源(网域或网址前缀)已验证的所有权。
欲了解添加和验证 URL 资源的详细步骤,参阅管理 URL 资源。
重要提示
自 2025 年 10 月 15 日起,使用此接口时需要同时指定开发者应用的密钥。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/business/property/delete/
方法 POST
Header
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Content-Type {必填}|string|请求信息类型。<br>允许格式:`application/json`。|
参数
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
| app_id {必填} | string |开发者应用ID。<br><br>若想获取<strong>应用ID</strong>,您可以导航至<strong>[应用管理](https://business-api.tiktok.com/portal/apps)</strong> > <strong>App Detail</strong> > <strong>基本信息</strong>。|
|secret {必填}|string| 开发者应用密钥。<br><br>若想获取<strong>密钥</strong>,可以导航至<strong>[应用管理](https://ads.tiktok.com/marketing_api/apps/)</strong> > <strong>App Detail</strong> > <strong>基本信息</strong>。|
|url_property_meta {必填} | object | 您想要删除其已验证所有权的 URL 资源的信息。 |
#| property_type {必填} | integer | URL 资源的类型。 <br>枚举值: <ul><li>1:网域。</li><li>2:网址前缀。</li></ul>|
#| url {必填} | string | 您想要删除对应已验证所有权的自有 URL。需根据您指定的 `property_type` 传入对应 URL。|
示例
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/business/property/delete/' \
--header 'Content-Type: application/json' \
--data '{
"app_id": "{{app_id}}",
"secret": "{{secret}}",
"url_property_meta": {
"property_type": {{property_type}},
"url": "{{url}}"
}
}'
(/code)
返回
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number| 返回码。完整返回码列表及描述,参见 [附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string| 返回信息。更多信息参见 [附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
|request_id |string| 请求的日志ID,唯一标识一个请求。 |
|data |object| 返回数据。 <br>操作成功时返回空对象`{}`。|
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {}
}
(/code)