Структурированные данные для видео (VideoObject, Clip, BroadcastEvent)

Наши алгоритмы пытаются автоматически извлечь информацию о ваших роликах, однако вы можете использовать тип VideoObject, чтобы указать, что должно отображаться в результатах поиска видео: URL значка видео, описание ролика, данные о его продолжительности и дате загрузки и т. д. Благодаря структурированным данным на страницах просмотра нашим алгоритмам проще находить видео. Видео могут появляться на главной странице результатов поиска, а также в результатах поиска видео, Google Картинках и рекомендациях Google.

Видеоконтент в результатах поиска Google, на вкладке "Видео" и в рекомендациях

С помощью специальной разметки вы можете сделать представление видео в результатах поиска ещё более удобным и информативным.

Функции для обработки видео

Пометка "Прямой эфир". Чтобы рядом с видео появлялась пометка "Прямой эфир", достаточно добавить для него свойство BroadcastEvent. Эту пометку можно добавить к любой общедоступной трансляции, независимо от ее продолжительности. Вот некоторые примеры видео, к которым можно добавить такую пометку:

  • спортивные мероприятия;
  • церемонии вручения наград;
  • видео инфлюенсеров;
  • прямые трансляции видеоигр.

Чтобы роботы Google своевременно сканировали вашу страницу, соблюдайте специальные требования и пользуйтесь Indexing API.

Видео с пометкой "Прямой эфир" в результатах поиска

Ключевые моменты

“重要时刻”功能是一种视频浏览方式，能让用户像翻看图书章节那样在视频片段间跳转，有助于用户更深入地与您的内容互动。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>

Пометка "Прямой эфир"

Пример видео с пометкой &quot;Прямой эфир&quot; в результатах поиска

Примеры элементов 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>

Правила

Структурированные данные для видео должны соответствовать требованиям, изложенным в руководствах Главное о Поиске, Общие рекомендации по использованию структурированных данных и Какие видео можно проиндексировать.

Кроме того, рекомендуем ознакомиться с указанными ниже рекомендациями, если они применимы к вашему видеоконтенту:

Правила в отношении пометки "Прямой эфир"

Если вы добавляете свойство BroadcastEvent в видео прямой трансляции, соблюдайте приведенные ниже правила.

  • В структурированных данных не должно быть грубых или потенциально оскорбительных выражений.
  • Воспользуйтесь Indexing API, чтобы робот Google своевременно просканировал вашу прямую трансляцию. Вызывать API нужно при следующих событиях:
    • Начало трансляции видео.
    • Прекращение трансляции и обновление разметки страницы для указания времени окончания (endDate).
    • Изменение разметки, о котором необходимо сообщить Google.

Рекомендации по установке временных меток на YouTube

Если видео размещено на YouTube, то его ключевые моменты могут быть автоматически показаны в Google Поиске (они берутся из описания). При этом нет необходимости задавать временные метки в описании видео на YouTube. Вы также можете явным образом указать на важные моменты в видео, и эти сведения будут считаться приоритетными. В примере ниже показано, как в результатах поиска могут выглядеть временные метки и ярлыки из описания видео на YouTube.

Видео с временными метками и ярлыками в результатах поиска
1. Ярлык. Название фрагмента.
2. Временная метка. Время начала фрагмента.

При оформлении временных меток и ярлыков в описаниях к видео на YouTube учитывайте следующее:

  • Временная метка должна иметь формат [hour]:[minute]:[second]. Для значений менее 1 часа указывать час не нужно.
  • Каждый ярлык должен находиться на той же строке, что и временная метка, к которой он относится.
  • Каждая временная метка должна быть указана в отдельной строке описания.
  • Каждая временная метка должна быть связана с определенным эпизодом в видео.
  • В ярлыке должно быть хотя бы одно слово.
  • Временные метки необходимо перечислять в хронологическом порядке.

Чтобы включить разделение видео YouTube на эпизоды, следуйте этим дополнительным рекомендациям.

Правила в отношении структурированных данных Clip и SeekToAction

Если вы размечаете видеосегменты с помощью структурированных данных Clip или SeekToAction, соблюдайте приведенные ниже правила.

  • В URL видео должна быть предусмотрена возможность указывать ссылки на его фрагменты, а не только на начало ролика. Пример фрагмента, начинающегося через 30 секунд после начала видео: https://www.example.com/example?t=30.
  • На страницу, где пользователи могут посмотреть видео, необходимо добавить структурированные данные VideoObject. Не направляйте посетителей на страницу, где видео недоступно.
  • Общая продолжительность видео должна быть не менее 30 секунд.
  • Для видео нужно указать обязательные свойства, перечисленные в документации по структурированным данным VideoObject.
  • Только для структурированных данных Clip. На одной странице не должно быть двух фрагментов одного видео с одинаковым временем начала.
  • Только для структурированных данных SeekToAction. У Google должен быть доступ к вашему видеоконтенту.

Типы структурированных данных

В этом разделе описаны типы структурированных данных, связанные с функциями для видео, которые поддерживаются в Google Поиске. Чтобы ваш контент мог появляться в результатах поиска Google, необходимо задать обязательные свойства разметки VideoObject. Для удобства пользователей мы советуем также задать и рекомендуемые свойства VideoObject. Помимо VideoObject, вы также можете добавить следующие типы данных, чтобы улучшить результаты, представленные в Google Поиске:

  • BroadcastEvent: разметка для показа прямых трансляций с пометкой "Прямой эфир".
  • Clip: разметка для видео, которая позволяет быстро переходить к нужному фрагменту ролика.
  • SeekToAction: информация о структуре ваших URL, позволяющая алгоритмам Google автоматически определять ключевые моменты и направлять зрителей к определенным фрагментам видео.

VideoObject

Полное описание типа VideoObject приведено на странице schema.org/VideoObject. Если не указать все обязательные свойства, у роботов Google могут возникнуть трудности с извлечением информации о видео. Вы также можете добавить рекомендуемые свойства, чтобы предоставить пользователям более полную информацию о вашем контенте.

Обязательные свойства
name

Text

Название видео. Старайтесь, чтобы у каждого ролика был уникальный текст в свойстве name.
thumbnailUrl

Повторно используемое свойство URL

URL файла с уникальным значком видео. Следуйте правилам в отношении таких значков.
uploadDate

DateTime

Дата и время, когда видео было впервые размещено, в формате ISO 8601. Мы рекомендуем указать информацию о часовом поясе, иначе по умолчанию будет задан часовой пояс, который используется роботом Googlebot.
Рекомендуемые свойства
contentUrl

URL

URL файла видео, представленного в одном из поддерживаемых типов. Указывайте не ссылку на страницу, где размещено видео, а URL самого видеофайла.

"contentUrl": "https://www.example.com/video/123/file.mp4"

Соблюдайте рекомендации по работе с видео.
description

Text

Описание видео. Старайтесь, чтобы у каждого ролика был уникальный текст в свойстве description. Теги HTML игнорируются.
duration

Duration

Продолжительность видео в формате ISO 8601. Например, значение PT00H30M5S соответствует продолжительности 30 минут 5 секунд.
embedUrl

URL

URL проигрывателя, предназначенного для показа определенного видео. Вы должны привести здесь не ссылку на страницу, где размещено видео, а URL самого видеопроигрывателя. Обычно эта информация указывается в атрибуте src элемента <embed>.

"embedUrl": "https://www.example.com/embed/123"

Соблюдайте рекомендации по работе с видео.
expires DateTime

Дата и время, после которых видео будет недоступным, в формате ISO 8601 (если применимо). Если вы не планируете прекращать показ ролика через определенное время, эту информацию указывать не требуется. Мы рекомендуем указать информацию о часовом поясе, иначе по умолчанию будет задан часовой пояс, который используется роботом Googlebot.
hasPart

Если в видео есть важные сегменты, добавьте обязательные свойства Clip в VideoObject. Пример:

<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "VideoObject",
  "name": "Cat video",
  "hasPart": {
    "@type": "Clip",
    "name": "Cat jumps",
    "startOffset": 30,
    "url": "https://www.example.com/example?t=30"
  }
}
</script>
ineligibleRegion

Place

Регион, в котором видео запрещено. Если регионы не указаны, будет считаться, что видео разрешено везде. Страны необходимо указывать в в двух- или трехбуквенном формате ISO 3166. Если значений несколько, используйте несколько кодов страны, например массив JSON-LD или несколько тегов meta в формате микроданных.
interactionStatistic

InteractionCounter

Количество просмотров конкретного видео. Пример:

"interactionStatistic":
  {
    "@type": "InteractionCounter",
    "interactionType": { "@type": "WatchAction" },
    "userInteractionCount": 12345
  }
publication

Если вы планируете провести стрим и хотите использовать пометку "Прямой эфир", добавьте свойства BroadcastEvent в VideoObject. Пример:

<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "VideoObject",
  "name": "Cat video",
  "publication": {
    "@type": "BroadcastEvent",
    "name": "First scheduled broadcast",
    "isLiveBroadcast": true,
    "startDate": "2018-10-27T14:00:00+00:00",
    "endDate": "2018-10-27T14:37:14+00:00"
  }
}
</script>
regionsAllowed

Place

Регионы, в которых видео разрешено, если применимо. Если регионы не указаны, будет считаться, что видео разрешено везде. Страны необходимо указывать в в двух- или трехбуквенном формате ISO 3166. Если значений несколько, используйте несколько кодов страны, например массив JSON-LD или несколько тегов meta в формате микроданных.

BroadcastEvent

Чтобы видео можно было показывать с пометкой "Прямой эфир", необходимо добавить в VideoObject указанные ниже свойства. Свойства BroadcastEvent не являются обязательными, но перечисленные ниже свойства необходимо добавить, чтобы видео показывалось с пометкой "Прямой эфир".

Полное описание типа BroadcastEvent приведено на странице schema.org/BroadcastEvent.

Обязательные свойства
publication

BroadcastEvent

Время начала прямой трансляции видео. Можно указать одно значение или список.
publication.endDate

DateTime

Дата и время известного или предполагаемого окончания трансляции в формате ISO 8601.

Свойство endDate необходимо добавить, если прямая трансляция уже завершена. Если точная дата окончания endDate неизвестна заранее, укажите примерное значение endDate.

Если endDate соответствует прошедшей или текущей дате, значит прямая трансляция завершилась. Если дата endDate ещё не наступила, значит прямая трансляция должна завершиться в указанное время.
publication.isLiveBroadcast

Boolean

Укажите значение true, если видео передается как прямая трансляция, транслировалось ранее или будет транслироваться позже.
publication.startDate

DateTime

Дата и время известного или предполагаемого начала прямой трансляции в формате ISO 8601. Если startDate соответствует прошедшей или текущей дате, значит прямая трансляция уже началась. Если дата startDate ещё не наступила, значит прямая трансляция должна начаться в указанное время.

Clip

Чтобы вручную указать, какие временные метки и названия использовать для функции "Ключевые моменты", добавьте в объект VideoObject перечисленные ниже свойства. Добавлять свойства Clip необязательно, однако это необходимо, если вы хотите, чтобы в Google показывались заданные вами временные метки и их названия, а не моменты, которые были подобраны для вашего видео автоматически.

Полное описание типа Clip приведено на странице schema.org/Clip.

Обязательные свойства
name

Text

Описательное название, отражающее содержание клипа.
startOffset

Number

Время начала фрагмента, указанное в секундах с начала видео.
url

URL

Ссылка на время начала фрагмента.

URL фрагмента должен иметь тот же путь URL, что и видео, и содержать параметр, указывающий начало фрагмента.

Например, из этого URL видно, что фрагмент начинается через две минуты (120 секунд) после начала видео:

"url": "https://www.example.com/example?t=120"
Рекомендуемые свойства
endOffset

Number

Время окончания фрагмента, указанное в секундах с начала видео.

SeekToAction

Чтобы сообщить Google, как интерпретировать ваши URL (для автоматического определения ключевых моментов видео), добавьте в объект VideoObject перечисленные ниже свойства. Добавлять свойства SeekToAction необязательно, однако это нужно делать, если вы хотите, чтобы система Google понимала структуру ваших URL и направляла зрителей к определенным частям видео.

Полное описание типа SeekToAction приведено на странице schema.org/SeekToAction.

Обязательные свойства
potentialAction

SeekToAction

Обозначает возможное действие. Добавьте следующие вложенные свойства:

Пример: 

{
  "@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"
  }
}
potentialAction.startOffset-input

Text

Строка-плейсхолдер, которую Google использует в качестве временной метки и заменяет на количество секунд видео, которые необходимо пропустить. Укажите следующее значение:

"startOffset-input": "required name=seek_to_second_number"

startOffset-input представляет собой свойство с аннотацией. Более подробная информация доступна на странице Potential Actions.

potentialAction.target

EntryPoint

URL страницы с объектом VideoObject, содержащий плейсхолдер, который определяет, куда Google будет подставлять количество пропускаемых секунд видео. Так Google распознаёт структуру ваших URL и формат временных меток. Замените часть URL, выступающую в роли временной метки, на следующую строку-плейсхолдер:

{seek_to_second_number}

Предположим, URL с временной меткой имеет следующий вид: 

"target": "https://video.example.com/watch/videoID?t=30"

В этом случае свойство должно иметь следующее значение:

"target": "https://video.example.com/watch/videoID?t={seek_to_second_number}"

使用 Search Console 监控富媒体搜索结果

Search Console 是一款工具，可帮助您监控网页在 Google 搜索结果中的显示效果。即使没有注册 Search Console，您的网页也可能会显示在 Google 搜索结果中，但注册 Search Console 能够帮助您了解 Google 如何查看您的网站并做出相应的改进。建议您在以下情况下查看 Search Console：

  1. 首次部署结构化数据后
  2. 发布新模板或更新代码后
  3. 定期分析流量时

首次部署结构化数据后

等 Google 将网页编入索引后，请在相关的富媒体搜索结果状态报告中查看是否存在问题。 理想情况下，有效项目数量会增加，而无效项目数量不会增加。如果您发现结构化数据存在问题，请执行以下操作：

  1. 修正无效项目。
  2. 检查实际网址，核实问题是否仍然存在。
  3. 使用状态报告请求验证。

发布新模板或更新代码后

如果对网站进行重大更改，请监控结构化数据无效项目的增幅。
  • 如果您发现无效项目增多了，可能是因为您推出的某个新模板无法正常工作，或者您的网站以一种新的错误方式与现有模板交互。
  • 如果您发现有效项目减少了（但无效项目的增加情况并不对应），可能是因为您的网页中未再嵌入结构化数据。请通过网址检查工具了解导致此问题的原因。

定期分析流量时

请使用效果报告分析您的 Google 搜索流量。数据将显示您的网页在 Google 搜索结果中显示为富媒体搜索结果的频率、用户点击该网页的频率以及网页在搜索结果中的平均排名。您还可以使用 Search Console API 自动提取这些结果。

Устранение неполадок

Если у вас возникли трудности с добавлением или отладкой структурированных данных, вам помогут ресурсы и сведения, доступные по приведенным ниже ссылкам.