テレビ番組と映画（TV and Movies）の構造化データをマークアップする方法

2017.10.02
テレビ番組と映画（TV and Movies）の構造化データをマークアップする方法

Photo Sven Scheuermeier via Unsplash

テレビ番組と映画（TV and Movies）の構造化データをマークアップする方法を紹介します。

TV and Movies（テレビと映画）

テレビ番組と映画（TV and Movies）の構造化データをマークアップすると、Googleにテレビ番組や映画に関する情報を正確に伝えることができます。

テレビ番組と映画（TV and Movies）の構造化データをJSON-LDでマークアップする

TV and Movies（テレビと映画）の構化データをJSON-LDでマークアップする方法です。JSON-LDはページのどこに記述しても問題ありませんが、通常は<head>タグ内に記述します。

映画のマークアップサンプル

映画のマークアップサンプルです。

{
  "@context": "http://schema.org",
  "@id": "12546432",
  "@type": "Movie",
  "name": "Forrest Gump",
  "url": "http://www.example.com/forrest_gump",
  "description": "A man with a low I.Q. has accomplished great things in his life and been present during significant historic events.",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "1994-07-06",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": [
      {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/forrest_gump?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/IOSPlatform",
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      },
      {
        "@type": "EntryPoint",
        "urlTemplate": "android-app://com.app.foo/bar/forrest_gump?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": "http://schema.org/AndroidPlatform"
      }
    ],
    "expectsAcceptanceOf": {
      "@type": "Offer",
      "availabilityStarts": "2015-01-01T00:00",
      "availabilityEnds": "2015-12-31T00:00",
      "category": "subscription",
      "name": "Hulu Plus",
      "price": 7.99,
      "priceCurrency": "USD",
      "seller": {
        "@type": "Organization",
        "name": "Hulu",
        "sameAs": "http://www.hulu.com/"
      },
      "eligibleRegion": {
        "@type": "Country",
        "name": "US"
      }
    }
  },
  "hasPart": {
    "@type": "Clip",
    "description": "trailer",
    "timeRequired": "PT2M5S",
    "potentialAction": {
      "@type": "WatchAction",
      "target": [
        {
          "@type": "EntryPoint",
          "urlTemplate": "http://www.example.com/watch/2356866",
          "inLanguage": "en",
          "actionPlatform": [
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/MobileWebPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.googleapis.com/GoogleVideoCast"
          ]
        },
        {
          "@type": "EntryPoint",
          "urlTemplate": "android-app://com.app.foo/bar/watch/2356866",
          "inLanguage": "en",
          "actionPlatform": "http://schema.org/AndroidPlatform"
        }
      ],
      "expectsAcceptanceOf": {
        "category": "free",
        "availabilityStarts": "2014-09-01T00:00",
        "availabilityEnds": "2015-09-01T00:00",
        "eligibleRegion": {
          "@type": "Country",
          "name": "US"
        }
      }
    }
  },
  "image": [
    "https://example.com/photos/1x1/photo.jpg",
    "https://example.com/photos/4x3/photo.jpg",
    "https://example.com/photos/16x9/photo.jpg"
   ],
  "sameAs": "http://www.imdb.com/title/tt0109830/",
  "actor": {
    "@type": "Person",
    "name": "Tom Hanks",
    "sameAs": "http://www.imdb.com/name/nm0000158/"
  },
  "director": {
    "@type": "Person",
    "name": "Robert Zemeckis",
    "sameAs": "http://www.imdb.com/name/nm0000709/"
  },
  "duration": "PT2H22M"
}

TV番組（エピソード）のマークアップサンプル

TV番組（エピソード）のマークアップサンプルです。

{
  "@context": "http://schema.org",
  "@id": "2356865",
  "@type": "TVEpisode",
  "name": "The Occupation Recalibration",
  "episodeNumber": 13,
  "partOfSeason": {
    "@type": "TVSeason",
    "seasonNumber": 7
  },
  "partOfSeries": {
    "@type": "TVSeries",
    "name": "The Big Bang Theory",
    "sameAs": "http://www.imdb.com/title/tt0898266/"
  },
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2014-01-09",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "potentialAction": [
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/big_bang_theory/s7/e13",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/IOSPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      },
      "expectsAcceptanceOf": [
        {
          "@type": "Offer",
          "category": "free",
          "availabilityStarts": "2014-09-01T00:00",
          "availabilityEnds": "2014-11-01T00:00",
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "US"
            },
            {
              "@type": "Country",
              "name": "CA"
            }
          ]
        },
        {
          "@type": "Offer",
          "category": "externalSubscription",
          "availabilityStarts": "2014-11-01T00:00",
          "availabilityEnds": "2015-03-01T00:00",
          "seller": {
            "@type": "Organization",
            "name": "Comcast",
            "sameAs": "http://xfinity.comcast.net/"
          }
        }
      ]
    },
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/big_bang_theory/s7/e13?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/IOSPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      },
      "expectsAcceptanceOf": [
        {
          "@type": "Offer",
          "category": "free",
          "availabilityStarts": "2014-09-08T00:00",
          "availabilityEnds": "2014-09-17T00:00",
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "US"
            },
            {
              "@type": "Country",
              "name": "CA"
            }
          ]
        },
        {
          "@type": "Offer",
          "category": "subscription",
          "availabilityStarts": "2014-09-01T00:00",
          "availabilityEnds": "2015-09-01T00:00",
          "name": "CBS All Access",
          "price": 5.99,
          "priceCurrency": "USD",
          "seller": {
            "@type": "Organization",
            "name": "CBS",
            "sameAs": "http://www.cbs.com/"
          }
        }
      ]
    }
  ],
  "hasPart": {
    "@type": "TVClip",
    "description": "trailer",
    "timeRequired": "PT2M5S",
    "potentialAction": {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/vid/2356866",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/IOSPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      },
      "expectsAcceptanceOf": {
        "category": "free",
        "availabilityStarts": "2014-09-01T00:00",
        "availabilityEnds": "2015-09-01T00:00"
      }
    }
  },
  "image": [
    "https://example.com/photos/1x1/photo.jpg",
    "https://example.com/photos/4x3/photo.jpg",
    "https://example.com/photos/16x9/photo.jpg"
   ],
  "sameAs": "http://www.imdb.com/title/tt3337730/",
  "description": "Sheldon tries to relax after he is forced to take a vacation. (TV-PG D, L)",
  "actor": [
    {
      "@type": "Person",
      "name": "Jim Parsons",
      "sameAs": "http://www.imdb.com/name/nm1433588/"
    },
    {
      "@type": "Person",
      "name": "Kaley Cuoco-Sweeting",
      "sameAs": "http://www.imdb.com/name/nm0192505/"
    }
  ],
  "director": {
    "@type": "Person",
    "name": "Mark Cendrowski",
    "sameAs": "http://www.imdb.com/name/nm0148252"
  }
}

TV番組（シーズン）のマークアップサンプル

TV番組（シーズン）のマークアップサンプルです。

{
  "@context": "http://schema.org",
  "@id": "312675",
  "@type": "TVSeason",
  "sameAs": "http://en.wikipedia.org/wiki/The_Big_Bang_Theory_%28season_4%29",
  "url": "http://www.example.com/big_bang_theory/season4",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2010-09-23",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "seasonNumber": 4,
  "partOfSeries": {
    "@type": "TVSeries",
    "name": "The Big Bang Theory",
    "sameAs": "http://www.imdb.com/title/tt0898266/",
    "url": "http://www.example.com/big_bang_theory/"
  },
  "potentialAction": [
  {
    "@type": "ViewAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/big_bang_theory/season4/purchase",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform"
      ]
    },
    "expectsAcceptanceOf": {
      "@type": "Offer",
      "availabilityStarts": "2015-01-01T00:00",
      "availabilityEnds": "2015-12-31T00:00",
      "category": "purchase",
      "name": "High definition",
      "price": 28.99,
      "priceCurrency": "USD",
      "eligibleRegion": {
        "@type": "Country",
        "name": "US"
      }
    }
  },
  {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/big_bang_theory/season4/watch?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/IOSPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      },
      "expectsAcceptanceOf": [
        {
          "@type": "Offer",
          "category": "free",
          "availabilityStarts": "2014-09-08T00:00",
          "availabilityEnds": "2014-09-17T00:00",
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "US"
            },
            {
              "@type": "Country",
              "name": "CA"
            }
          ]
        },
        {
          "@type": "Offer",
          "category": "subscription",
          "availabilityStarts": "2014-09-01T00:00",
          "availabilityEnds": "2015-09-01T00:00",
          "name": "CBS All Access",
          "price": 5.99,
          "priceCurrency": "USD",
          "eligibleRegion": {
        	"@type": "Country",
        	"name": "US"
      	  },
          "seller": {
            "@type": "Organization",
            "name": "CBS",
            "sameAs": "http://www.cbs.com/"
          }
        }
      ]
    }
  ]
}

TV番組（シリーズ）のマークアップサンプル

TV番組（シリーズ）のマークアップサンプルです。

{
  "@context": "http://schema.org",
  "@id": "1243759",
  "@type": "TVSeries",
  "name": "Breaking Bad",
  "sameAs": "http://www.imdb.com/title/tt0903747/",
  "url": "http://www.example.com/breaking_bad/",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "actor": [
    {
      "@type": "Person",
      "name": "Bryan Cranston",
      "sameAs": "http://www.imdb.com/name/nm0186505/"
    },
    {
      "@type": "Person",
      "name": "Aaron Paul",
      "sameAs": "http://www.imdb.com/name/nm0666739/"
    }
  ],
  "potentialAction": [
  {
    "@type": "ViewAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/breaking_bad/purchase",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform"
      ]
    },
    "expectsAcceptanceOf": {
      "@type": "Offer",
      "availabilityStarts": "2015-01-01T00:00",
      "availabilityEnds": "2015-12-31T00:00",
      "category": "purchase",
      "name": "High definition",
      "price": 89.99,
      "priceCurrency": "USD",
      "eligibleRegion": {
        "@type": "Country",
        "name": "US"
      }
    }
  },
  {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/breaking_bad/watch?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/IOSPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.googleapis.com/GoogleVideoCast"
        ]
      },
      "expectsAcceptanceOf": [
        {
          "@type": "Offer",
          "category": "free",
          "availabilityStarts": "2014-09-08T00:00",
          "availabilityEnds": "2014-09-17T00:00",
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "US"
            },
            {
              "@type": "Country",
              "name": "CA"
            }
          ]
        },
        {
          "@type": "Offer",
          "category": "subscription",
          "availabilityStarts": "2014-09-01T00:00",
          "availabilityEnds": "2015-09-01T00:00",
          "name": "Example",
          "price": 5.99,
          "priceCurrency": "USD",
          "eligibleRegion": {
        	"@type": "Country",
        	"name": "US"
      	  },
          "seller": {
            "@type": "Organization",
            "name": "Example",
            "sameAs": "http://www.example.com/"
          }
        }
      ]
    }
  ]
}

 TV and Movies（テレビと映画）の属性

TV and Movies（テレビと映画）で共通の属性です。

属性必須説明
@id推奨URL形式のID
ユニークで、不変なものを使用する。
このURLはあくまでIDとして使用するものなので、ページが実在する必要はない。
actor推奨俳優
actor.name推奨俳優の名前
actor.sameAs推奨俳優に関するページのURL
公式サイトやWikipediaなど
description推奨作品の概要
director推奨監督
director.name推奨監督の名前
director.sameAs推奨監督に関するページのURL
公式サイトやWikipediaなど
hasPart推奨関連する映画作品やテレビ番組
映画のビデオクリップには”@type”: “Clip”を、テレビ番組やには”@type”: “TVClip”を使用する。
hasPart.description推奨“trailer”、”behind_the_scenes”、”highlight”のいずれかを使用
“trailer”: PVやトレイラー
“behind_the_scenes”: 作品のサマリー
“highlight”: 作品のハイライト
hasPart.potentialAction推奨ビデオクリップの視聴に関する情報
hasPart.timeRequired推奨ビデオクリップの時間
“PT2M5S” (2分5秒)。
image推奨作品に関連する画像のURL
image.height推奨画像の高さ
image.width推奨画像の横幅
image.url推奨画像が掲載されているページのURL
name必須作品の名前
potentialAction必須作品の視聴に関する情報
releasedEvent推奨作品の公開に関する情報
releasedEvent.startDate推奨作品の公開日
releasedEvent.location推奨作品がreleasedEvent.startDateの公開日に公開された国
releasedEvent.location.name推奨国コード
JP、USなど
sameAs推奨作品に関するページのURL
Wikipediaなど
sameAs推奨作品の公式サイトなどランディングページのURL

映画に関する属性

映画に関する属性です。

属性必須説明
duration推奨作品の時間
“PT2H22M” (142分)

TV番組（エピソード）の属性

TV番組（エピソード）に関する属性です。

属性必須説明
episodeNumber必須シーズンごとの話数
partOfSeason必須エピソードが属するシーズンに関する情報
partOfSeason.seasonNumber必須シーズン番号
partOfSeries必須エピソードが属するシリーズに関する情報
partOfSeries.name必須シリーズの名前
partOfSeries.sameAs推奨シリーズに関するページのURL
Wikipediaなど

TV番組（シーズン）の属性

TV番組（シーズン）に関する属性です。

属性必須説明
@id推奨URL形式のID
ユニークで、不変なものを使用する。
このURLはあくまでIDとして使用するものなので、ページが実在する必要はない。
name推奨シーズンの名前（シリーズの名前と異なる場合）
partOfSeries必須シーズンが属するシリーズに関する情報
partOfSeries.name必須シリーズの名前
partOfSeries.sameAs推奨シリーズに関するページのURL
Wikipediaなど
potentialAction推奨シーズンの視聴に関する情報
releasedEvent推奨シーズンの第1話の公開に関する情報
releasedEvent.startDate推奨シーズンの第1話の公開日
releasedEvent.location推奨シーズンの第1話が公開された国
releasedEvent.location推奨国コード
JP、USなど
sameAs推奨シーズンに関するページのURL
Wikipediaなど
seasonNumber必須シリーズにおけるシーズンの番号
URL推奨シーズンのランディングページのURL

TV番組（シリーズ）の属性

TV番組（シリーズ）に関する属性です。

属性必須説明
@id推奨URL形式のID
ユニークで、不変なものを使用する。
このURLはあくまでIDとして使用するものなので、ページが実在する必要はない。
actor推奨俳優に関する情報
actor.name推奨俳優の名前
actor.sameAs推奨俳優に関するページのURL
Wikipediaなど
name必須シリーズの名前
potentialAction推奨シリーズの視聴に関する情報
releasedEvent推奨シリーズの最初のエピソードの公開に関する情報
releasedEvent.startDate推奨シリーズの最初のエピソードが公開された日
releasedEvent.location推奨シリーズの最初のエピソードがreleasedEvent.startDateの公開日に公開された場所に関する情報
releasedEvent.location.name推奨国コード
JP、USなど
sameAs推奨シリーズに関するページのURL
Wikipediaなど
URL推奨シリーズのランディングページのURL（公式サイトなど）

視聴方法（WatchAction）の属性

視聴方法（WatchAction）に関する属性です。

属性必須説明
expectsAcceptanceOf必須視聴方法に関する情報
expectsAcceptanceOf.availabilityStarts必須その視聴方法が可能になる日付（視聴開始日）
expectsAcceptanceOf.availabilityEnds必須その視聴方法が終了する日付（視聴終了日）
expectsAcceptanceOf.category必須視聴方法のカテゴリ、以下から選択

  • “rental”
  • “purchase”
  • “subscription”
  • “externalSubscription”
  • “free”
expectsAcceptanceOf.eligibleRegion必須その視聴方法で視聴可能な国に関する情報
expectsAcceptanceOf.eligibleRegion.name必須国コード
JP、USなど
target必須視聴方法に関するページの情報
target.actionPlatform必須URLが対応しているプラットフォーム
以下から複数選択可
http://schema.org/DesktopWebPlatform: デスクトップのWebブラウザ用
http://schema.org/MobileWebPlatform: モバイルのWebブラウザ用
http://schema.org/AndroidPlatform: Androidアプリ用
http://schema.org/IOSPlatform:
schema.org
 iOSアプリ用
target.urlTemplate必須視聴URL

視聴方法（ViewAction）の属性

視聴方法（ViewAction）に関する属性です。

属性必須説明
target.actionPlatform必須URLが対応しているプラットフォーム
以下から複数選択可
http://schema.org/DesktopWebPlatform: デスクトップのWebブラウザ用
http://schema.org/MobileWebPlatform: モバイルのWebブラウザ用
http://schema.org/AndroidPlatform: Androidアプリ用
http://schema.org/IOSPlatform:
schema.org
 iOSアプリ用
target.urlTemplate必須視聴URL

参考