视频（VideoObject、Clip、BroadcastEvent）结构化数据

虽然 Google 会尝试自动了解视频的详细信息，但是您可以使用 VideoObject 标记视频，以影响视频结果中显示的信息，例如说明、缩略图网址、上传日期和时长。将视频结构化数据添加到观看页面，还可以让 Google 更轻松地找到您的视频。视频可以显示在 Google 上的多个不同位置，其中包括主搜索结果页、视频模式、Google 图片和 Google 探索。

Google 搜索结果、视频标签页和 Google 探索中的视频内容

根据您对观看页面的标记方式，您的视频还可能符合以下特定视频功能的使用条件：

视频功能

“LIVE”徽章：使用 BroadcastEvent 标记您的视频，为视频添加“LIVE”徽章。“LIVE”徽章可应用于任何时长的公开直播视频。以下是一些示例：

  • 体育赛事
  • 颁奖典礼
  • 网红视频
  • 直播视频游戏

确保遵循“LIVE”徽章指南，并使用 Indexing API 以确保 Google 在正确的时间抓取您的网页。

带有“LIVE”徽章的视频搜索结果

重要时刻

“重要时刻”功能是一种视频浏览方式，能让用户像翻看图书章节那样在视频片段间跳转，有助于用户更深入地与您的内容互动。Google 搜索会尝试自动检测视频中的片段，并向用户显示重要时刻，您无需采取任何措施。或者，您也可以手动告知 Google 视频中的重要时间点。我们将优先显示您通过结构化数据或 YouTube 说明设置的重要时刻。

  • 如果您的视频托管在您的网页上，您可以通过以下两种方式启用重要时刻功能：
    • Clip 结构化数据：指定每个片段确切的起点和终点，以及要为每个片段显示的标签。此方式适用于 Google 搜索支持的所有语言。
    • SeekToAction 结构化数据：告知 Google 时间戳通常位于网址结构中的什么位置，以便 Google 可以自动识别重要时刻，并将用户链接到视频中的这些时间点。 目前支持以下语言：英语、西班牙语、葡萄牙语、意大利语、中文、法语、日语、德语、土耳其语、韩语、荷兰语和俄语。我们的目标是逐步将此功能扩展到更多语言。即使是对于受支持的语言，并非所有视频都会标出重要时刻，但我们希望随着时间的推移也能改善这一功能。
  • 如果您的视频托管在 YouTube 上，您可以在 YouTube 上的视频说明中指定确切的时间戳和标签。请查看在 YouTube 说明中标记时间戳的最佳实践。此方式适用于 Google 搜索支持的所有语言。

    如果您想在 YouTube 上启用视频章节功能，请遵循这些其他指南。

若要完全停用“重要时刻”功能（包括 Google 为了自动为您的视频显示重要时刻而付出的所有努力），请使用 nosnippet meta 标记。

带有重要时刻的视频搜索结果

如何添加结构化数据

结构化数据是一种提供网页相关信息并对网页内容进行分类的标准化格式。如果您不熟悉结构化数据，可以详细了解结构化数据的运作方式。

下面概述了如何构建、测试和发布结构化数据。如需获得向网页添加结构化数据的分步指南，请查看结构化数据 Codelab。

  1. 添加必要属性。根据您使用的格式，了解在网页上的什么位置插入结构化数据。
  2. 遵循指南。
  3. 使用富媒体搜索结果测试验证您的代码，并修复所有严重错误。此外，您还可以考虑修正该工具中可能会标记的任何非严重问题，因为这些这样有助于提升结构化数据的质量（不过，要使内容能够显示为富媒体搜索结果，并非必须这么做）。
  4. 部署一些包含您的结构化数据的网页，然后使用网址检查工具测试 Google 看到的网页样貌。请确保您的网页可供 Google 访问，不会因 robots.txt 文件、noindex 标记或登录要求而被屏蔽。如果网页看起来没有问题，您可以请求 Google 重新抓取您的网址。
  5. 为了让 Google 随时了解日后发生的更改，我们建议您提交站点地图。Search Console Sitemap API 可以帮助您自动执行此操作。

示例

标准视频搜索结果

标准视频搜索结果示例

下面是一个 VideoObject 示例。

JSON-LD

<html>
  <head>
    <title>Introducing the self-driving bicycle in the Netherlands</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "VideoObject",
      "name": "Introducing the self-driving bicycle in the Netherlands",
      "description": "This spring, Google is introducing the self-driving bicycle in Amsterdam, the world's premier cycling city. The Dutch cycle more than any other nation in the world, almost 900 kilometres per year per person, amounting to over 15 billion kilometres annually. The self-driving bicycle enables safe navigation through the city for Amsterdam residents, and furthers Google's ambition to improve urban mobility with technology. Google Netherlands takes enormous pride in the fact that a Dutch team worked on this innovation that will have great impact in their home country.",
      "thumbnailUrl": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
      "uploadDate": "2024-03-31T08:00:00+08:00",
      "duration": "PT1M54S",
      "contentUrl": "https://www.example.com/video/123/file.mp4",
      "embedUrl": "https://www.example.com/embed/123",
      "interactionStatistic": {
        "@type": "InteractionCounter",
        "interactionType": { "@type": "WatchAction" },
        "userInteractionCount": 5647018
      },
      "regionsAllowed": ["US", "NL"]
    }
    </script>
  </head>
  <body>
  </body>
</html>
微数据

<html itemscope itemprop="VideoObject" itemtype="https://schema.org/VideoObject">
<head>
  <title itemprop="name">Introducing the self-driving bicycle in the Netherlands</title>
</head>
<body>
  <meta itemprop="uploadDate" content="2024-03-31T08:00:00+08:00" />
  <meta itemprop="duration" content="PT1M54S" />
  <p itemprop="description">This spring, Google is introducing the self-driving bicycle in Amsterdam, the world's premier cycling city. The Dutch cycle more than any other nation in the world, almost 900 kilometres per year per person, amounting to over 15 billion kilometres annually. The self-driving bicycle enables safe navigation through the city for Amsterdam residents, and furthers Google's ambition to improve urban mobility with technology. Google Netherlands takes enormous pride in the fact that a Dutch team worked on this innovation that will have great impact in their home country.</p>
  <div itemprop="interactionStatistic" itemtype="https://schema.org/InteractionCounter" itemscope>
    <meta itemprop="userInteractionCount" content="5647018" />
    <meta itemprop="interactionType" itemtype="https://schema.org/WatchAction" />
  </div>
  <link itemprop="embedUrl" href="https://www.example.com/embed/123" />
  <meta itemprop="contentUrl" content="https://www.example.com/video/123/file.mp4" />
  <meta itemprop="regionsAllowed" content="US" />
  <meta itemprop="regionsAllowed" content="NL" />
  <meta itemprop="thumbnailUrl" content="https://example.com/photos/1x1/photo.jpg" />
</body>
</html>

“LIVE”徽章

搜索结果中带有“LIVE”徽章的视频示例

下面是 VideoObject 和 BroadcastEvent 的示例。

JSON-LD

<html>
  <head>
    <title>Bald Eagle at the Park - Livestream</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "VideoObject",
      "contentURL": "https://example.com/bald-eagle-at-the-park.mp4",
      "description": "Bald eagle at the park livestream.",
      "duration": "PT37M14S",
      "embedUrl": "https://example.com/bald-eagle-at-the-park",
      "expires": "2024-10-30T14:37:14+00:00",
      "regionsAllowed": "US",
      "interactionStatistic": {
        "@type": "InteractionCounter",
        "interactionType": { "@type": "WatchAction" },
        "userInteractionCount": 4756
      },
      "name": "Bald eagle nest livestream!",
      "thumbnailUrl": "https://example.com/bald-eagle-at-the-park",
      "uploadDate": "2024-10-27T14:00:00+00:00",
      "publication": [
        {
          "@type": "BroadcastEvent",
          "isLiveBroadcast": true,
          "startDate": "2024-10-27T14:00:00+00:00",
          "endDate": "2024-10-27T14:37:14+00:00"
        },
        {
          "@type": "BroadcastEvent",
          "isLiveBroadcast": true,
          "startDate": "2024-10-27T18:00:00+00:00",
          "endDate": "2024-10-27T18:37:14+00:00"
        }
      ]
    }
    </script>
  </head>
  <body>
  </body>
</html>
微数据

<html itemscope itemprop="VideoObject" itemtype="https://schema.org/VideoObject">
<head>
  <title itemprop="name">Bald Eagle at the Park - Livestream</title>
</head>
<body>
  <meta itemprop="uploadDate" content="2024-10-27T14:00:00+00:00" />
  <meta itemprop="duration" content="PT37M14S" />
  <p itemprop="description">Bald eagle at the park livestream.</p>
  <div itemprop="interactionStatistic" itemtype="https://schema.org/InteractionCounter" itemscope>
    <meta itemprop="userInteractionCount" content="4756" />
    <meta itemprop="interactionType" itemtype="https://schema.org/WatchAction" />
  </div>
  <link itemprop="embedUrl" href="https://example.com/bald-eagle-at-the-park" />
  <meta itemprop="expires" content="2024-10-30T14:37:14+00:00" />
  <meta itemprop="contentUrl" content="https://example.com/bald-eagle-at-the-park.mp4" />
  <meta itemprop="regionsAllowed" content="US" />
  <meta itemprop="thumbnailUrl" content="https://example.com/bald-eagle-at-the-park" />
  <div itemprop="publication" itemtype="https://schema.org/BroadcastEvent" itemscope>
    <meta itemprop="isLiveBroadcast" content="true" />
    <meta itemprop="startDate" content="2024-10-27T14:00:00+00:00" />
    <meta itemprop="endDate" content="2024-10-27T14:37:14+00:00" />
  </div>
  <div itemprop="publication" itemtype="https://schema.org/BroadcastEvent" itemscope>
    <meta itemprop="isLiveBroadcast" content="true" />
    <meta itemprop="startDate" content="2024-10-27T18:00:00+00:00" />
    <meta itemprop="endDate" content="2024-10-27T18:37:14+00:00" />
  </div>
</body>
</html>

Clip

带有重要时刻的视频搜索结果示例

下面是 VideoObject 和 Clip 的示例。

JSON-LD

<html>
  <head>
    <title>Cat jumps over the fence</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "VideoObject",
      "name": "Cat video",
      "duration": "PT10M",
      "uploadDate": "2024-07-19T08:00:00+08:00",
      "thumbnailUrl": "https://www.example.com/cat.jpg",
      "description": "Watch this cat jump over a fence!",
      "contentUrl": "https://www.example.com/cat_video_full.mp4",
      "ineligibleRegion": "US",
      "hasPart": [{
        "@type": "Clip",
        "name": "Cat jumps",
        "startOffset": 30,
        "endOffset": 45,
        "url": "https://www.example.com/example?t=30"
      },
      {
        "@type": "Clip",
        "name": "Cat misses the fence",
        "startOffset": 111,
        "endOffset": 150,
        "url": "https://www.example.com/example?t=111"
      }]
    }
    </script>
  </head>
  <body>
  </body>
</html>
微数据

<html itemscope itemprop="VideoObject" itemtype="https://schema.org/VideoObject">
<head>
  <title itemprop="name">Cat jumps over the fence</title>
</head>
<body>
  <meta itemprop="uploadDate" content="2024-07-19" />
  <meta itemprop="duration" content="P10M" />
  <p itemprop="description">Watch this cat jump over a fence!</p>
  <div itemprop="interactionStatistic" itemtype="https://schema.org/InteractionCounter" itemscope>
    <meta itemprop="userInteractionCount" content="5647018" />
    <meta itemprop="interactionType" itemtype="https://schema.org/WatchAction" />
  </div>
  <div itemprop="hasPart" itemtype="https://schema.org/Clip" itemscope>
    <meta itemprop="name" content="Cat jumps" />
    <meta itemprop="startOffset" content="30" />
    <meta itemprop="endOffset" content="45" />
    <meta itemprop="url" content="https://www.example.com/example?t=30" />
  </div>
  <div itemprop="hasPart" itemtype="https://schema.org/Clip" itemscope>
    <meta itemprop="name" content="Cat misses the fence" />
    <meta itemprop="startOffset" content="111" />
    <meta itemprop="endOffset" content="150" />
    <meta itemprop="url" content="https://www.example.com/example?t=111" />
  </div>
  <link itemprop="embedUrl" href="https://www.example.com/embed/123" />
  <meta itemprop="contentUrl" content="https://www.example.com/cat_video_full.mp4" />
  <meta itemprop="ineligibleRegion" content="US" />
  <meta itemprop="thumbnailUrl" content="https://www.example.com/cat.jpg" />
</body>
</html>

SeekToAction

下面是一个 VideoObject 的示例，其中包含 SeekToAction 标记所需的其他属性。

JSON-LD

<html>
  <head>
    <title>John Smith (@johnsmith123) on VideoApp: My daily workout! #stayingfit</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "VideoObject",
      "potentialAction" : {
        "@type": "SeekToAction",
        "target": "https://video.example.com/watch/videoID?t={seek_to_second_number}",
        "startOffset-input": "required name=seek_to_second_number"
      },
      "name": "My daily workout!",
      "uploadDate": "2024-07-19T08:00:00+08:00",
      "thumbnailUrl": "https://www.example.com/daily-workout.jpg",
      "description": "My daily workout!",
      "embedUrl": "https://example.com/daily-workout"
    }
    </script>
  </head>
  <body>
  </body>
</html>
微数据

<html itemscope itemprop="VideoObject" itemtype="https://schema.org/VideoObject">
<head>
  <title itemprop="name">John Smith (@johnsmith123) on VideoApp: My daily workout! #stayingfit</title>
</head>
<body>
  <meta itemprop="uploadDate" content="2024-07-19" />
  <p itemprop="description">My daily workout!</p>
  <div itemprop="potentialAction" itemtype="https://schema.org/SeekToAction" itemscope>
    <meta itemprop="target" content="https://video.example.com/watch/videoID?t={seek_to_second_number}" />
    <meta itemprop="startOffset-input" content="required name=seek_to_second_number" />
  </div>
  <link itemprop="embedUrl" href="https://example.com/daily-workout" />
  <meta itemprop="thumbnailUrl" content="https://www.example.com/daily-workout.jpg" />
</body>
</html>

指南

为了让您的视频结构化数据能显示在 Google 搜索结果中，您必须遵循搜索要素、结构化数据常规指南和视频索引编制要求。

此外，如果这些指南适用于您的视频内容，我们建议您查看这些指南：

“LIVE”徽章指南

如果您将 BroadcastEvent 添加到直播视频，请遵循以下指南：

  • 不要在结构化数据中使用粗俗或可能有攻击性的语言。
  • 为了确保 Google 在正确的时间抓取您的直播视频，请使用 Indexing API。您可为以下事件调用此 API：
    • 当视频上线时
    • 当视频已停止在线播放且网页的标记已更新为指示 endDate 时
    • 每当标记发生更改且需要通知 Google 时

在 YouTube 上标记时间戳的最佳做法

如果您的视频托管在 YouTube 上，Google 搜索可能会根据 YouTube 上的视频说明自动为您的视频启用重要时刻，而您不必在 YouTube 说明中标记特定时间戳。不过，您可以更明确地告诉我们视频中的重要时间点，我们会优先获取这些信息。下图显示了 YouTube 视频说明中的时间戳和标签在搜索结果中的显示效果：

带有时间戳和标签的视频搜索结果
1. 标签：剪辑的名称。
2. 时间戳：剪辑开始时间。

在为 YouTube 说明设置时间戳和标签格式时，请注意以下指南：

  • 按照以下格式设置时间戳：[hour]:[minute]:[second]。如果没有小时，则无需添加小时。
  • 在时间戳所在的行中指定时间戳的标签。
  • 在视频说明中另起一行放置每个时间戳。
  • 将时间戳与视频中的指定点相关联。
  • 确保标签至少包含一个字词。
  • 按时间顺序列出时间戳。

如果您想在 YouTube 上启用视频章节功能，请遵循这些其他指南。

Clip 和 SeekToAction 指南

如果您添加 Clip 或 SeekToAction 结构化数据来标记视频片段，请遵循以下指南：

  • 视频必须能够深层链接到视频网址中视频起点之外的某个点。例如，https://www.example.com/example?t=30 可从视频的 30 秒处开始播放。
  • VideoObject 结构化数据必须添加到能让用户观看视频的网页中。将用户引导至无法观看视频的网页会导致糟糕的用户体验。
  • 视频总时长必须至少为 30 秒。
  • 视频必须包含 VideoObject 结构化数据文档中列出的必需属性。
  • 仅适用于 Clip 结构化数据：确保在同一网页上定义的同一视频中没有任何两个剪辑的开始时间相同。
  • 仅适用于 SeekToAction 结构化数据：Google 必须能够提取您的视频内容文件。

结构化数据类型定义

本部分介绍了与 Google 搜索中的视频功能相关的结构化数据类型。 若要使您的标记能够在 Google 搜索中使用，您必须为其添加必需 VideoObject 属性。您还可添加建议属性，以便添加与 VideoObject 相关的更多信息，进而提供更优质的用户体验。除了 VideoObject 属性之外，您还可添加以下数据类型，以便在 Google 搜索中启用视频增强功能：

  • BroadcastEvent：标记直播视频，为视频启用“LIVE”徽章。
  • Clip：在视频中标记重要片段，以帮助用户快速浏览到视频中的特定点。
  • SeekToAction：通过指明网址结构来启用重要时刻，以便 Google 可以自动识别重要时刻，并将用户链接到视频中的这些时间点。

VideoObject

如需了解 VideoObject 的完整定义，请访问 schema.org/VideoObject。 如果您不添加必需属性，Google 可能无法提取视频的任何相关信息。还有一些建议添加的属性，能帮助您添加更多与您的内容相关的信息，进而提供更好的用户体验。

必要属性
name

Text

视频标题。请务必在 name 属性中为网站上的每个视频使用唯一的文本。
thumbnailUrl

重复 URL

指向视频独一无二的缩略图文件的网址。请遵循