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. Google peut utiliser votre balisage pour alimenter des carrousels (carrousel "À la une" avec les pages AMP, par exemple). Le balisage des vidéos entraîne l'affichage d'un badge sur votre image dans les résultats de recherche d'images pour mobile, ce qui peut encourager davantage d'utilisateurs à cliquer sur votre contenu.

Pour baliser les pages d'une galerie vidéo (pages contenant une liste de vidéos), utilisez des données structurées ItemList. Les galeries de vidéos peuvent être affichées sous forme de carrousel hôte. Pour plus d'informations sur les listes spécifiques à l'hôte, consultez la section Carrousel.

Le balisage des vidéos n'est pas obligatoire, mais recommandé pour aider Google à les explorer et à les indexer.

Exemples

Voici un exemple de données structurées relatives à une vidéo pour une page AMP, au format 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://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>

Voici un exemple de balisage vidéo standard utilisant 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": "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>

Voici un exemple de vidéo comportant des clips au format JSON-LD. Pour en savoir plus sur l'utilisation des clips, consultez le HowTo sur les données structurées.

Voici un exemple de page de galerie vidéo avec un balisage ItemList au format JSON-LD.

<html>
<head>
<title>Introducing the self-driving bicyle 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>

Voici un exemple de page de galerie vidéo avec un balisage ItemList sous forme de 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>

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

VideoObject

La définition complète de la propriété 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.
`name`	`Text` Titre de la vidéo.
`thumbnailUrl`	Champ répété d'`ImageObject` ou d'`URL` URL renvoyant au fichier image de la vignette associée à la vidéo. Consignes supplémentaires relatives aux images : Chaque page doit contenir au moins une image (que vous incluiez ou non un balisage). Google choisit la meilleure image à afficher dans les résultats de recherche en fonction du format et de la résolution. 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. Pour de meilleurs résultats, fournissez plusieurs images de haute résolution (minimum 50 000 pixels lorsque vous multipliez la largeur et la hauteur) avec les proportions suivantes : 16x9, 4x3 et 1x1. Exemple : "image": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ]
`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, vous pouvez utiliser les propriétés `contentUrl` et/ou `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 recherche DNS inverse.
`duration`	`Duration` Durée de la vidéo au format ISO 8601.
`embedUrl`	`URL` Nous vous recommandons de fournir une URL à votre vidéo. Pour ce faire, vous pouvez utiliser les propriétés `contentUrl` et/ou `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 recherche DNS inverse.
`expires`	`Text` 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.
`hasPart`	`CreativeWork` Clip vidéo faisant partie de l'intégralité de la vidéo. Pour ajouter des clips aux étapes d'une page HowTo, consultez le HowTo sur les données structurées.
`hasPart.endOffset`	`Number` Heure de fin du clip exprimée en nombre de secondes à partir du début de la vidéo.
`hasPart.name`	`Text` Nom du clip. Par exemple, "Pincer et serrer" pourrait être le nom d'un clip montrant comment nouer une cravate.
`hasPart.startOffset`	`Number` Heure de début du clip exprimée en nombre de secondes à partir du début de la vidéo.
`hasPart.url`	`URL` Lien vers l'heure de début du clip. L'heure de début doit correspondre à la valeur définie dans `hasPart.startOffset`. Exemple : "startOffset": 30, "endOffset": 45, "url": "http://www.example.com/example&t=30"
`interactionCount`	`Text` Nombre de fois où la vidéo a été visionnée.

ItemList

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

Outre les propriétés VideoObject, ajoutez les propriétés suivantes pour les listes spécifiques à l'hôte. Bien que l'élément ItemList ne soit pas obligatoire, il peut aider Google à identifier le contenu adapté aux carrousels hôtes. Pour plus d'informations sur les listes spécifiques à l'hôte, consultez la section Carrousel.

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 les propriétés VideoObject ainsi que les 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 les propriétés VideoObject ainsi que les 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.