视频和字幕 · YouTube 缩略图下载器和元数据查看器
Open Graph、oEmbed 和 schema.org：链接预览如何学会阅读视频
· 背景
youtube 嵌入 链接预览
当您将视频链接粘贴到聊天应用程序中时，会出现预览。这篇文章解释了使之成为可能的三个元数据层、每个平台读取哪个元数据层以及为什么公共元数据首先存在。
粘贴链接，查看卡片 - 每个人都使用但没有人考虑的预览
丰富的卡片可以包含标题、图像和目的地，但外观相同的卡片可能来自不同的元数据机制。 ToolAcre 的 YouTube 产品实现了一种特定机制：直接 oEmbed JSON 请求。将该请求与其规范化对象进行比较，而不是推断超出实现证明的内容。仅在用户按下 Fetch 后才会发出请求，因此本文可以区分本地准备和远程检索。
它不会重现聊天应用程序的预览管道。解释其自身端点和规范化字段的输出，而不是对不相关的客户端进行逆向工程。一个方便的假设可以将一次失败的查找变成一个误导性的目录条目。这会将标题或图像不匹配附加到实际响应，而不是附加到发明的客户端缓存故事。
开放图谱在这里是概念性的； ToolAcre 不获取观看页面元标记
Open Graph 通常是指放置在页面 HTML 中的元标记，但 ToolAcre 不会加载 YouTube 观看页面或解析这些标记。这里的任何比较都是概念性的，而不是对该应用程序发出的请求的描述。没有页面标记意味着没有第二个源可以与规范化记录进行协调。因此，缺失的描述仍然缺失，而不是从未请求的页面借用的。
由于没有观看页面 HTML 进入工具，开放图标题、描述和图像既不会补充也不会覆盖规范化的 oEmbed 记录。将失败记录为观察到的响应类，而不是看起来成功的后备。这可以防止网络拒绝被伪装成元数据分歧。
oEmbed — 返回结构化数据并根据请求嵌入 HTML 的端点
oEmbed 是实现的路径。浏览器向 www.youtube.com/oembed 请求规范的观看 URL 以及 format=json，然后规范化标题、频道、频道 URL、缩略图尺寸、播放器尺寸和提供商。当上游 JSON 包含此工具不承诺的字段时，标准化形状还使导出可预测。
不显示原始嵌入 HTML。 ToolAcre 根据经过验证的视频 ID 独立创建响应式隐私增强型 iframe，将生成的标记置于本地源代码控制之下。可以将确切的请求复制到浏览器跟踪中，而无需添加帐户状态。 iframe 是单独的后期浏览器交互，而不是隐藏的元数据检索。
schema.org 和 JSON-LD 在这里是概念性的； ToolAcre 不会解析它们
schema.org 和 JSON-LD 描述了其他结构化元数据方法，但此应用程序不会从 YouTube 页面解析任何一种方法。因此，搜索引擎行为和页面注释超出了其证据范围。单独保留观察值和日期，而不是假设历史状态。需要这些字段的引文必须单独咨询授权来源。
提及这些层可以为开发人员指明方向，但这并不意味着 ToolAcre 会比较它们或解决它们领域之间的分歧。概念比较不是功能清单。没有后备合并操作会默默地选择一个竞争标题而不是另一个标题。
预览应用程序行为和缓存不在 ToolAcre 的实现范围内
不同的预览应用程序可能会选择不同的层和缓存，但存储库不包含跨聊天客户端的实验，也没有缓存检查。关于哪个应用程序读取哪个层的声明需要单独引用的研究。无存储请求仍然依赖于远程传递和浏览器缓存语义。干净的 ToolAcre 运行无法证明第三方预览服务将保留什么。
ToolAcre 本身不请求缓存预览卡。它要求当前公共 oEmbed JSON 具有缓存模式无存储，受浏览器和网络语义的约束，而不是承诺历史新鲜度。离线状态、阻止程序或托管代理仍然可以阻止响应。
工作示例：检查 ToolAcre 的 oEmbed 结果，而不是三个发明的应用程序预览
对于有效检查，请获取一个公共视频并检查导出的 JSON。将标题、频道和缩略图/player 维度映射到标准化Oembed，然后记下缺少的描述、视图、持续时间、发布日期和标题。将请求中的规范观看 URL 与本地解析器使用的视频 ID 进行比较。
不要发明三个应用程序屏幕截图或将它们的差异归因于元数据层而不观察它们。实现证据仅支持该浏览器的直接 oEmbed 结果。将失败记录为观察到的响应类别。无效的 JSON 是响应失败，而不是空字段集。
这不包括什么 - 如何在您自己的网站上设置这些标签
在其他网站上设置预览标签不属于本产品范围。 ToolAcre 既不为用户创建开放图谱，也不创建架构标记，并且不诊断第三方缓存刷新行为。其产出仍然与当前公众的反应和确切的输入挂钩。发布商必须在目标网站自己的工作流程中应用这些标签。
其可用性边界仍然是已注销的公共 YouTube 数据：无法恢复私有、已删除和有年龄限制的记录，并且元数据可能会因网络、HTTP 状态或无效 JSON 而失败。名义 URL 并不是字节、元数据或权限必须存在的证据。不重试访问边界的更改。
要点：ToolAcre 仅使用 oEmbed 来存储元数据
ToolAcre 仅使用 oEmbed 来存储元数据，以及直接缩略图文件。 Open Graph、schema.org 和外部缓存是相邻系统，而不是隐藏步骤。当历史比较很重要时，单独保留观察值和日期。结果是有界的公共记录，而不是通用的预览分析器。
Before Fetch 解析是本地的；之后，8 个图像请求和 1 个 oEmbed 请求直接发送至 Google，省略凭证、无引荐来源网址、无存储并遵循重定向。 Google 看到 Origin 标头，但没有 ToolAcre 服务器或代理处理它们。这些直接请求仍然受到 Google 退出限制的约束，并且不会检索受限材料。