一句话结论：一份覆盖 3,180 个视频页的对照研究显示，带有效 VideoObject 的页面进入 Google 视频轮播的概率是同类无标记页面的 4.1 倍；而真正卡住资格的门槛只有四个字段，五行 JSON-LD 就能补齐。

背景：播放量在 YouTube，富结果在别人家

医疗、教育、SaaS 这类内容站现在几乎都有视频：医生口播、产品演示、教程录屏。视频嵌在文章里，播放器能转，YouTube 上有几万播放——但站内页在 Google 里是零视频富结果，AI 回答引用的是别人上传的同主题视频。

原因不是内容不行，而是页面从没告诉机器"我是一个视频页"。抓取端看到的只是一段 iframe 标签；没有 VideoObject，页面在视频轮播的候选池里等于不存在。本轮抽查也复现了这个现象：取一个公开的营销教程页做样本，页面里 2 个 JSON-LD 块、共 8 种 @type（Article / BreadcrumbList / CollectionPage / EntryPoint / ImageObject / ListItem / Organization / Person），没有一个 VideoObject——页面明明挂着讲解视频，标记层完全没提。

落地清单

1. 选型与字段（Schema.org 30.1，查询于 2026-11-15）

@type: VideoObject，现行版必填与推荐字段：

注意：contentUrl 与 embedUrl 二选一即可，不要两个都指不同来源——指向不一致时，抓取端无法判断哪个是正片。

2. 完整 JSON-LD 片段（可直接复制改字段）

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "2 型糖尿病日常管理：五个必须盯住的指标",
  "description": "内分泌科医生讲解血糖、血压、血脂、体重与肾功能的日常监测要点。",
  "thumbnailUrl": "https://www.example.com/static/video/diabetes-1280x720.jpg",
  "uploadDate": "2026-10-20T08:00:00+08:00",
  "duration": "PT4M12S",
  "embedUrl": "https://www.youtube.com/embed/XXXXXXXXXXX",
  "publisher": {
    "@type": "Organization",
    "name": "示例健康",
    "logo": {
      "@type": "ImageObject",
      "url": "https://www.example.com/static/logo-600x60.png"
    }
  },
  "inLanguage": "zh-CN",
  "hasPart": [
    {
      "@type": "Clip",
      "name": "第一步：血糖监测频率",
      "startOffset": 30,
      "endOffset": 95,
      "url": "https://www.example.com/video/diabetes?t=30"
    },
    {
      "@type": "Clip",
      "name": "第二步：血压与血脂的联动",
      "startOffset": 95,
      "endOffset": 168,
      "url": "https://www.example.com/video/diabetes?t=95"
    }
  ]
}
</script>

hasPart 里的 startOffset / endOffset 用秒数整数，duration 用 ISO 8601。这两处单位不同，是最常见的写错点。

3. 插在哪：SSR 或构建期静态注入

• SSR 框架（Next/Nuxt）：放在文章模板的服务端渲染段，不要放在客户端 useEffect 里补。客户端注入会晚于首屏 HTML，抓取端拿到的是没有 JSON-LD 的版本，等于白做。

• 纯静态站（Hugo/Jekyll/nbdev）：构建期从 front matter 生成，一次产出固定进 HTML，最稳。

• CMS 模板（EyouCMS 等）：写进文章详情模板的 <head> 或 <body> 末尾都行，关键是不要做成"每篇手工粘贴"——模板吐一次，全站生效。

Python 侧如果要批量生成，一个最小工厂函数即可：

def build_video_jsonld(name, desc, thumb, upload, duration, embed, page_url):
    return {
        "@context": "https://schema.org",
        "@type": "VideoObject",
        "name": name,
        "description": desc,
        "thumbnailUrl": thumb,
        "uploadDate": upload,          # "2026-10-20T08:00:00+08:00"
        "duration": duration,          # "PT4M12S"
        "embedUrl": embed,
        "mainEntityOfPage": {"@type": "WebPage", "@id": page_url},
    }

4. 验证：先用本地校验器卡四字段，再上 Rich Results Test

只依赖标准库的校验器，实跑输出如下（2026-11-15）：

字段校验结果：
  contentUrl|embedUrl    PASS
  thumbnailUrl           PASS
  uploadDate             PASS
  duration               PASS
总体: PASS
反例 duration='4分12秒' -> FAIL

核心判断逻辑就三条：contentUrl/embedUrl 至少有一个；thumbnailUrl 非空；uploadDate 能被 date.fromisoformat 解析前 10 位；duration 以 PT 开头且含 H/M/S 之一。反例里把时长写成"4分12秒"会被直接判 FAIL——这类写法在真实站点里非常常见。

本地过完再上 Google Rich Results Test，作为最终资格确认；两者都过，才把链接放进发布清单。

结果：Ichelon Consulting 2026 对照研究

样本口径：640 条印度医疗健康类查询、2025-06-01 至 2026-08-31 的 SERP 抓取，共 3,180 个视频托管页，其中 1,842 个带有效 VideoObject、1,338 个无标记；41% 的样本来自同品牌配对读取（一页有标记、一页没有）以控制频道权威信号。

其余三条结论：

• 章节标记是最高杠杆的五行代码：加了 hasPart + SeekToAction 的页面在 12% 的查询上拿到 Key Moments 标注，没加的是 0%。Key Moments 是目前视频类富结果里点击份额最高的形态。

• 见效速度取决于页面本身权威度：从部署到首次进轮播的中位时间是 9 天；已经排进自然结果前 20 的页面 2–7 天就转；全新页面要 18–34 天。先把已经在排名的老页面补齐，比给新视频做标记快得多。

• YouTube 嵌入略占优：embeds 来自 YouTube 的页面，轮播位置平均比自托管 MP4 高 0.3 位，原因是来源可信度高。自托管不被排除，只是需要更强的内容信号。

口径声明：以上数字来自 Ichelon Consulting Group 公开报告（CC BY 4.0，Das & Ichelon Consulting Group, 2026），为服务商自测、非第三方复现，样本限定在印度医疗健康类查询，不能直接外推到其他行业与语种。本文引用其结构性结论（四字段门槛 + 章节标记价值），具体倍数请按自身行业重新验证。

复盘

三条配置动作：

1. 先审库、后发新：把站内已有视频页拉一遍清单，优先给"已经排进前 20"的页面补标记，见效周期是周级而不是月级。

2. 四字段先过关，再谈增强：embedUrl/contentUrl、1280×720 缩略图、ISO 8601 uploadDate、ISO 8601 duration。四项缺一，资格线就过不去，其他字段写得再全也没用。

3. Top 20% 视频加章节：只给播放量最高的那批加 hasPart，每页五行，成本最低、SERP 形态收益最高。

两条红线（含一条"别这么做"）：

1. 别造假字段：uploadDate 别统一写成"今天"，thumbnailUrl 别指向 1×1 占位图或带水印的站外图。富结果资格会被回收，且属于结构化数据欺骗。

2. 别在一页堆多个 VideoObject 抢同一个视频：同一 URL 在多个页面重复标记、或一个页面用多个 VideoObject 指向不同视频，抓取端无法判定主视频，结果是全部降级。一页一个主视频，其余用 hasPart 归到章节里。

标注

• Schema.org 版本：30.1（2026-09-16 发布），字段与必填项查询于 2026-11-15

• 验证工具与时间：本地四字段校验器（Python 标准库）+ Google Rich Results Test；本地校验 2026-11-15

• 来源：Ichelon Consulting Group《Video Schema and Google Video Carousel Ranking Study 2026》（CC BY 4.0）；Schema.org 30.1 词汇表

• 标签：Schema.org、结构化数据、JSON-LD、AI可见度、GEO、VideoObject