このセクションでは、BroadcastEvent
エンティティ タイプのコンテンツ マークアップ プロパティについて詳しく説明します。これらのタイプの関係をより深く理解するには、ライブテレビ イベントのコンセプトをご覧ください。
BroadcastEvent の仕様表
プロパティ | タイプ | 説明 |
---|---|---|
@context |
テキスト | 必須 - 常に ["http://schema.org", {"@language": "xx"}] に設定します。
|
@type |
テキスト | 必須 - 常に BroadcastEvent に設定します。 |
@id |
URL | 必須 - URI 形式のコンテンツの識別子。(例: https://example.com/1234abc)。@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 | 該当する場合は必須 - コンテンツが 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 |
Text または Country | 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 |
組織 | contentRating で Rating を使用している場合は必須 - レーティング機関の名前。 |
contentRating.ratingValue |
テキスト | contentRating が Rating を使用する場合は必須 - 評価の値。 |
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"
}
]
}
}
}
関連ページ
これらのプロパティに関連するトピックについては、次のページを確認してください。