启用或关闭 TikTok 帖子的广告授权设置

您可以使用本接口启用或关闭 TikTok 帖子的“广告授权”设置。

若想了解管理 TikTok 帖子“广告授权”设置的详细步骤，可查看管理 TikTok 帖子的广告授权。

注意

启用“广告授权”设置，代表您已阅读并同意推广内容服务条款，且允许在 TikTok 推广此帖子。开启广告授权后，视频隐私状态将更改为“可供广告使用”，以便广告授权团队审查此视频。您的帖子还可能用在除 TikTok 外的第三方平台的广告中。
若想删除授权码（即视频代码）或关闭广告授权，您必须暂停所有与该帖子关联的投放中的推广系列或广告。
若想延长授权有效期，可使用/business/post/authorize/。

使用前需知

需遵循授权和获取访问令牌中的步骤获取了带有biz.spark.auth权限的 TikTok 账号访问令牌以及 TikTok 账号对应的应用唯一 ID。 - 若要确认 TikTok 账号访问令牌是否带有biz.spark.auth权限，可使用/tt_user/token_info/get/，查看返回的scope。若访问令牌无 biz.spark.auth权限，需根据授权步骤重新向 TikTok 账号所有人请求 Spark Ads 授权码管理权限。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/business/post/authorize/setting/

方法 POST

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|经 TikTok 创作者授权的访问令牌。<br>若想获取访问令牌，需使用[/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs?id=1738084387220481#item-link-%E8%8E%B7%E5%8F%96%20TikTok%20%E8%B4%A6%E5%8F%B7%E8%AE%BF%E9%97%AE%E4%BB%A4%E7%89%8C)接口。|
|Content-Type {必填}|string|请求信息类型。<br>允许格式：`application/json`。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|business_id {必填}| string | TikTok 账户的应用唯一识别 ID。<br><br>您需将[/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs?id=1738084387220481#item-link-%E8%8E%B7%E5%8F%96%20TikTok%20%E8%B4%A6%E5%8F%B7%E8%AE%BF%E9%97%AE%E4%BB%A4%E7%89%8C)接口返回的`open_id`字段值传给本字段。|
| item_id {必填} | string | TikTok 帖子 ID。<br><br>若想获取 TikTok 账号的公开帖子，可使用[/business/video/list/](1762228421622786.html)。 <br><br>示例：`7123456789123456789`。 |
| is_ad_promotable {必填} | boolean | 是否启用帖子的“广告授权”设置，允许帖子用于推广。<br><br>支持的值： <ul><li>`true`：启用“广告授权”设置。</li><li> `false`：关闭“广告授权”设置。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：若 TikTok 帖子已用于 Spark Ads 中，不支持关闭帖子的“广告授权”设置。 |
| authorization_days | number | 授权的有效期，单位为天。 <br><br>支持的值：`7`，`30`，`60`，`365`。<br> 默认值：`30`。 |

示例

启用广告授权设置

(code curl http)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/business/post/authorize/setting/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "business_id": "{{business_id}}",
    "item_id": "{{item_id}}",
    "is_ad_promotable": true,
    "authorization_days": 365
}'
(/code)

关闭广告授权设置

(code curl http)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/business/post/authorize/setting/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "business_id": "{{business_id}}",
    "item_id": "{{item_id}}",
    "is_ad_promotable": false
}'
(/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| 返回数据。 |
#| item_id | string | 仅当请求中 `is_ad_promotable` 设置为 `true` 时返回。<br><br>TikTok 帖子的 ID。<br><br>示例：`7123456789123456789`。 |
#| auth_code | string | 仅当请求中 `is_ad_promotable` 设置为 `true` 时返回。<br><br> TikTok 帖子的授权码。 <br><br> 示例：`#1Ea2bcde3fUM/ghijEk/L4mOceft5deFRq6za7JsgnAJ8PB9n1XIr1rC1b/5Rw4=`。 |
#| auth_code_start_time | string | 仅当请求中 `is_ad_promotable` 设置为 `true` 时返回 。<br><br>授权码生效时间，格式为 `YYYY-MM-DD HH:MM:SS`（UTC+0）。<br><br>示例： `2024-01-01 00:00:00`。 |
#| auth_code_end_time | string | 仅当请求中 `is_ad_promotable` 设置为 `true` 时返回。<br><br>授权码过期时间，格式为 `YYYY-MM-DD HH:MM:SS`（UTC+0）。<br><br>示例： `2024-01-01 00:00:00`。 |
#| authorization_days | number | 仅当请求中 `is_ad_promotable` 设置为 `true` 时返回。 <br><br>授权的有效期，单位为天。<br><br>支持的值：`7`，`30`，`60`，`365`。 |

示例

启用广告授权设置

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "auth_code": "{{auth_code}}",
        "auth_code_end_time": "2025-01-01 12:39:35",
        "auth_code_start_time": "2024-01-01 12:39:35",
        "authorization_days": 365,
        "item_id": "{{item_id}}"
    }
}
(/code)

关闭广告授权设置

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {}
}
(/code)