Vidéo

Balisez votre contenu vidéo avec des données structurées pour permettre aux internautes de découvrir et de regarder des vidéos à partir de la recherche Google. Vous pouvez indiquer des informations telles que la description, l'URL de la vignette, la date de transfert et la durée en balisant votre vidéo avec VideoObject. Vous pouvez également ajouter des données structurées à l'élément VideoObject pour permettre les améliorations vidéo suivantes :

Carrousel vidéo : balisez les pages d'une galerie vidéo (page contenant une liste de vidéos) à l'aide de données structurées ItemList.
Segments vidéo : marquez les segments importants d'une vidéo à l'aide de données structurées Clip, afin de permettre aux internautes d'accéder rapidement à des points précis de cette vidéo.
Les segments vidéo sont actuellement limités à un groupe restreint de fournisseurs. Si vous souhaitez participer, remplissez ce formulaire afin de témoigner votre intérêt.

Si vous structurez votre contenu conformément à ce guide, un badge vidéo peut apparaître dans les résultats de recherche d'images pour mobile.

Exemples

Résultat enrichi standard pour une vidéo

Voici un exemple de balisage vidéo standard utilisant JSON-LD. Il utilise uniquement VideoObject et n'est pas éligible à l'affichage d'un carrousel vidéo ni de segments vidéo.

<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": "2016-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": "http://schema.org/WatchAction" },
        "userInteractionCount": 5647018
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Carrousel vidéo

Voici un exemple de page comportant une liste de vidéos. Pour activer le carrousel vidéo, cette page comporte des données structurées VideoObject et ItemList supplémentaires.

JSON-LD

<html>
  <head>
    <title>Introducing the self-driving bicycle in the Netherlands</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "ItemList",
      "itemListElement": [
        {
          "@type": "VideoObject",
          "position": 1,
          "name": "Introducing the self-driving bicycle in the Netherlands",
          "url": "https://www.example.com/video/self-driving-bicycle",
          "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://www.example.com/video/self-driving-bicycle/1x1/photo.jpg",
            "https://www.example.com/video/self-driving-bicycle/4x3/photo.jpg",
            "https://www.example.com/video/self-driving-bicycle/16x9/photo.jpg"
          ],
          "uploadDate": "2016-03-31T08:00:00+08:00",
          "duration": "PT1M54S",
          "contentUrl": "https://www.example.com/video/self-driving-bicycle/file.mp4",
          "embedUrl": "https://www.example.com/embed/self-driving-bicycle",
          "interactionStatistic": {
            "@type": "InteractionCounter",
            "interactionType": { "@type": "http://schema.org/WatchAction" },
            "userInteractionCount": 5647018
          }
        },
        {
          "@type": "VideoObject",
          "position": 2,
          "name": "How to tie a tie",
          "url": "https://www.example.com/video/how-to-tie-a-tie",
          "description": "How to tie a four-in-hand knot.",
          "thumbnailUrl": [
            "https://www.example.com/video/how-to-tie-a-tie/1x1/photo.jpg",
            "https://www.example.com/video/how-to-tie-a-tie/4x3/photo.jpg",
            "https://www.example.com/video/how-to-tie-a-tie/16x9/photo.jpg"
          ],
          "uploadDate": "2019-02-28T08:00:00+08:00",
          "duration": "PT5M01S",
          "contentUrl": "https://www.example.com/video/how-to-tie-a-tie/file.mp4",
          "embedUrl": "https://www.example.com/embed/how-to-tie-a-tie",
          "interactionStatistic": {
            "@type": "InteractionCounter",
            "interactionType": { "@type": "http://schema.org/WatchAction" },
            "userInteractionCount": 102111
          }
        }
      ]
    }
    </script>
  </head>
  <body>
  </body>
</html>

Microdonnées

<div>
      <div itemprop="video" itemscope itemtype="http://schema.org/VideoObject">
        
        <a href="https://example.com/videos/self-driving-bicycle"
           title="Introducing the self-driving bicycle in the Netherlands">
          <img src="https://example.com/videos/self-driving-bicycle/thumbnail.jpg"
               alt="Introducing the self-driving bicycle in the Netherlands"
               title="Introducing the self-driving bicycle in the Netherlands"
               itemprop="thumbnailUrl">
        </a>
        
        <h1>
          <a itemprop="url" href="https://example.com/videos/self-driving-bicycle"
             title="Introducing the self-driving bicycle in the Netherlands">
            <span itemprop="name">Introducing the self-driving bicycle in the Netherlands</span>
          </a>
        </h1>
        <a href="https://example.com/videos/self-driving-bicycle"
             title="Introducing the self-driving bicycle in the Netherlands">
          <div 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.
          "</div>
        </a>
        
        <meta itemprop="duration" content="PT1M54S" />
        <meta itemprop="uploadDate" content="2016-03-31T08:00:00+08:00" />
        <span itemprop="interactionStatistic" itemscope itemtype="http://schema.org/InteractionCounter">
        	<span itemprop="interactionType" itemscope itemtype="http://schema.org/WatchAction"></span>
        	<meta itemprop="userInteractionCount" content="5647018" />
        </span>
      </div>

Segments vidéo (accès limité)

Voici un exemple JSON-LD de propriété VideoObject avec des données structurées Clip supplémentaires utilisées pour marquer les segments vidéo. Les segments vidéo sont actuellement limités à un groupe restreint de fournisseurs. Si vous souhaitez participer, remplissez ce formulaire afin de témoigner votre intérêt.

Page AMP avec une vidéo

Voici un exemple de propriété VideoObject sur une page AMP.

<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://www.example.com/thumbnail.jpg",
      "uploadDate": "2016-03-31T08:00:00+08:00",
      "duration": "PT1M54S",
      "publisher": {
        "@type": "Organization",
        "name": "Google Nederland",
        "logo": {
          "@type": "ImageObject",
          "url": "https://example.com/logo.jpg",
          "width": 600,
          "height": 60
        }
      },
      "contentUrl": "https://www.example.com/video/123/file.mp4",
      "embedUrl": "https://www.example.com/embed/123",
      "interactionStatistic": {
        "@type": "InteractionCounter",
        "interactionType": { "@type": "http://schema.org/WatchAction" },
        "userInteractionCount": 5647018
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

Consignes

Pour que votre vidéo puisse figurer sous forme de résultat vidéo enrichi, vous devez respecter les consignes suivantes :

Consignes aux webmasters
Consignes générales relatives aux données structurées
Bonnes pratiques relatives aux vidéos
Consignes relatives au carrousel (le cas échéant)
Consignes relatives aux segments vidéo (le cas échéant)

Consignes relatives aux segments vidéo (accès limité)

Si vous ajoutez Clip pour marquer des segments vidéo, procédez comme suit :

La vidéo doit être accessible au public. En d'autres termes, tout le monde doit pouvoir la visionner sans nécessiter d'abonnement.
La vidéo doit pouvoir être associée à un lien profond autre que le point de départ de l'URL de la vidéo. Par exemple, http://www.example.com/example?t=30 démarre au bout de 30 secondes dans une vidéo.
Les données structurées relatives aux segments vidéo doivent être ajoutées à une page sur laquelle les internautes peuvent regarder la vidéo. Cela améliore la qualité de l'expérience utilisateur.
La durée totale de la vidéo doit être d'au moins 30 secondes.
Assurez-vous que deux clips de la même vidéo définie sur la même page ne partagent pas d'heure de début.
La vidéo doit comporter des données structurées VideoObject.

Définitions des types de données structurées

Cette section décrit les types de données structurées associés aux fonctionnalités vidéo dans la recherche Google. Vous devez inclure les propriétés VideoObject obligatoires pour que votre contenu puisse être affiché sous forme de résultat vidéo enrichi. Vous pouvez également inclure les propriétés recommandées pour ajouter d'autres informations à votre contenu et ainsi offrir une meilleure expérience utilisateur. Outre VideoObject, vous pouvez ajouter les types de données suivants afin d'activer les améliorations vidéo dans la recherche Google :

ItemList : balisez les pages contenant une liste de vidéos pour activer un carrousel vidéo.
Clip : marquez les segments importants de votre vidéo pour aider les utilisateurs à accéder rapidement à des points précis de cette vidéo.
Votre vidéo apprend-elle aux utilisateurs à accomplir une tâche pas à pas ? Intégrez votre contenu vidéo dans des données structurées HowTo.

VideoObject

La définition complète de l'élément VideoObject est disponible sur schema.org/VideoObject. Si vous n'incluez pas les propriétés requises, Google risque de ne pas pouvoir extraire les informations relatives à la vidéo. Vous pouvez également inclure les propriétés recommandées pour ajouter d'autres informations à votre contenu et ainsi offrir une meilleure expérience utilisateur.

Propriétés obligatoires
`description`	`Text` Description de la vidéo. Les balises HTML sont ignorées.
`name`	`Text` Titre de la vidéo.
`thumbnailUrl`	Élément `ImageObject` ou `URL` répété URL renvoyant au fichier image de la vignette associée à la vidéo. Les URL des images doivent être explorables et indexables. Les images doivent représenter le contenu balisé. Les images doivent être au format .jpg, .png ou .gif. La taille minimale des images doit être de 60 pixels de long sur 30 pixels de large.
`uploadDate`	`Date` Date à laquelle la vidéo a été publiée pour la première fois, au format ISO 8601.

Propriétés recommandées
`contentUrl`	`URL` Nous vous recommandons de fournir une URL à votre vidéo. Pour ce faire, utilisez l'une des propriétés suivantes ou les deux : `contentUrl` et `embedUrl`. URL renvoyant au fichier vidéo multimédia. Exemple "contentUrl": "https://www.example.com/video/123/file.mp4" Assurez-vous de suivre nos bonnes pratiques en matière de vidéo. Conseil : Pour vous assurer que seul Googlebot accède à votre contenu, utilisez une résolution DNS inverse.
`duration`	`Duration` Durée de la vidéo au format ISO 8601. Par exemple, `T00H30M5S` représente une durée de "trente minutes et cinq secondes".
`embedUrl`	`URL` Nous vous recommandons de fournir une URL à votre vidéo. Pour ce faire, utilisez l'une des propriétés suivantes ou les deux : `contentUrl` et `embedUrl`. URL qui renvoie vers le lecteur de la vidéo concernée. En général, cette information est indiquée dans l'élément `src` d'une balise `<embed>`. Exemple "embedUrl": "https://www.example.com/embed/123" Assurez-vous de suivre nos bonnes pratiques en matière de vidéo. Conseil : Pour vous assurer que seul Googlebot accède à votre contenu, utilisez une résolution DNS inverse.
`expires`	`Date` Le cas échéant, date après laquelle la vidéo ne sera plus disponible, au format ISO 8601. N'indiquez pas cette information si la vidéo n'a pas de date d'expiration.
`interactionStatistic`	`InteractionCounter` Nombre de fois où la vidéo a été visionnée. Exemple : "interactionStatistic": { "@type": "InteractionCounter", "interactionType": { "@type": "http://schema.org/WatchAction" }, "userInteractionCount": 12345 } En octobre 2019, nous avons modifié notre documentation pour recommander `interactionStatistic` au lieu de `interactionCount`. Alors que nous continuons à accepter `interactionCount`, nous recommandons l'utilisation de `interactionStatistic` à partir de maintenant.

ItemList

Pour activer l'affichage de votre vidéo dans un carrousel vidéo, ajoutez les propriétés ItemList suivantes en plus des propriétés VideoObject. Bien que les propriétés ItemList ne soient pas obligatoires, vous devez ajouter les propriétés ci-dessous si vous souhaitez que votre vidéo puisse s'afficher dans un carrousel vidéo. Pour plus d'informations sur les carrousels, consultez la section Carrousel.

La définition complète de l'élément ItemList est disponible sur schema.org/ItemList.

Propriétés obligatoires

Propriétés obligatoires
`itemListElement`	`ListItem` Annotation désignant une page relative à un seul élément. Chaque élément `ListItem` doit inclure des propriétés VideoObject ainsi que des propriétés `ListItem`.
`ListItem.position`	`Integer` Position ordinale de la page relative à un élément dans la liste. Exemple : "itemListElement": [ { "@type": "VideoObject", "position": 1, ... other VideoObject properties ... }, { "@type": "VideoObject", "position": 2, ... other VideoObject properties ... } ]
`ListItem.url`	`URL` URL canonique de la page relative à un élément. Chaque élément doit avoir une URL unique.

itemListElement

ListItem

Annotation désignant une page relative à un seul élément. Chaque élément ListItem doit inclure des propriétés VideoObject ainsi que des propriétés ListItem.

ListItem.position

Integer

Position ordinale de la page relative à un élément dans la liste. Exemple :


"itemListElement": [
  {
    "@type": "VideoObject",
    "position": 1,
    ... other VideoObject properties ...
  }, {
    "@type": "VideoObject",
    "position": 2,
    ... other VideoObject properties ...
  }
]

ListItem.url

URL

URL canonique de la page relative à un élément. Chaque élément doit avoir une URL unique.

Clip (accès limité)

Pour activer les segments d'une vidéo, imbriquez les propriétés suivantes dans l'élément VideoObject. Bien que les propriétés Clip ne soient pas obligatoires, vous devez ajouter les propriétés ci-dessous si vous souhaitez que votre vidéo puisse s'afficher avec des segments.

La définition complète de la propriété Clip est disponible sur schema.org/Clip.

Propriétés obligatoires

Propriétés obligatoires
`name`	`Text` Titre descriptif du contenu du clip.
`startOffset`	`Number` Heure de début du clip, exprimée en nombre de secondes à partir du début de la vidéo.
`url`	`URL` URL pointant vers l'heure de début du clip. L'URL du clip doit pointer vers le même chemin d'URL que la vidéo, avec des paramètres de requête supplémentaires indiquant l'heure. Par exemple, l'URL suivante signifie que la vidéo commence à 2 minutes et 0 seconde : "url": "https://www.example.com/example?t=120"

name

Text

Titre descriptif du contenu du clip.

startOffset

Number

Heure de début du clip, exprimée en nombre de secondes à partir du début de la vidéo.

url

URL

URL pointant vers l'heure de début du clip.

L'URL du clip doit pointer vers le même chemin d'URL que la vidéo, avec des paramètres de requête supplémentaires indiquant l'heure.

Par exemple, l'URL suivante signifie que la vidéo commence à 2 minutes et 0 seconde :


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

Propriétés recommandées

Propriétés recommandées
`endOffset`	`Number` Heure de fin du clip, exprimée en nombre de secondes à partir du début de la vidéo.

endOffset

Number

Heure de fin du clip, exprimée en nombre de secondes à partir du début de la vidéo.