管理 URL 资源
验证视频 URL 的所有权是遵守 TikTok 版权内容和用户安全政策的重要步骤。本指南介绍了添加和验证 URL 资源的流程,以便您可以使用 /business/video/publish/ 接口将公开视频成功发布 到您的自有 TikTok 账户中。
在调用 /business/video/publish/ 之前,验证您计划传递给 video_url 参数的视频 URL 是否来自经验证的自有 URL 资源是有必要的。您需要拥有用于上传和存储视频的网站或其他在线平台,从而能够在发布视频时向 TikTok 提供该视频的对应 URL。
注意
- 自2023年11月16日起,您将不能使用未经验证的视频 URL 发布视频。为保证流畅的API体验,我们建议您尽快验证 URL 资源的所有权。
- 2023年11月16日之后,若您想在/business/video/publish/ 中传入无需验证的测试视频 URL,从而发布测试视频,您可以使用测试 URL
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4。- 需注意若您在2023年4月7日前使用过 /business/video/publish/ 发布视频,我们已将您通过
video_url参数指定的视频 URL 对应的域名自动设置为已验证状态。因此,建议您使用 /business/property/list/ 接口,确认您用于存放视频的域名是否已自动验证过。
URL 资源类型及所有权验证规则
TikTok 支持两种可验证的 URL 资源类型:网域和网址前缀。使用来自已验证的网域或网址前缀的视频 URL,可以确保您的视频合法且符合 TikTok 的相关政策。
网域
网域是您拥有或控制的网站的名称。例如,如果您拥有网站 www.example.com,则 example.com 就是对应的网域。
验证规则
欲验证网域,您需要在 DNS 配置中添加该网域的 TXT 记录,从而验证您对该网域的所有权。此验证方法适用于拥有网域的网域所有者。
网域验证完成后,您可将来自该网域的任意视频 URL 传入/business/video/publish/接口,进而将视频发布至您的 TikTok 账户中。例如,若您已验证网域 video.example.com,那么类似 https://public.video.example.com/tiktok/example.mp4的 URL 视作已验证过,而类似 https://example.com/video/example.mp4的 URL 则仍视作未经验证。
网址前缀
网址前缀是标识特定网址路径的 URL 的起始部分。例如,若您未拥有整个 www.example.com网站,但拥有该网站的路径 www.example.com/videos,可用于可以上传文件 ,则 https://www.example.com/videos/ 就是对应的网址前缀。
网址前缀的格式为:https:// + 主机名(必须是域名)+ 路径 + /。例如,在网址前缀 https://www.example.com/folder/ 中,主机名是域名 www.example.com,路径是 /folder。需注意不支持重定向,若 URL 返回 HTTP 3xx 状态码,则 URL 将视作不合法。
验证规则
欲验证网址前缀,您需要将验证文件上传到网址前缀对应的页面上。
网址前缀验证完成后,您可以将以该前缀开头的任意视频 URL 传入/business/video/publish/接口,进而将视频发布至您的 TikTok 账户中。例如,若您已经验证网址前缀 https://www.example.com/folder/user/,那么类似 https://www.example.com/folder/user/public/example.mp4 的 URL 视作已验证过,而类似 https://www.example.com/folder/public/user/example.mp4 的 URL 则仍视作未经验证。
# 步骤
本节概述了添加和验证 URL 资源的步骤。
-
使用 /business/property/add/ 接口将 URL 资源添加至广告账户中。 根据您指定的
property_type,返回中将包含以下参数: - 若property_type为网域,则返回中仅包含signature参数。 - 若property_type为网址前缀,则返回中仅包含signature和file_name参数。 -
验证 URL 资源的所有权。 根据要验证的
property_type,使用以下方法之一进行验证: - 欲验证已添加到广告账户中的网域,需在 DNS 配置中添加该网域的 TXT 记录。添加的 TXT 记录的内容应为签名字符串(即从步骤 1 中获取的参数signature的值)。欲了解如何添加新的 DNS TXT 记录,参阅此文章。 - 欲验证已添加到广告账户中的网址前缀,需将验证文件上传至网址前缀。验证文件的名称应与签名文件名(即从步骤 1 中获取的参数file_name的值)一致,文件内容应为签名字符串(从步 骤 1 中获取的参数signature的值)。
注意
- 上传验证文件以验证网址前缀的所有权时,需确保文件允许公开访问。
- 若文件上传后,文件名中出现额外的 ".txt" 文件扩展名,需将其删除,确保文件名格式正确, 即只包含一个 ".txt" 文件扩展名。
用于验证网址前缀所有权的示例文件
- 使用 /business/property/verify/ 接口检查 URL 资源的所有权验证结果。
- 若所有权验证成功,则返回的
property_status将为 1(已验证)。 - 若步骤 2 中 DNS TXT 记录未正确更新,或者未正确上传文件,则会报错。在此情况下,您需要返回至步骤 2 重试。
注意
若您不再拥有或控制与已验证的所有权相关联的网域或网址前缀,则可使用 /business/property/delete/ 接口删除 URL 资源已验证的所有权。
后续步骤
API 参考
使用以下接口管理 URL 资源: * 将 URL 资源添加至广告账户 * 检查 URL 资源验证结果 * 删除 URL 资源的已验证所有权 * 获取添加至广告账户的 URL 资源列表