動画

構造化データを使って動画コンテンツをマークアップすると、Google 検索から動画を見つけて視聴してもらえるようになります。説明、サムネイル URL、アップロード日、再生時間などの詳細を指定できます。このマークアップは、Google によってカルーセル（AMP のトップニュースカルーセルなど）のデータソースとして利用されることがあります。動画をマークアップすると、モバイルの画像検索結果の画像にバッジが表示されます。このバッジによって、ユーザーにコンテンツをクリックしてもらう可能性を高めることができます。

ItemList 構造化データを使用して、動画ギャラリーページ（動画のリストがあるページ）をマークアップします。動画ギャラリーはホストカルーセルとして表示される場合があります。ホスト固有のリストについて詳しくは、カルーセルをご覧ください。

動画のマークアップは必須ではありませんが、Google による動画のクロールとインデックス登録を促進するおすすめの方法です。

例

JSON-LD を使用した 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>

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>

JSON-LD を使用したクリップ付きの動画は、次のようになります。クリップの使用方法の詳細については、How-to 構造化データをご覧ください。

JSON-LD ItemList マークアップが使用された動画ギャラリーページの例を示します。

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

microdata ItemList マークアップが使用された動画ギャラリーページの例を示します。

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

構造化データタイプの定義

VideoObject

VideoObject の定義の全文は schema.org/VideoObject で確認できます。必須プロパティを指定しないと、Google が動画に関する情報を抽出できない場合があります。また、推奨プロパティを使用することでコンテンツに関する詳細情報を追加でき、ユーザーエクスペリエンスの向上につながります。

必須プロパティ
`description`	`Text` 動画の説明。
`name`	`Text` 動画のタイトル。
`thumbnailUrl`	`ImageObject` または `URL` の繰り返し動画のサムネイル画像ファイルを指定する URL。画像に関するその他のガイドライン: すべてのページに画像を少なくとも 1 つ含める必要があります（マークアップを含めるかどうかは問わない）。Google は、アスペクト比と解像度に基づいて、検索結果に表示する最適な画像を選択します。画像の URL は、クロールやインデックス登録に対応できる必要があります。画像はマークアップされたコンテンツを表している必要があります。 .jpg、.png、.gif のいずれかの形式の画像を指定する必要があります。適切な画像が選択されるようにするために、アスペクト比が 16x9、4x3、1x1 の高解像度画像（50,000 ピクセル以上の画像）を複数指定してください。次に例を示します。 "image": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ]
`uploadDate`	`Date` 動画が最初に公開された日付（ISO 8601 形式）。

推奨プロパティ
`contentUrl`	`URL` 動画の URL を指定することをおすすめします。URL を指定するには、`contentUrl` プロパティと `embedUrl` プロパティのいずれかまたは両方を使用します。実際の動画のメディアファイルを指定する URL。例 "contentUrl": "https://www.example.com/video/123/file.mp4" 動画のベストプラクティスに沿っていることをご確認ください。ヒント: リバース DNS ルックアップを使用して、Googlebot のみがコンテンツにアクセスしていることを確認できます。
`duration`	`Duration` 動画の再生時間（ISO 8601 形式）。
`embedUrl`	`URL` 動画の URL を指定することをおすすめします。URL を指定するには、`contentUrl` プロパティと `embedUrl` プロパティのいずれかまたは両方を使用します。特定の動画のプレーヤーを指定する URL。通常これは、`<embed>` タグの `src` 要素内の情報です。例 "embedUrl": "https://www.example.com/embed/123" 動画のベストプラクティスに沿っていることをご確認ください。ヒント: リバース DNS ルックアップを使用して、Googlebot のみがコンテンツにアクセスしていることを確認できます。
`expires`	`Text` その日以降は動画が使用できなくなる日付（ISO 8601 形式）（該当する場合）。有効期限がない場合は、この値を指定しないでください。
`hasPart`	`CreativeWork` 動画全体から一部を抽出した動画クリップ。How-to ページの手順にクリップを追加するには、How-to の構造化データをご覧ください。
`hasPart.endOffset`	`Number` 動画の先頭からの秒数で表したクリップの終了時間。
`hasPart.name`	`Text` クリップの名前。たとえば、紐の結び方と解き方を示すクリップの名前を「結び方と解き方」とします。
`hasPart.startOffset`	`Number` 動画の先頭からの秒数で表したクリップの開始時間。
`hasPart.url`	`URL` クリップの開始時間へのリンク。開始時間は `hasPart.startOffset` に設定されている値と一致する必要があります。次に例を示します。 "startOffset": 30, "endOffset": 45, "url": "http://www.example.com/example&t=30"
`interactionCount`	`Text` 動画が再生された回数。

リスト項目

ItemList の定義の全文は schema.org/ItemList で確認できます。

VideoObject プロパティに加え、以下のホスト固有のリスト用プロパティを追加します。ItemList は必須ではありませんが、Google がホストカルーセルに適したコンテンツを特定するために役立ちます。ホスト固有のリストについて詳しくは、カルーセルをご覧ください。

必須プロパティ

必須プロパティ
`itemListElement`	`ListItem` 1 つのアイテムページの注釈。各 `ListItem` 要素には VideoObject プロパティと `ListItem` プロパティを指定する必要があります。
`ListItem.position`	`Integer` リスト内でのアイテムページの順序位置。次に例を示します。 "itemListElement": [ { "@type": "VideoObject", "position": 1, ... other VideoObject properties ... }, { "@type": "VideoObject", "position": 2, ... other VideoObject properties ... } ]
`ListItem.url`	`URL` アイテムページの正規 URL。すべてのアイテムに固有の URL が必要です。

itemListElement

ListItem

1 つのアイテムページの注釈。各 ListItem 要素には VideoObject プロパティと ListItem プロパティを指定する必要があります。

ListItem.position

Integer

リスト内でのアイテムページの順序位置。次に例を示します。


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

ListItem.url

URL

アイテムページの正規 URL。すべてのアイテムに固有の URL が必要です。