VideoObject 的 itemtype 值必须严格为 https://schema.org/VideoObject，不可省略协议或使用 HTTP、小写拼写；须配合 itemscope 使用，且需用 div 包裹 meta 或内联元素显式声明属性，不能直接加在 video 标签上。
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>
说明：
立即学习“前端免费学习笔记（深入）”；
-
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> 标签上直接加 itemscope itemtype，例如：
<video itemscope itemtype="https://schema.org/VideoObject">…</video>
这在语法上不报错，但实际无效。因为 <video> 是流媒体容器，不承载元数据；而 Schema.org 的 VideoObject 是一个独立实体，需要显式声明属性（itemprop）并绑定到该实体下。
- 浏览器不会解析
<video>内部的src、poster等属性为 Schema 属性 - Google 的结构化数据提取器只识别
itemprop+itemscope显式声明的内容 - 正确做法是：用
<div itemscope itemtype="...">包裹一组<meta>或内联元素，与<video>并列存在（可同级或父级）
容易被忽略的兼容性细节
即使代码语法全对，仍可能被搜索引擎忽略，问题常出在上下文环境：
- 页面必须可通过公开网络访问 —— 本地
file://或未部署的开发服务器无法被 Google 抓取验证 -
thumbnailUrl和contentUrl的域名需与当前页面同源，或已配置 CORS 允许 Googlebot 访问（否则缩略图加载失败，富媒体结果降级） - 如果页面同时存在 JSON-LD 和微数据两种格式，Google 优先采用 JSON-LD；微数据仅在无 JSON-LD 时生效
-
uploadDate必须是过去时间，未来日期（如2025-01-01）会导致视频不被索引
真正卡住人的，往往不是 itemtype 写错，而是缩略图不可达、域名跨域没配、或者测试时用的是未上线的 HTML 片段。
