動画コンテンツ（Video）の構造化データをマークアップする方法

Photo by Jakob Owens via Unsplash

動画コンテンツ（Video）の構造化データをマークアップする方法を紹介します。

動画コンテンツの構造化データをマークアップすると、Googleはその動画に関する情報をより正確に理解できるようになります。

Googleのマット・カッツは、YouTubeなどの動画配信サービスにアップロードした動画であっても、自分のサイトに埋め込む際には動画の構造化データをマークアップすることを推奨しています。構造化データをマークアップすることで、Googleがその動画コンテンツをより正確に理解することにつながるためです。

JSON-LDでマークアップする

動画コンテンツ（Video）をJSON-LDでマークアップする方法です。JSON-LDはページのどこに記述しても問題ありませんが、通常は<head>タグ内に記述します。

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "VideoObject",
  "name": "動画タイトル",
  "description": "動画の説明",
  "thumbnailUrl": "https://www.example.com/thumbnail.jpg",
  "uploadDate": "2015-02-05T08:00:00+09:00",
  "duration": "PT1M33S",
  "contentUrl": "http://www.example.com/video123.flv",
  "embedUrl": "http://www.example.com/videoplayer.swf?video=123",
  "interactionCount": "2347"
  "expires": "2015-02-05T08:00:00+09:00"
}
</script>

Microdataでマークアップする

MicrodataでHTMLタグに直接マークアップする方法です。

<div itemprop="video" itemscope itemtype="http://schema.org/VideoObject">
  <span itemprop="name">動画タイトル</span>
  <span itemprop="description">動画の説明</span>
  <img itemprop="thumbnailUrl" src="http://www.example.com/thumbnail.jpg" alt="サムネイル画像の説明"/>
  <meta itemprop="uploadDate" content="2015-02-05T08:00:00+09:00"/>
  <meta itemprop="duration" content="T1M33S" />
  <link itemprop="contentUrl" href="http://www.example.com/video123.flv" />
  <link itemprop="embedUrl" href="http://www.example.com/videoplayer.swf?video=123" />
  <meta itemprop="interactionCount" content="2347" />
  <meta itemprop="expires" content="2015-03-30T19:00:00+09:00" />
</div>

属性の解説

動画コンテンツ（Video）の構造化データの属性は次のようになっています。

属性	必須	説明
name	必須	動画のタイトル
description	必須	動画の説明
thumbnailURL	必須	動画のサムネイルのURL
uploadDate	必須	動画の公開日時
duration	推奨	動画の長さ 1分33秒なら、`T1M33S`と表記。
contentURL	推奨*	動画のURL *contentURLとembedURL、少なくともどちらかが必須
embedURL	推奨*	動画プレイヤーのURL Flashなど再生プレイヤー（プラグイン）が必要な場合 *contentURLとembedURL、少なくともどちらかが必須
interactionCount	推奨	動画の再生回数
expires	推奨	動画の有効期限有効期限がなければ指定する必要なし

参考

Videos