Dados estruturados de vídeo (VideoObject, Clip, BroadcastEvent)

Embora o Google tente entender automaticamente os detalhes do vídeo, é possível marcar o vídeo com VideoObject para influenciar as informações que aparecem nos resultados, como a descrição, o URL da miniatura, a data do upload e a duração. Adicionar dados estruturados de vídeo às suas páginas de exibição também pode facilitar a descoberta do vídeo pelo Google. Os vídeos podem aparecer em vários locais diferentes no Google, incluindo a página principal de resultados da pesquisa, o modo de vídeo, o Imagens do Google e o Google Discover:

Conteúdo de vídeo nos resultados da pesquisa do Google, na guia de vídeo e no Discover

Com base na marcação da página de exibição, seus vídeos também podem se qualificar para os seguintes recursos de vídeo específicos:

Recursos de vídeo

Selo AO VIVO: marque o vídeo com BroadcastEvent para adicionar um selo AO VIVO a ele. O selo AO VIVO pode ser aplicado a vídeos públicos transmitidos ao vivo com qualquer duração. Veja alguns exemplos:

  • Eventos esportivos
  • Premiações
  • Vídeos de influenciadores
  • Jogos com streaming de vídeo ao vivo

Siga as diretrizes do selo AO VIVO e use a API Indexing para garantir que o Google rastreie a página no momento certo.

Vídeos com selo AO VIVO nos resultados da pesquisa

Momentos importantes

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

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

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

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

Vídeo com momentos importantes nos resultados da pesquisa

Como adicionar dados estruturados

Os dados estruturados são um formato padronizado para fornecer informações sobre uma página e classificar o conteúdo dela. Caso você não saiba muito sobre o assunto, veja como os dados estruturados funcionam.

Esta é uma visão geral de como criar, testar e lançar dados estruturados.

  1. Adicione as propriedades obrigatórias. Com base no formato que você está usando, saiba onde inserir dados estruturados na página.
  2. Siga as diretrizes.
  3. Valide o código com o Teste de pesquisa aprimorada e corrija os erros críticos. Corrija também os problemas não críticos que possam ser sinalizados na ferramenta, porque eles podem melhorar a qualidade dos dados estruturados, mas isso não é necessário para se qualificar para pesquisas aprimoradas.
  4. Implante algumas páginas que incluam os dados estruturados e use a Ferramenta de inspeção de URL para testar como o Google vê a página. Verifique se a página está acessível ao Google e se não está bloqueada por um arquivo robots.txt, pela tag noindex ou por requisitos de login. Se estiver tudo certo, peça ao Google para rastrear novamente seus URLs.
  5. Para informar o Google sobre mudanças futuras, recomendamos que você envie um sitemap. É possível automatizar isso com a API Search Console Sitemap.

Exemplos

Resultado de vídeo padrão

Exemplo de resultados padrão da pesquisa de vídeo

Veja um exemplo de um único 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>
Microdados

<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>

Selo AO VIVO

Exemplo de um vídeo nos resultados da pesquisa com um selo AO VIVO

Veja um exemplo de VideoObject e 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>
Microdados

<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

Exemplo de um vídeo nos resultados da pesquisa com Momentos importantes

Veja um exemplo de VideoObject e 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>
Microdados

<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

Veja um exemplo de um único VideoObject que inclui as propriedades adicionais necessárias para a marcação 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>
Microdados

<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>

Diretrizes

Para que os dados estruturados de vídeo se qualifiquem para uso na Pesquisa Google, siga os Fundamentos da Pesquisa, as diretrizes gerais de dados estruturados e os requisitos de indexação de vídeo.

Além disso, recomendamos que você confira estas diretrizes caso elas se apliquem ao conteúdo do seu vídeo:

Diretrizes do selo AO VIVO

Se você quiser adicionar BroadcastEvent para marcar vídeos de transmissões ao vivo, siga estas diretrizes:

  • Não use linguagem vulgar ou possivelmente ofensiva nos dados estruturados.
  • Para garantir que o Google rastreie seu vídeo de transmissão ao vivo no momento certo, use a API Indexing. Chame a API para os seguintes eventos:
    • Quando o vídeo for transmitido ao vivo.
    • Quando o vídeo parar de transmitir e a marcação da página for atualizada para indicar a endDate.
    • Sempre que uma mudança acontecer na marcação e o Google precisar ser notificado.

Práticas recomendadas para fazer marcações de tempo no YouTube

Se o vídeo estiver hospedado no YouTube, é possível que a Pesquisa Google ative os Momentos importantes automaticamente com base na descrição do vídeo. Nesse caso, não será necessário fazer as marcações de tempo específicas. No entanto, é possível que você nos informe mais explicitamente sobre os pontos importantes do vídeo. Nós damos preferência a essas informações. O diagrama a seguir mostra como as marcações de tempo e as etiquetas de uma descrição do YouTube aparecem nos resultados da pesquisa:

Um vídeo com marcações de tempo e etiquetas nos resultados da pesquisa
1. Etiqueta: é o título do clipe.
2. Marcação de tempo: é o momento em que um clipe começa.

Tenha em mente as seguintes diretrizes ao formatar marcações de tempo e etiquetas nas descrições do YouTube:

  • Formate a marcação de tempo desta maneira: [hour]:[minute]:[second]. Se não houver hora, não é necessário incluí-la.
  • Especifique a etiqueta e a marcação de tempo na mesma linha.
  • Coloque cada marcação de tempo em uma nova linha na descrição do vídeo.
  • Vincule a marcação de tempo ao ponto especificado no vídeo.
  • Verifique se a etiqueta contém pelo menos uma palavra.
  • Liste as marcações de tempo em ordem cronológica.

Se você quiser ativar os capítulos de vídeo no YouTube, siga estas diretrizes adicionais.

Diretrizes de Clip e SeekToAction

Ao adicionar dados estruturados Clip ou SeekToAction para marcar segmentos de vídeos, siga estas diretrizes:

  • O vídeo precisa conseguir criar links diretos para um ponto que não seja o início no URL dele. Por exemplo, https://www.example.com/example?t=30 inicia o vídeo 30 segundos depois do começo.
  • Dados estruturados VideoObject precisam ser adicionados a uma página em que os usuários consigam assistir o vídeo. Não direcione os usuários a uma página que não exibe o vídeo.
  • A duração total do vídeo precisa ser de no mínimo 30 segundos.
  • O vídeo precisa incluir as propriedades obrigatórias listadas na documentação de dados estruturados VideoObject.
  • Somente para dados estruturados Clip: confira se não há dois clipes no mesmo vídeo definidos na mesma página e que compartilhem um tempo de início.
  • Somente para dados estruturados SeekToAction: o Google precisa conseguir buscar os arquivos de conteúdo em vídeo.

Definições de tipos de dados estruturados

Esta seção descreve os tipos de dados estruturados relacionados a recursos de vídeo da Pesquisa Google. É necessário incluir as propriedades VideoObject obrigatórias para que o conteúdo seja qualificado para uso na Pesquisa Google. Você também pode incluir as propriedades recomendadas para adicionar mais informações sobre o VideoObject, o que pode proporcionar uma melhor experiência do usuário. Além de VideoObject, também é possível adicionar os seguintes tipos de dados para ativar os aprimoramentos de vídeo na Pesquisa Google:

  • BroadcastEvent: marque vídeos de transmissões ao vivo para incluir um selo AO VIVO neles.
  • Clip: marque segmentos importantes do vídeo para ajudar os usuários a navegar rapidamente até pontos específicos dele.
  • SeekToAction: para ativar os Momentos importantes, indique como a estrutura do URL funciona. Assim o Google poderá identificar automaticamente os Momentos importantes e fornecer aos usuários os links desses pontos do vídeo.

VideoObject

A definição completa de VideoObject está disponível em schema.org/VideoObject (em inglês). Se você não incluir as propriedades obrigatórias, talvez o Google não consiga extrair informações sobre o vídeo. Você também pode incluir as propriedades recomendadas para adicionar mais informações sobre o conteúdo, o que pode proporcionar uma melhor experiência do usuário.

Propriedades obrigatórias
name

Text

É o título do vídeo. Use um texto exclusivo na propriedade name. para cada vídeo no site.
thumbnailUrl

URL repetido

É um URL que aponta para o arquivo de imagem de miniatura exclusivo do vídeo. Siga as diretrizes para imagens de miniaturas.
uploadDate

DateTime

É a data e a hora em que o vídeo foi publicado pela primeira vez, no formato ISO 8601. Recomendamos que você forneça informações de fuso horário. Caso contrário, o padrão vai ser o fuso horário usado pelo Googlebot.
Propriedades recomendadas
contentUrl

URL

Um URL que aponta para os bytes de conteúdo reais do arquivo de vídeo, em um dos tipos de arquivos compatíveis. Não crie um link para a página em que o vídeo está localizado. Ele precisa ser o URL dos bytes de conteúdo real do arquivo de vídeo.

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

Siga nossas práticas recomendadas de vídeo.
description

Text

É a descrição do vídeo. Use um texto exclusivo na propriedade description para cada vídeo no site. As tags HTML são ignoradas.
duration

Duration

É a duração do vídeo, no formato ISO 8601. Por exemplo, PT00H30M5S representa uma duração de "30 minutos e 5 segundos".
embedUrl

URL

É um URL que aponta para um player do vídeo específico. Não crie um link para a página em que o vídeo está localizado. Ele precisa ser o URL do próprio player de vídeo. Geralmente, essa é a informação no atributo src de um elemento <embed>.

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

Siga nossas práticas recomendadas de vídeo.
expires DateTime

Se aplicável, a data e a hora finais em que o vídeo vai estar disponível, no formato ISO 8601. Não forneça essa informação se o vídeo não for expirar. Recomendamos que você forneça informações de fuso horário. Caso contrário, o padrão vai ser o fuso horário usado pelo Googlebot.
hasPart

Se o vídeo tiver segmentos importantes, aninhe as propriedades Clip obrigatórias em seu VideoObject. Exemplo:

<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

É a região em que o vídeo não é permitido, se aplicável. Se não especificado, o Google vai presumir que ele é permitido em qualquer lugar. Especifique os países no formato ISO 3166-1 de duas ou três letras. Para diversos valores, use vários códigos de país (por exemplo, uma matriz JSON-LD ou várias tags meta em microdados).
interactionStatistic

InteractionCounter

É o número de visualizações do vídeo. Exemplo:

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

Se o vídeo estiver sendo transmitido ao vivo e você quiser se qualificar para o selo AO VIVO, aninhe as propriedades BroadcastEvent em VideoObject. Exemplo:

<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

As regiões em que o vídeo é permitido, se aplicável. Se não especificado, o Google vai presumir que ele é permitido em qualquer lugar. Especifique os países no formato ISO 3166-1 de duas ou três letras. Para diversos valores, use vários códigos de país (por exemplo, uma matriz JSON-LD ou várias tags meta em microdados).

BroadcastEvent

Para se qualificar para exibição com um selo AO VIVO, aninhe as seguintes propriedades em VideoObject. Ainda que as propriedades BroadcastEvent não sejam obrigatórias, você precisa incluir as propriedades a seguir para que o vídeo se qualifique para ser exibido com um selo AO VIVO.

A definição completa de BroadcastEvent está disponível em schema.org/BroadcastEvent (em inglês).

Propriedades obrigatórias
publication

BroadcastEvent

Descreve quando o vídeo será transmitido ao vivo. Pode ser uma lista ou uma única instância.
publication.endDate

DateTime

É a hora e a data de quando a transmissão ao vivo termina, ou está prevista para terminar, no formato ISO 8601.

É necessário fornecer endDate quando o vídeo terminar e não estiver mais ativo. Se a endDate esperada for desconhecida antes do início da transmissão ao vivo, recomendamos fornecer uma endDate aproximada.

Se a endDate estiver no passado ou presente, ela indica que a transmissão terminou e não está mais ao vivo. Se a endDate estiver no futuro, ela indica que a transmissão está programada para terminar naquele momento.
publication.isLiveBroadcast

Booleano

Defina como true se o vídeo for, tiver sido ou será transmitido ao vivo.

publication.startDate

DateTime

Hora e data de início ou início previsto da transmissão ao vivo, no formato ISO 8601. Se a startDate estiver no passado ou presente, ela indica que a transmissão começou. Se a startDate estiver no futuro, ela vai indicar que a transmissão está programada para começar naquele momento.

Clip

Para informar ao Google a marcação de tempo e a etiqueta a serem usadas no recurso Momentos importantes, aninhe as seguintes propriedades em VideoObject. Ainda que as propriedades Clip não sejam obrigatórias, é preciso incluir as seguintes propriedades para que o Google exiba as etiquetas e as marcações de tempo especificadas para o vídeo, em vez dos segmentos de vídeo que podem ser exibidos automaticamente.

A definição completa de Clip está disponível em schema.org/Clip (em inglês).

Propriedades obrigatórias
name

Text

É um título que descreve o conteúdo do clipe.
startOffset

Number

É o tempo de início do clipe expresso como o número em segundos depois do início da obra.
url

URL

É um URL que aponta para o tempo de início do clipe.

O URL do clipe precisa apontar para o mesmo caminho do URL que o vídeo com parâmetros de consulta adicionais que especificam o tempo.

Por exemplo, o URL a seguir significa que o vídeo começa aos dois minutos:

"url": "https://www.example.com/example?t=120"
Propriedades recomendadas
endOffset

Number

É o tempo de término do clipe exibido como o número em segundos depois do início da obra.

SeekToAction

Se quiser informar ao Google como sua estrutura de URL funciona, para que ele possa exibir Momentos importantes identificados automaticamente no vídeo, aninhe as seguintes propriedades em VideoObject. Ainda que as propriedades SeekToAction não sejam obrigatórias, você precisa incluir as propriedades a seguir para que o Google entenda como funciona a estrutura do URL e possa fornecer aos usuários links de um ponto do vídeo.

A definição completa de SeekToAction está disponível em schema.org/SeekToAction (em inglês).

Propriedades obrigatórias
potentialAction

SeekToAction

Indica uma possível ação. Inclui as seguintes propriedades aninhadas:

Exemplo:

{
  "@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

É a string do marcador que o Google identificará como a estrutura de marcação de tempo e substituirá pelo número de segundos para pular. Use o seguinte valor:

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

startOffset-input é uma propriedade com anotação. Consulte a página Potential Actions para mais informações.

potentialAction.target

EntryPoint

É o URL da página que contém este VideoObject, incluindo um marcador na estrutura do URL que indica onde o Google pode inserir o número de segundos para pular no vídeo. É assim que o Google entende a estrutura do URL e como você formata as marcações de tempo. Substitua a parte da marcação de tempo do URL pela seguinte string de marcador:

{seek_to_second_number}

Por exemplo, substitua a parte da marcação de tempo do URL: 

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

Agora a marcação de tempo tem a seguinte aparência:

"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 自动提取这些结果。

Solução de problemas

Se você tiver problemas para implementar ou depurar dados estruturados, veja alguns recursos que podem ajudar.