テレビ番組と映画（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

参考