获取 TikTok 账号帖子隐私设置

您可以使用本接口获取某个 TikTok 账号的帖子隐私设置。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/business/video/settings/

方法 GET

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)接口。|

参数

|字段{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`字段值传给本字段。|

示例

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id={{business_id}}' \
--header 'Access-Token: {{Access-Token}}'
(/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| 返回数据。 |
#| privacy_level_options | string[] | 该 TikTok 账号可选的隐私级别设置 。<br><br><ul><li>若该账号为公开账号，支持的枚举值为：<ul><li> `PUBLIC_TO_EVERYONE`：所有人。</li><li>`MUTUAL_FOLLOW_FRIENDS`：好友（您回关的粉丝）。</li><li>`SELF_ONLY`：仅自己。</li></ul></li><li>若该账号为私密账号，支持的枚举值为：<ul><li>`FOLLOWER_OF_CREATOR`：粉丝。</li><li>`MUTUAL_FOLLOW_FRIENDS`：好友（您回关的粉丝）。</li><li>`SELF_ONLY`：仅自己。</li></ul></li></ul>|
#| comment_disabled | boolean | 该 TikTok 账号的帖子是否可以使用“允许发表评论”设置。<br><br>支持的值：<ul><li> `true`：不可以。不支持为该 TikTok 账号的帖子启用此设置。<ul><li>若您已在 TikTok 账号的评论隐私设置中将“允许评论”设置为“不允许”，本字段将为 `true`。</li></ul></li><li>`false`：可以。支持为该 TikTok 账号的帖子启用或关闭此设置。</li></ul> |
#| duet_disabled | boolean | 该 TikTok 账号的帖子是否可以使用“允许合拍”设置。<br><br>支持的值： <ul><li>`true`：不可以。不支持为该 TikTok 账号的帖子启用此设置。<ul><li>若您已在 TikTok 账号的合拍隐私设置中将“允许合拍”设置为“仅自己”或 TikTok 账号为私密账号，本字段将为 `true`。</li></ul></li><li>`false`：可以。支持为该 TikTok 账号的帖子启用或关闭此设置。</li></ul>|
#| stitch_disabled | boolean | 该 TikTok 账号的帖子是否可以使用“允许拼接”设置。 <br><br> 支持的值：<ul><li> `true`：不可以。不支持为该 TikTok 账号的帖子启用此设置。<ul><li>若您已在 TikTok 账号的拼接隐私设置中将“允许拼接”设置为“仅自己”或 TikTok 账号为私密账号，本字段将为 `true`。</li></ul></li><li>`false`：可以。支持为该 TikTok 账号的帖子启用或关闭此设置。</li></ul>|
#| max_video_post_duration_sec | number | 该 TikTok 账号能否发布的视频帖子最大时长，单位为秒。 <br><br> 若您试图通过[/business/video/publish/](1762228496095234.html)发布超过最大时长的视频帖子，发布将失败。 |

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "comment_disabled": false,
        "duet_disabled": false,
        "max_video_post_duration_sec": 600,
        "privacy_level_options": [
            "PUBLIC_TO_EVERYONE",
            "MUTUAL_FOLLOW_FRIENDS",
            "SELF_ONLY"
        ],
        "stitch_disabled": false
    }
}
(/code)