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

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

BroadcastEvent の仕様表

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

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

BroadcastEvent エンティティには、次のいずれか 1 つ以上を含めることを強くおすすめします。
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnouncedtrue に設定
  • offAirtrue に設定
broadcastOfEvent.@type テキスト SportsEvent に設定します。
broadcastOfEvent.@id URL イベント エンティティの @id。イベント エンティティはフィードに存在し、BroadcastEvent@id とは異なる @id を持つ必要があります。
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 エンティティ タイプでは、propertyID 値として TMS_ID または TMS_ROOT_ID のいずれかのみを指定できます。
  • このプロパティは、workPerformed プロパティまたは broadcastOfEvent プロパティを使用して、完全に形成されたトップレベルの MovieTVSeriesTVEpisodeSportsEvent エンティティが参照されていない場合にのみ指定する必要があります。
  • このプロパティの値は、workPerformed プロパティまたは broadcastOfEvent プロパティを使用して参照するのが理想的な MovieTVSeriesTVEpisodeSportsEvent エンティティの TMS_ID または TMS_ROOT_ID を反映する必要があります。
  • TMS_IDTMS_ROOT_ID 値よりも優先されます。
contentRating テキスト または Rating 成人向けコンテンツの場合は必須、それ以外の場合は強く推奨されます。理由放送コンテンツの全体的なコンテンツのレーティング。コンテンツのレーティングがテキスト文字列の形式で提供された場合は、次の 2 つのバリエーションが使用できます。
  • 格付けの前に空白を挟んで格付け機関を付加します。たとえば、米国の代理店「MPAA」からの「PG-13」格付けは、「MPAA PG-13」と記述します。代理店のリストをご覧ください。
  • 映画のレーティングが不明であることを示す値「RATING NOT KNOWN」(大文字と小文字は区別されません)。
contentRating.author 組織 contentRatingRating が使用されている場合は必須 - 格付け機関の名前。
contentRating.ratingValue テキスト contentRatingRating が使用されている場合は必須 - 格付けの値。
contentRating.advisoryCode テキスト コンテンツのアドバイザリー コード。指定できる値は D、FV、L、S、V です。D = Dialogue(会話)、FV = Fantasy Violence(ファンタジー バイオレンス)、L = Language(言葉遣い)、S = Sexual Content(性的なコンテンツ)、V = Violence(暴力)。

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

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 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"
        }
      ]
    }
  }
}

テレビ ネットワーク Example TVBroadcastService)チャンネルは、午後 12 時から午後 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"
        }
      ]
    }
  }
}

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