動画 | 検索 | Google Developers

構造化データを使って動画コンテンツをマークアップすると、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",
  "interactionCount": "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",
  "interactionCount": "5647018"
}
</script>
</head>
<body>
</body>
</html>

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

<html>
<head>
<title>Build a Trivia Game for the Google Assistant with No Code</title>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "Build a Trivia Game for the Google Assistant with No Code",
  "description": "Learn how to create a Trivia action for Assistant within minutes.",
  "thumbnailUrl": "https://example.com/photos/photo.jpg",
  "contentUrl": "https://www.youtube.com/watch?v=4AOI1tZrgMI",
  "embedUrl": "https://www.youtube.com/embed/4AOI1tZrgMI",
  "uploadDate": "2019-01-05T08:00:00+08:00",
  "duration": "P1MT10S",
  "hasPart": [
    {
      "@type": "Clip",
      "@id": "Clip1",
      "name": "Open Actions on Google Console",
      "startOffset": 29,
      "endOffset": 36,
      "url": "http://www.example.com/example&t=29"
    },
    {
      "@type": "Clip",
      "@id": "Clip2",
      "name": "Select Trivia Template",
      "startOffset": 36,
      "endOffset": 45,
      "url": "http://www.example.com/example&t=36"
    },
    {
      "@type": "Clip",
      "@id": "Clip3",
      "name": "Choose a Personality",
      "startOffset": 45,
      "endOffset": 65,
      "url": "http://www.example.com/example&t=45"
      }
    ]
   }
 }
</script>
</head>
<body>
</body>
</html>

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",
      "interactionCount": "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",
      "interactionCount": "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" />
        <meta itemprop="interactionCount" content="5647018" />
      </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" 動画のベストプラクティスに沿っていることをご確認ください。ヒント: Googlebot のみがコンテンツにアクセスしていることを確認するには、リバース DNS ルックアップを使用します。
`duration`	`Duration` 動画の再生時間（ISO 8601 形式）。
`embedUrl`	`URL` 動画の URL を指定することをおすすめします。URL を指定するには、`contentUrl` プロパティと `embedUrl` プロパティのいずれかまたは両方を使用します。特定の動画のプレーヤーを指定する URL。通常これは、`<embed>` タグの `src` 要素内の情報です。例 "embedUrl": "https://www.example.com/embed/123" 動画のベストプラクティスに沿っていることをご確認ください。ヒント: Googlebot のみがコンテンツにアクセスしていることを確認するには、リバース DNS ルックアップを使用します。
`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 が必要です。

動画

例

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

VideoObject

リスト項目

フィードバックを送信...