HTML中itemtype怎么标记视频？VideoObject代码演示-html教程-PHP中文网

videoobject 的 itemtype 值必须严格为 https://schema.org/videoobject，不可省略协议或使用 http、小写拼写；须配合 itemscope 使用，且需用 div 包裹 meta 或内联元素显式声明属性，不能直接加在 video 标签上。

html中itemtype怎么标记视频？videoobject代码演示

VideoObject 的 itemtype 值必须是 `https://schema.org/VideoObject`

HTML 中用 itemtype 标记视频，本质是嵌入 Schema.org 结构化数据，不是 HTML 原生语义，而是为搜索引擎理解内容服务。直接写错 URL（比如漏掉 https://、拼成 videoobject 小写、或用了过时的 http://）会导致结构化数据校验失败。

常见错误现象：Google Rich Results Test 报 “No rich results detected”，或 Search Console 显示 “Video object not found”。根本原因往往是 itemtype 值不匹配 Schema.org 官方定义。

itemtype 必须严格等于 https://schema.org/VideoObject（注意大小写无关，但协议和路径不能省）
不能用 http://schema.org/VideoObject —— Google 已明确要求 HTTPS 版本
不能简写为 VideoObject 或 video —— 这不是合法 URI
必须配合 itemscope 使用，否则 itemtype 无意义

最简可用的 VideoObject 微数据 HTML 示例

以下代码满足 Google 视频富媒体结果的基本要求（标题、描述、缩略图、播放页 URL、时长），可直接嵌入页面主体中：

<div itemscope itemtype="https://schema.org/VideoObject">
  <meta itemprop="name" content="如何正确使用 itemtype 标记视频">
<meta itemprop="description" content="详解 VideoObject 结构化数据的必要字段与常见陷阱">
<meta itemprop="thumbnailUrl" content="https://example.com/thumbnail.jpg">
<meta itemprop="uploadDate" content="2024-06-15">
<meta itemprop="duration" content="PT3M22S">
<meta itemprop="embedUrl" content="https://example.com/embed?id=123">
<meta itemprop="contentUrl" content="https://example.com/video.mp4">
</div>

说明：

Html2md

使用 Readability + Turndown 将 HTML 页面转换为干净的、Agent 友好的 Markdown。去除导航栏、广告、页脚、Cookie 横幅、社交按钮等干扰元素。支持 URL...

下载

thumbnailUrl 必须是可公开访问的图片 URL，宽高建议 ≥ 160×90，格式支持 JPG/PNG/GIF
duration 必须用 ISO 8601 格式（如 PT3M22S 表示 3 分 22 秒），不能写 3:22 或 202s
embedUrl 和 contentUrl 二选一即可，但推荐都提供：embedUrl 指向 iframe 播放页，contentUrl 指向视频文件直链
所有属性都用 <meta> 是为了不破坏页面视觉，若需展示标题/描述，可用 <span itemprop="name">…</span>

为什么不用 `video` 标签直接加 `itemtype`？

很多人试图在原生 <video></video> 标签上直接加 itemscope itemtype，例如：

<video itemscope itemtype="https://schema.org/VideoObject">…</video>

这在语法上不报错，但实际无效。因为 <video></video> 是流媒体容器，不承载元数据；而 Schema.org 的 VideoObject 是一个独立实体，需要显式声明属性（itemprop）并绑定到该实体下。

浏览器不会解析 <video></video> 内部的 src、poster 等属性为 Schema 属性
Google 的结构化数据提取器只识别 itemprop + itemscope 显式声明的内容
正确做法是：用 <div itemscope itemtype="..."> 包裹一组 <code><meta> 或内联元素，与 <video></video> 并列存在（可同级或父级）
容易被忽略的兼容性细节

即使代码语法全对，仍可能被搜索引擎忽略，问题常出在上下文环境：
- 页面必须可通过公开网络访问 —— 本地 file:// 或未部署的开发服务器无法被 Google 抓取验证
- thumbnailUrl 和 contentUrl 的域名需与当前页面同源，或已配置 CORS 允许 Googlebot 访问（否则缩略图加载失败，富媒体结果降级）
- 如果页面同时存在 JSON-LD 和微数据两种格式，Google 优先采用 JSON-LD；微数据仅在无 JSON-LD 时生效
- uploadDate 必须是过去时间，未来日期（如 2025-01-01）会导致视频不被索引
真正卡住人的，往往不是 itemtype 写错，而是缩略图不可达、域名跨域没配、或者测试时用的是未上线的 HTML 片段。