← 返回目录
📁 Organic API › Accounts API › Guides

管理 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 资源的步骤。

  1. 使用 /business/property/add/ 接口将 URL 资源添加至广告账户中。 根据您指定的 property_type ,返回中将包含以下参数: - 若 property_type 为网域,则返回中仅包含signature参数。 - 若 property_type 为网址前缀,则返回中仅包含 signature和file_name参数。

  2. 验证 URL 资源的所有权。 根据要验证的 property_type,使用以下方法之一进行验证: - 欲验证已添加到广告账户中的网域,需在 DNS 配置中添加该网域的 TXT 记录。添加的 TXT 记录的内容应为签名字符串(即从步骤 1 中获取的参数 signature 的值)。欲了解如何添加新的 DNS TXT 记录,参阅此文章。 - 欲验证已添加到广告账户中的网址前缀,需将验证文件上传至网址前缀。验证文件的名称应与签名文件名(即从步骤 1 中获取的参数 file_name 的值)一致,文件内容应为签名字符串(从步 骤 1 中获取的参数 signature 的值)。

注意

  • 上传验证文件以验证网址前缀的所有权时,需确保文件允许公开访问。
  • 若文件上传后,文件名中出现额外的 ".txt" 文件扩展名,需将其删除,确保文件名格式正确, 即只包含一个 ".txt" 文件扩展名。

用于验证网址前缀所有权的示例文件
用于验证网址前缀所有权的示例文件

  1. 使用 /business/property/verify/ 接口检查 URL 资源的所有权验证结果。 - 若所有权验证成功,则返回的 property_status 将为 1(已验证)。 - 若步骤 2 中 DNS TXT 记录未正确更新,或者未正确上传文件,则会报错。在此情况下,您需要返回至步骤 2 重试。

注意
若您不再拥有或控制与已验证的所有权相关联的网域或网址前缀,则可使用 /business/property/delete/ 接口删除 URL 资源已验证的所有权。

后续步骤

将公开视频发布到自有账号

API 参考

使用以下接口管理 URL 资源: * 将 URL 资源添加至广告账户 * 检查 URL 资源验证结果 * 删除 URL 资源的已验证所有权 * 获取添加至广告账户的 URL 资源列表

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →