ライブ 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 文字(全角 150 文字)以内。配列を使用して複数の言語と長さの説明を含めます。
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 Text または Country 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 つのバリエーションを使用できます。
  • レーティング機関は、レーティングの先頭に空白文字を挿入します。たとえば、「PG-13」は代理店「MPAA」からの評価米国では「MPAA PG-13」と表記してください。代理店のリストをご覧ください。
  • 値が「RATING NOT KNOWN」(大文字と小文字は区別されません)は、Movie のレーティングが不明であることを示します。
contentRating.author 組織 contentRatingRating を使用している場合は必須 - レーティング機関の名前。
contentRating.ratingValue テキスト contentRatingRating を使用する場合は必須 - 評価の値。
contentRating.advisoryCode テキスト コンテンツのアドバイザリ コード。指定可能な値は、D、FV、L、S、V です。D = 対話、FV = ファンタジーの暴力、L = 言語、S = 性的なコンテンツ、V = 暴力。

テレビ エピソードがテレビ ネットワークで放送されている(テレビの例) (BroadcastService)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"
        }
      ]
    }
  }
}

コンテンツに対して contentToBeAnnounced プロパティを使用する方法を示す例 テレビ ネットワークで放送される Example TV 2019 年 10 月 12 日の午後 9 時から午後 9 時 30 分の間の(BroadcastService)は不明です フィードの作成時には、次のように設定します。

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)のチャンネルがオフエア 午後 12 時から午後 8 時の間、My favorite show という名前の 1 件の番組を 8 時の間に放送します 午後 12 時、午後 12 時:

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

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