このセクションでは、BroadcastEvent
エンティティ タイプのコンテンツ マークアップ プロパティの詳細について説明します。これらのタイプの関係について詳しくは、LiveTV イベントのコンセプトをご覧ください。
BroadcastEvent の仕様表
プロパティ | タイプ | 説明 |
---|---|---|
@context |
テキスト | 必須 - 常に ["http://schema.org", {"@language": "xx"}] に設定します。
|
@type |
テキスト | 必須 - 常に BroadcastEvent に設定します。 |
@id |
URL | 必須 - URI 形式のコンテンツの識別子(例: https://example.com/1234abc)。@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 | 該当する場合は必須 - コンテンツが Movie 、TVSeries 、TVEpisode のいずれかのエンティティ タイプの場合、このプロパティを使用します。BroadcastEvent エンティティには、少なくとも 1 つを含めることを強くおすすめします。
|
workPerformed.@type |
テキスト | Movie 、TVSeries 、または TVEpisode に設定します。 |
workPerformed.@id |
URL | コンテンツ エンティティの @id 。 |
broadcastOfEvent |
SportsEvent | 該当する場合は必須 - コンテンツがライブイベントの場合にこのプロパティを使用します。
BroadcastEvent エンティティには、少なくとも次のいずれか 1 つを含めることを強くおすすめします。
|
broadcastOfEvent.@type |
テキスト | SportsEvent に設定します。 |
broadcastOfEvent.@id |
URL | イベント エンティティの @id 。イベント エンティティはフィード内に存在し、@id が BroadcastEvent のエンティティとは異なる必要があります。 |
location |
テキストまたは国 | BroadcastEvent が SportsEvent の場合は必須(broadcastOfEvent プロパティがある場合) - 基になる SportsEvent をブロードキャストできる国。複数の国で SportsEvent をブロードキャストできる場合は、このフィールドに国のリストを指定できます。 |
videoFormat |
テキスト | この放送サービスでサポートされている最高品質の定義。例:
|
contentToBeAnnounced |
ブール値 | 該当する場合は必須 - フィードの作成時にコンテンツが不明な場合は、このプロパティを使用します。 プロバイダにブロードキャストされる最新情報がない場合は true に設定します。それ以外の場合は false に設定します。BroadcastEvent エンティティには、次のうち少なくとも 1 つを含めることを強くおすすめします。
|
offAir |
ブール値 | 該当する場合は必須 - 対象のタイムスロットのコンテンツ ブロードキャストが予定されていない場合は、このプロパティを使用します。BroadcastEvent エンティティには、少なくとも次のいずれか 1 つを含めることを強くおすすめします。
|
isLiveBroadcast |
ブール値 | スポーツ イベントやコンサートなどのライブイベントの場合は、true に設定します。 |
potentialAction |
WatchAction | 該当する場合は必須 - コンテンツがチャンネル非ライブ配信イベントとして配信される場合(contentToBeAnnounced が false または offAir が false に設定されている場合)、このプロパティを使用してイベントのディープリンクを指定します。 |
identifier |
PropertyValue | ブロードキャスト コンテンツを識別する外部 ID。詳細については、識別子プロパティのセクションをご覧ください。
|
contentRating |
Text または Rating | アダルト コンテンツでは必須。それ以外の場合は強く推奨。理由- ブロードキャスト コンテンツの全体的なコンテンツ レーティング。コンテンツのレーティングをテキスト文字列の形式で指定する場合は、次の 2 つのバリエーションを使用できます。
|
contentRating.author |
Text または Organization | contentRating が Rating を使用する場合は必須 - レーティング機関の名前。 |
contentRating.ratingValue |
テキスト | contentRating が Rating を使用する場合は必須 - 評価の値。 |
contentRating.advisoryCode |
テキスト | コンテンツのアドバイザリ コード。有効な値には、D、FV、L、S、V があります。D = 対話、FV = ファンタジーの暴力、L = 言語、S = 性的なコンテンツ、V = 暴力。 |
例
あるテレビ エピソードが、テレビ ネットワーク Example TV(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"
}
]
}
}
}
以下は、フィードの作成時に、2019 年 10 月 12 日の午後 9 時から午後 9 時 30 分の間にテレビ ネットワークサンプル TV(BroadcastService
)で放送されるコンテンツが不明な場合に 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"
}
]
}
}
}
関連ページ
これらのプロパティに関連するトピックについては、次のページを確認してください。