视频和字幕 · YouTube 缩略图下载器和元数据查看器
oEmbed 如何返回视频的公共标题、频道和嵌入代码
· 工作原理
youtube 嵌入 元数据
有一种标准的、无密钥的方法可以向视频网站询问链接的公共标题、作者和嵌入 HTML。这篇文章解释了 oEmbed、请求和响应是什么样的，以及工具如何在不抓取页面的情况下显示元数据。
无需加载页面即可显示标题和频道 — oEmbed 旨在回答这个问题
博主无需加载观看页面即可了解公共视频的当前标题和频道。仅在访问者明确按下 Fetch 后，ToolAcre 才会向 YouTube 的 oEmbed 端点请求结构化 JSON 记录。该序列还可以防止失败的元数据查找与格式错误的 URL 混淆，因为这两个阶段有不同的证据。
首先在浏览器中解析链接。该预检无需网络访问即可验证并提取 ID，从而使格式错误的输入远离缩略图主机和元数据端点。端点提供狭隘的公共表示，而不是通用数据馈送或授权机制。
oEmbed 是什么 — 一个小标准，网站发布一个端点，用 JSON 回答“描述此 URL”
oEmbed 是用于描述公共 URL 的请求和响应约定。在这里，YouTube 提供了一个端点，该端点接受视频 URL 并返回用于嵌入和归属的 JSON 字段。确切的查询在网络跟踪中非常有用，因为它显示了请求的规范资源，而不会暴露帐户凭据。
ToolAcre 将该端点视为天花板，而不是抓取的门口。它不会检查观看页面 HTML、内部 YouTube 服务、签名或已注销的公共请求无法到达的任何内容。字段可以存在于原始 JSON 中，但仍会在应用程序合约中有意省略，因此规范化是产品决策。这可以防止下游注释依赖于上游的意外添加。
请求 — 视频 URL 和格式参数，仅此而已，发送到 youtube.com
请求转到 https://www.youtube.com/oembed，URL 设置为规范的 https://www.youtube.com/watch?v=ID 值，格式设置为 json。不添加 API 密钥、登录 cookie 或帐户令牌。因此，空结果是边界观察，而不是标识符无效或应重试受保护数据的证据。
浏览器发送匿名 GET，其中省略凭据、无引荐来源网址、无存储缓存并遵循重定向。 Google 直接接收它及其 Origin 标头； ToolAcre 在该路径中不运行服务器或代理。当上游有效负载包含该工具不承诺保留的额外字段时，这可以保持导出稳定。
规范化响应公开元数据字段，而不是 oEmbed HTML
大纲承诺显示嵌入 HTML，但 normalizeOembed 故意将该字段排除在外。规范化对象包含标题、频道、频道 URL、缩略图 URL 和尺寸、播放器宽度和高度、提供商和视频 ID。单独对故障进行分类可以帮助用户决定是否重试、检查响应或选择另一个允许的源。
每个值都受到保护：缺失的文本会得到简单的后备，尺寸必须为正，链接必须是 HTTPS。这使得导出的 JSON 可预测，而不意味着渲染每个原始 oEmbed 属性。可以在 DevTools 中检查请求，但浏览器记录并不意味着由 ToolAcre 存储或仅在本地处理。
为什么不需要密钥或登录 - 数据已经在页面上公开； oEmbed 只是使其结构化
不需要密钥，因为这是已注销的公共元数据，但公共并不意味着通用。私人、已删除和有年龄限制的视频不提供记录，而禁用嵌入的所有者可以引起授权响应。因此，审查失败请求的发布商应检查嵌入可用性和视频可见性，而不是假设十一个字符的 ID 被错误解析。
缺席边界是明确的：没有合成视图、喜欢、描述、标签、持续时间、发布日期或标题。无密钥端点不会授予超出 YouTube 选择发布的访问权限。如果编辑电子表格需要这些省略的字段，其作者必须使用另一个允许的来源并标记该来源，而不是将空白显示为 oEmbed 数据。
工作示例：将 oEmbed JSON 映射到 ToolAcre 的规范化记录中
对于一个成功的有效负载，标题映射到标题，author_name 映射到频道，author_url 映射到channelUrl，缩略图字段映射到嵌套图像描述，宽度和高度映射到播放器尺寸。 provider_name 成为提供商。即使上游约定使用 YouTube 频道的作者术语，此映射也会为导出提供稳定的应用程序名称。
原始 HTML 可能存在于上游，但 ToolAcre 结果和导出不会公开它。该应用程序根据经过验证的 ID 单独构建自己的响应式隐私增强型 iframe，从而避免对端点标记的意外信任。消费者收到可以引用或序列化的事实，而可执行的嵌入标记仍然在标准化元数据合同之外。
这不包括什么 - 视图计数、描述、评论、标题以及登录后的任何内容
由于离线模式、阻止程序或代理，元数据尝试可能会在响应之前失败；它可能会通过 HTTP 状态失败；或者它可以返回具有无效 JSON 的成功状态。每个路由都会收到不同的消息。传输错误建议检查浏览器环境，而无效的 JSON 标识已到达但无法满足端点承诺格式的响应。
缩略图探测是独立的，可能会看到 404、另一个错误、200 占位符或无法解码的数据。两个分支都不会下载视频，也不会绕过对私人、已删除或有年龄限制的内容的限制。保持分支独立可以让编辑保留经过验证的海报，即使标题归属暂时不可用，也不会发明丢失的元数据。
结构化公共元数据，不显示端点的嵌入 HTML
结果是结构化的公共元数据，而不是任意 oEmbed HTML 的副本。 ToolAcre 可以将规范化事实导出为 JSON、Markdown、CSV 或文本，并可以从经过验证的标识符构建已知链接。导出的选择会改变表示方式，而不是范围：每种格式都反映相同的标题、频道、图像、播放器、提供商和 ID 记录。
Fetch 之后，流量由直接 i.ytimg.com 图像请求和一个规范的 oEmbed 请求组成。请求省略凭据和引荐来源网址，使用无存储和遵循的重定向，并在浏览器网络面板中保持可见以进行验证。该跟踪证明浏览器直接联系了 Google；它不显示 ToolAcre 存储查找，也不使操作本地化。