ライブ TV イベントのコンテンツ マークアップ プロパティ

このセクションでは、BroadcastEvent エンティティ タイプのコンテンツ マークアップ プロパティの詳細について説明します。これらのタイプ間の関係をより深く理解するには、LiveTV イベントのコンセプトをご覧ください。

BroadcastEvent の仕様表

プロパティ タイプ 説明
@context テキスト 必須 - 常に ["http://schema.org", {"@language": "xx"}]
に設定します。
  • xx は、エンティティの言語コード(BCP 47 形式、例: 「en」)に置き換えます。
@type テキスト 必須 - 常に BroadcastEvent に設定します。
@id URL 必須 - 放送枠の識別子(URI 形式)。例: https://example.com/live/channel1/20191012T2100。
@id は次の要件を満たす必要があります。
  • カタログ全体でグローバルに一意であり、workPerformed.@id または broadcastOfEvent.@id とは異なる(たとえば、チャンネル / サービスと放送開始時間を URI に組み込む)
  • 静的。ID は固定されており、時間の経過とともに変化してはなりません。不透明型の文字列として扱われ、有効なリンクである必要はありません。
  • Unified Resource Identifier(URI)の形式
  • @id 値に使用するドメインは、プロバイダの組織が所有するものであることが必要です。
重要: BroadcastEvent または SportsEvent に url プロパティを含めないでください。正規の url は、基になるコンテンツ エンティティ(Movie、TVSeries、TVEpisode)にのみ指定します。詳しくは、識別子のセクションをご覧ください。
name テキスト 必須 - 番組またはイベントのタイトル。
description テキスト 番組またはイベントの説明。300 文字数制限。配列を使用して、複数の言語で説明を記述します(言語ごとに 1 つ)。
startDate 日付 必須 - ISO 8601 形式のイベントの開始時刻(タイムゾーンを含む)。
endDate 日付 タイムゾーンを含む ISO 8601 形式のイベントの終了時刻。
publishedOn BroadcastService 該当する場合は必須 - この番組またはイベントを放送する BroadcastService エンティティを指定します。

コンテンツがテレビ チャンネルで放送される場合、このプロパティは必須です。コンテンツがテレビ チャンネルに関連付けられていない場合は、このプロパティを指定しないでください。
publishedOn.@type テキスト BroadcastService に設定します。
publishedOn.@id URL この番組またはイベントを放送する BroadcastService エンティティの @id。
workPerformed CreativeWork 該当する場合は必須 - コンテンツが Movie、TVSeries、TVEpisode のいずれかのエンティティ タイプである場合は、このプロパティを使用します。
BroadcastEvent エンティティには、次のうち少なくとも 1 つを含めることを強くおすすめします。
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced を true に設定
  • offAir を true に設定
workPerformed.@type テキスト Movie、TVSeries、TVEpisode のいずれかに設定します。
workPerformed.@id URL コンテンツ エンティティの @id。
broadcastOfEvent SportsEvent 該当する場合は必須 - コンテンツがライブイベントの場合は、このプロパティを使用します。
  • スポーツ イベントの場合、このプロパティは SportsEvent エンティティを参照する必要があります。

BroadcastEvent エンティティには、次のうち少なくとも 1 つを含めることを強くおすすめします。
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced を true に設定
  • offAir を true に設定
broadcastOfEvent.@type テキスト SportsEvent に設定します。
broadcastOfEvent.@id URL イベント エンティティの @id。イベント エンティティがフィードに存在し、BroadcastEvent とは異なる @id が設定されている必要があります。
location テキストまたは国 BroadcastEvent が SportsEvent の場合(broadcastOfEvent プロパティがある場合)は必須 - 基になる SportsEvent を放送できる国。複数の国で SportsEvent をブロードキャストできる場合、このフィールドは国のリストにすることができます。
videoFormat テキスト このブロードキャスト サービスでサポートされている最高品質の定義。例:
  • 標準画質用の「SD」。
  • ハイビジョン用の「HD」。
  • 2K 解像度用の「2K」。
  • 4K 解像度用の「4K」。
  • 8K 解像度用の「8K」。
contentToBeAnnounced ブール値 該当する場合は必須 - フィードの作成時にコンテンツが不明な場合は、このプロパティを使用します。

プロバイダが放送内容に関する最新情報を持っていない場合は true に設定し、それ以外の場合は false に設定します。
BroadcastEvent エンティティには、次のうち少なくとも 1 つを含めることを強くおすすめします。
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced を true に設定
  • offAir を true に設定
offAir ブール値 該当する場合は必須 - BroadcastService チャンネルのタイムスロットに予定されているコンテンツ ブロードキャストがない場合は、true に設定します。
  • name と description の両方を "Off Air" に設定します。
  • 各 offAir BroadcastEvent は 4 時間以下にする必要があります(24 時間連続のブロックは出力しないでください)。チャンネルが 4 時間以上放送されない場合は、それぞれ最大 4 時間の連続した重複しない BroadcastEvent エンティティを複数出力して、チャンネルが 24 時間 365 日のスケジュールを完全にカバーし、フィード ウィンドウの開始時または終了時にギャップが生じないようにします。
BroadcastEvent エンティティには、次のうち少なくとも 1 つを含めることを強くおすすめします。
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced を true に設定
  • offAir を true に設定
isLiveBroadcast ブール値 この放送がライブ配信(ライブのスポーツ試合やライブのデイリー ニュースなど)の場合は、ブール値 true(引用符なし)に設定します。ライブ以外の番組や再放送の場合は、false に設定します。
potentialAction WatchAction 該当する場合は必須 - broadcastOfEvent が SportsEvent を参照している場合(すべてのスポーツ ディープリンクを SportsEvent.potentialAction に配置)、または publishedOn が BroadcastService チャンネルを参照している場合(チャンネル ディープリンクを BroadcastService.potentialAction に配置)、BroadcastEvent で potentialAction を指定しないでください。BroadcastEvent.potentialAction は、SportsEvent を参照しないチャンネルレスのライブ配信(contentToBeAnnounced と offAir が省略された、または false のスタンドアロンのライブ サブコンテンツなど)にのみ指定してください。
identifier PropertyValue ブロードキャスト コンテンツを識別する外部 ID。詳細については、識別子プロパティのセクションをご覧ください。
  • 注: BroadcastEvent エンティティ タイプは、TMS_ID または TMS_ROOT_ID の propertyID 値のみを受け入れます。
  • このプロパティは、完全に形成された最上位の Movie、TVSeries、TVEpisode、SportsEvent エンティティが workPerformed プロパティまたは broadcastOfEvent プロパティを使用して参照されていない場合にのみ指定する必要があります。
  • プロパティの値には、workPerformed プロパティまたは broadcastOfEvent プロパティを使用して参照することが望ましい Movie、TVSeries、TVEpisode、SportsEvent エンティティの TMS_ID または TMS_ROOT_ID を反映する必要があります。
  • TMS_ID は TMS_ROOT_ID 値よりも優先されます。
contentRating テキストまたは評価 アダルト コンテンツの場合は必須、それ以外の場合は強く推奨(理由)- 放送コンテンツの全体的なコンテンツ レーティング。コンテンツのレーティングがテキスト文字列の形式で指定されている場合は、次の 2 つのバリエーションが許可されます。
  • 評価機関の名前を評価の前にスペースで区切って追加します。たとえば、米国の「MPAA」という機関による「PG-13」のレーティングは、「MPAA PG-13」と記述する必要があります。代理店の一覧をご覧ください。
  • 映画のレーティングが不明であることを示す値「RATING NOT KNOWN」(大文字と小文字は区別されません)。
contentRating.author 組織 contentRating で Rating を使用する場合は必須 - 評価機関の名前。
contentRating.ratingValue テキスト contentRating が Rating を使用する場合は必須 - 評価の値。
contentRating.advisoryCode テキスト コンテンツのアドバイザリ コード。指定できる値は、D、FV、L、S、V です。D = 会話、FV = ファンタジー バイオレンス、L = 言語、S = 性的なコンテンツ、V = 暴力。

例

テレビ エピソードが、2019 年 10 月 12 日の午後 9 時から午後 9 時 30 分の間に、テレビ ネットワーク Example TV(BroadcastService)で放送されます。

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live/event/my_favorite_tv_series/new_episode",
  "name": "My Favorite TV Series - Season 6 - Episode 2 - Three Mice",
  "description": "Three mice leave the town and the trip turns into something more.",
  "startDate": "2019-10-12T21:00-08:00",
  "endDate": "2019-10-12T21:30-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "workPerformed": {
    "@type": "TVEpisode",
    "@id": "http://example.com/tv_series/my_favorite_tv_series/s6/e2_three_mice"
  }
}

BroadcastService

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network"
  },
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

2019 年 10 月 12 日の午後 9 時から午後 9 時 30 分の間にテレビ ネットワーク Example TV(BroadcastService)で放送されるコンテンツが、フィードの作成時に不明な場合に、contentToBeAnnounced プロパティを使用する例を以下に示します。

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId",
  "name": "Content To Be Announced",
  "description": "Content To Be Announced",
  "startDate": "2019-10-12T21:00-08:00",
  "endDate": "2019-10-12T21:30-08:00",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "contentToBeAnnounced": true
}

BroadcastService

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network"
  },
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

テレビ ネットワーク Example TV(BroadcastService)のチャンネルは、午後 12 時から午後 8 時まで放送休止(4 時間の Off Air ブロックが 2 つ連続しているとモデル化)で、午後 8 時から午前 12 時まで My favorite show という名前の番組を 1 つ放送しています。

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId1",
  "name": "Off Air",
  "description": "Off Air",
  "startDate": "2019-10-12T12:00-08:00",
  "endDate": "2019-10-12T16:00-08:00",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "offAir": true
},
{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId2",
  "name": "Off Air",
  "description": "Off Air",
  "startDate": "2019-10-12T16:00-08:00",
  "endDate": "2019-10-12T20:00-08:00",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "offAir": true
},
{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId3",
  "name": "My favorite show",
  "description": "Evening broadcast of My favorite show.",
  "startDate": "2019-10-12T20:00-08:00",
  "endDate": "2019-10-13T00:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "workPerformed": {
    "@type": "TVSeries",
    "@id": "http://example.com/tv_series/my_favorite_show"
  },
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  }
}

BroadcastService

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network"
  },
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

これらのプロパティに関連するトピックについては、次のページを確認してください。