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

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

BroadcastEvent の仕様表

プロパティ タイプ 説明
@context テキスト 必須 - 常に ["http://schema.org", {"@language": "xx"}] に設定します。
  • xx は、エンティティの言語コード(BCP 47 形式など)に置き換えます。
@type テキスト 必須 - 常に BroadcastEvent に設定します。
@id URL 必須 - URI 形式のコンテンツの識別子(例: https://example.com/1234abc)。
@id は次の要件を満たしている必要があります。
  • カタログ全体でグローバルに一意
  • 静的: ID は固定されており、(番組の URL プロパティが変更されても)時間の経過とともに変化してはなりません。これは不透明な文字列として扱われ、有効なリンクである必要はありません。
  • Unified Resource Identifier(URI)の形式
  • @id 値に使用するドメインが、自分の組織が所有するものであること。
エンティティの url は識別子としてのすべての要件を満たしているため、エンティティの url@id として使用することをおすすめします。詳細については、ID セクションをご覧ください。
name テキスト 必須 - 番組またはイベントのタイトル。
description テキスト 番組またはイベントの説明。300 文字以内。配列を使用して複数の言語と長さの説明を含めます。
startDate 日付 必須 - タイムゾーンを含む ISO 8601 形式のイベントの開始時間。
endDate 日付 タイムゾーンを含む ISO 8601 形式のイベントの終了時刻。
publishedOn BroadcastService 該当する場合は必須 - この番組またはイベントをブロードキャストする BroadcastService エンティティを指定します。

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

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

プロバイダにブロードキャストされる最新情報がない場合は true に設定します。それ以外の場合は false に設定します。
BroadcastEvent エンティティには、次のうち少なくとも 1 つを含めることを強くおすすめします。
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnouncedtrue に設定
  • offAirtrue に設定
offAir ブール値 該当する場合は必須 - 対象のタイムスロットのコンテンツ ブロードキャストが予定されていない場合は、このプロパティを使用します。
BroadcastEvent エンティティには、少なくとも次のいずれか 1 つを含めることを強くおすすめします。
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnouncedtrue に設定
  • offAirtrue に設定
isLiveBroadcast ブール値 スポーツ イベントやコンサートなどのライブイベントの場合は、true に設定します。
potentialAction WatchAction 該当する場合は必須 - コンテンツがチャンネル非ライブ配信イベントとして配信される場合(contentToBeAnnouncedfalse または offAirfalse に設定されている場合)、このプロパティを使用してイベントのディープリンクを指定します。
identifier PropertyValue ブロードキャスト コンテンツを識別する外部 ID。詳細については、識別子プロパティのセクションをご覧ください。
  • 注: BroadcastEvent エンティティ タイプは、TMS_ID または TMS_ROOT_IDpropertyID 値のみを受け入れます。
  • このプロパティは、完全な形式のトップレベルの MovieTVSeriesTVEpisodeSportsEvent エンティティが workPerformed プロパティまたは broadcastOfEvent プロパティを使用して参照されていない場合にのみ指定する必要があります。
  • プロパティの値は、workPerformed または broadcastOfEvent プロパティを使用して参照するのが理想的である MovieTVSeriesTVEpisodeSportsEvent エンティティの TMS_ID または TMS_ROOT_ID を反映している必要があります。
  • TMS_ROOT_ID 値よりも TMS_ID が推奨されます。
contentRating Text または Rating アダルト コンテンツでは必須。それ以外の場合は強く推奨。理由- ブロードキャスト コンテンツの全体的なコンテンツ レーティング。コンテンツのレーティングをテキスト文字列の形式で指定する場合は、次の 2 つのバリエーションを使用できます。
  • レーティング機関によってレーティングの先頭にスペースが挿入されています。たとえば、米国の機関「MPAA」でレーティングが「PG-13」の場合は、「MPAA PG-13」と記述する必要があります。代理店のリストをご覧ください。
  • 値が「rating NOT KNOWN」(大文字と小文字を区別しない)の場合、映画のレーティングがわからないことを示します。
contentRating.author Text または Organization contentRatingRating を使用する場合は必須 - レーティング機関の名前。
contentRating.ratingValue テキスト contentRatingRating を使用する場合は必須 - 評価の値。
contentRating.advisoryCode テキスト コンテンツのアドバイザリ コード。有効な値には、D、FV、L、S、V があります。D = 対話、FV = ファンタジーの暴力、L = 言語、S = 性的なコンテンツ、V = 暴力。

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

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 分の間にテレビ ネットワークサンプル TVBroadcastService)で放送されるコンテンツが不明な場合に contentToBeAnnounced プロパティを使用している例です。

BroadcastEvent

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId",
  "name": "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"
        }
      ]
    }
  }
}

テレビ ネットワークのBroadcastService)チャンネルは午後 0 時から午後 8 時までオフエアで、午後 8 時から午後 12 時の間に My favorite show という名前の番組を 1 つ放送します。

BroadcastEvent

{
   "@context": ["http://schema.org", {"@language": "en"}],
   "@type": "BroadcastEvent",
   "@id": "http://example.com/randomUniqueEventId1",
   "name": “Off Air”,
   "startDate": "2019-10-12T00: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/randomUniqueEventId2",
  "startDate": "2019-10-12T20:00-08:00",
  "endDate": "2019-10-13T00:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "name": "My favorite show",
  "workPerformed": {
    ...
  },
  "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"
        }
      ]
    }
  }
}

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