このセクションでは、BroadcastService、CableOrSatelliteService、TelevisionChannel、Organization エンティティ タイプのコンテンツ マークアップ プロパティについて詳しく説明します。これらのタイプの関係を理解するには、LiveTV チャンネルのコンセプトをご覧ください。
BroadcastService の仕様表
| プロパティ | タイプ | 説明 |
|---|---|---|
@context |
テキスト | 必須 - 常に ["http://schema.org", {"@language": "xx"}]に設定します。
|
@type |
テキスト | 必須 - 常に BroadcastService に設定します。 |
@id |
URL | 必須 - URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc です。@id は次の要件を満たす必要があります。
url は識別子としてのすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳細については、識別子セクションをご覧ください。 |
url |
URL | 該当する場合は必須 - インターネット上でチャンネルを視聴できる場合は、放送サービスの正規 URL。ケーブル/衛星/地上波で配信されるサービスの場合は省略可能です。Google は、この URL を使用して、フィード内のコンテンツを Google のデータベース内のコンテンツと照合します。url は次の要件を満たしている必要があります。
urlTemplate プロパティをご覧ください。 |
name |
テキスト | 必須 - ネットワークの名前。
|
broadcastDisplayName |
テキスト | 必須 - 一般的に番組ガイドなどでユーザーに表示される、ネットワークの表示名。この値は name と同じ値でもかまいません。 |
callSign |
テキスト | 放送サービスの公式な政府発行コールサイン。 |
inLanguage |
Text または Language | 強く推奨理由チャンネルのメイン放送言語。IETF BCP 47 標準の言語コードのいずれかを使用してください。 |
category |
テキスト | 強く推奨理由アイテムのカテゴリ。カテゴリの階層を非公式に示すには、大なり記号またはスラッシュを使用します。例: スポーツ、スポーツ > サッカー、ニュース、映画、音楽、ドキュメンタリー。 |
contentRating |
Text または Rating | アダルト専用 TV 放送サービスの場合は必須 - チャンネルで放送されるコンテンツに対する最も制限の厳しい格付け。コンテンツ格付けがテキスト文字列の形式で提供された場合は、格付けの前に空白を挟んで格付け機関を付加する必要があります。たとえば、米国の代理店「TVPG」からの「TV-Y」格付けは、「TVPG TV-Y」と記述します。代理店のリストをご覧ください。 |
contentRating.author |
組織 | contentRating で Rating が使用されている場合は必須 - 格付け機関の名前。 |
contentRating.ratingValue |
テキスト | contentRating で Rating が使用されている場合必須 - 格付けの値。 |
contentRating.advisoryCode |
テキスト | コンテンツに関する注意事項のコード。指定できる値は、D、FV、L、S、V です。D = 会話、FV = ファンタジーの暴力、L = 言語、S = 性的コンテンツ、V = 暴力。 |
description |
テキスト | 放送サービスの説明。300 文字以下。配列を使用して複数の言語と長さの説明を提供します。 |
slogan |
テキスト | 放送サービスのスローガン。 |
areaServed |
Country、State、City、または GeoShape | 該当する場合は必須 - チャンネル切り替えが テレビサービス プロバイダによって行われる場合、必須 - ユーザーが放送サービスの受信を期待できる地域。国を指定するには、ISO 3166-1 国コードを使用します。 |
logo |
ImageObject | GoogleTV と統合する場合は必須です。強く推奨理由?この放送サービスを表す画像。
|
potentialAction |
WatchAction | 該当する場合は必須 - アクションの詳細を提供するアクション マークアップ オブジェクト。詳細については、アクション マークアップ プロパティをご覧ください。
|
videoFormat |
テキスト | この放送サービスでサポートされる最高品質の定義。次に例を示します。
|
broadcastTimezone |
テキスト | 放送サービスの IANA 形式のタイムゾーン。America/Los_Angeles など。複数のタイムゾーンの場合は配列を使用します。 |
broadcastAffiliateOf |
組織 | 必須 - この放送サービスまたはこの放送サービスが属している組織の番組を提供する TV ネットワーク。 |
broadcastAffiliateOf.@id |
テキスト | 必須 - TV ネットワークの @id に設定します。 |
broadcastAffiliateOf.@type |
テキスト | 必須 - 常に Organization に設定します。 |
identifier |
PropertyValue | 強く推奨理由- _PARTNER_ID_ などの、このエンティティを識別する外部 ID またはその他の ID。複数の識別子を使用できます。詳細については、「識別子プロパティ」セクションをご覧ください。 |
popularityScore |
PopularityScoreSpecification | 強く推奨理由Google が他のシグナルと組み合わせてユーザーのために再生するメディアを決定するために使用するスコア。このスコアは、カタログ内の他のコンテンツと比較したそのコンテンツの人気度を表します。そのため、スコアの基準は、フィード全体、カタログ内のすべてのエンティティ間で一貫している必要があります。デフォルトで、エンティティの人気度スコアは 0 に設定されます。 |
popularityScore.@type |
テキスト | 常に PopularityScoreSpecification に設定。 |
popularityScore.value |
数値 | エンティティの人気度を示す 0 以上の数値。スコアが高いほど人気度が高いことを意味します。 |
popularityScore.eligibleRegion |
国 | この人気度スコアを適用可能な地域。人気度スコアがグローバルに適用可能な場合は、EARTH に設定します。デフォルトでは、このプロパティは EARTH に設定されています。Note: ロケール固有の人気度は、グローバル（EARTH）人気度より優先されます。 |
BroadcastService の例
{
"@context": [
"http://schema.org",
{
"@language": "en"
}
],
"@type": "BroadcastService",
"@id": "http://example.com/stations/example-tv",
"name": "EXAMPLE-TV",
"broadcastDisplayName": "ABCD",
"url": "http://example.com/stations/example-tv",
"callSign": "EXA-TV",
"videoFormat": "SD",
"inLanguage": "en",
"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"
}
],
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 178,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
},
"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",
"authenticator": {
"@type": "Organization",
"name": "TVE"
}
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
}
},
"logo": [
{
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Example Logo Light",
"contentUrl": "http://example.com/images/example-logo-light.jpg",
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": [
"forLightBackground"
]
}
]
},
{
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Example Logo Dark",
"contentUrl": "http://example.com/images/example-logo-dark.jpg",
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": [
"forDarkBackground"
]
}
]
}
]
}
CableOrSatelliteService の仕様表
| プロパティ | タイプ | 説明 |
|---|---|---|
@context |
テキスト | 必須 - 常に ["http://schema.org", {"@language": "xx"}]に設定します。
|
@type |
テキスト | 必須 - 常に CableOrSatelliteService に設定します。 |
@id |
URL | 必須 - URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc です。@id は次の要件を満たす必要があります。
url は識別子としてのすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳細については、識別子セクションをご覧ください。 |
name |
テキスト | 必須 - TV サービスの名前。
|
areaServed |
Country、State、City、または GeoShape | 必須 - ユーザーが放送サービスの受信を期待できる地域。
|
provider |
組織 | 必須 - 該当する場合は、サービスの親プロバイダ。たとえば、ExampleTV は地域サービス ExampleTV San Francisco と ExampleTV San Diego のプロバイダです。 |
provider.@id |
テキスト | 必須 - TV オペレータの ID。 |
provider.@type |
テキスト | 必須 - 常に Organization に設定します。 |
identifier |
PropertyValue | 強く推奨理由- この放送サービスの Gracenote TMS ID などの、このエンティティを識別する外部 ID またはその他の ID。複数の識別子を使用できます。詳細については、「識別子プロパティ」セクションをご覧ください。 |
CableOrSatelliteService の例
ケーブルまたは衛星放送サービスの例:
{
"@context":["http://schema.org", {"@language": "en"}],
"@type":"CableOrSatelliteService",
"@id":"http://example.com/provider-lineups/exampletv-san-francisco",
"name":"ExampleTV San Francisco",
"provider": {
"@type": "Organization",
"@id": "http://example.com/providers/exampletv"
},
"areaServed":[
{
"@type":"GeoShape",
"@id": "http://example.com/area1"
}
],
"identifier": {
"@type": "PropertyValue",
"propertyID": "TMS_ID",
"value": "12345"
}
}
{
"@type": "GeoShape",
"@id": "http://example.com/area1",
"addressCountry": "US",
"postalCode": [
"94118",
"94119"
]
}
Virtual Multichannel Video Programming Distributor（vMVPD）の例:
{
"@context":["http://schema.org", {"@language": "en"}],
"@type":"CableOrSatelliteService",
"@id":"http://example.com/providers/my-online-example-tv",
"name":"My Online Example TV",
"provider": {
"@type": "Organization",
"@id": "http://my-online-tv.com"
},
"areaServed":[
{
"@type":"Country",
"name": "US",
},
{
"@type":"Country",
"name": "CA",
}
]
}
TelevisionChannel の仕様表
| プロパティ | タイプ | 説明 |
|---|---|---|
@context |
テキスト | 必須 - 常に ["http://schema.org", {"@language": "xx"}]に設定します。
|
@type |
テキスト | 必須 - 常に TelevisionChannel に設定します。 |
@id |
URL | 必須 - URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc です。@id は次の要件を満たす必要があります。
url は識別子としてのすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳細については、識別子セクションをご覧ください。 |
broadcastChannelId |
テキスト | 必須 - この BroadcastService をケーブル、衛星、インターネット TV サービスとして識別可能な一意の識別子。
|
channelOrder |
数値 | GoogleTV では必須、それ以外の場合は省略可 - このプロパティは、Google TV との統合で電子番組ガイドにチャンネルを表示する順序を指定するために使用します。channelOrder は、フィード内のチャネル間で一意である必要があります。理想的には 1 から始めてください。channelOrder の値を負の値または 0 にすることはできません。 |
broadcastServiceTier |
テキスト | 次の値を使用します。
|
inBroadcastLineup |
CableOrSatelliteService | 必須 - このチャネルを視聴者に提供する CableOrSatelliteService の @id。 |
providesBroadcastService |
BroadcastService | 必須 - このチャネルが提供する番組の BroadcastService の @id。 |
TelevisionChannel の例
ケーブルまたは衛星放送テレビ チャンネルの例:
{
"@context":["http://schema.org", {"@language": "en"}],
"@type":"TelevisionChannel",
"@id":"http://example.com/channels/exampleTV/example-tv-7",
"broadcastChannelId":"7",
"channelOrder": 1,
"broadcastServiceTier":["Premium", "Standard"],
"inBroadcastLineup":{
"@type":"CableOrSatelliteService",
"@id":"http://example.com/providers/exampleTV-san-francisco"
},
"providesBroadcastService":{
"@type":"BroadcastService",
"@id":"http://example.com/stations/example-tv"
}
}
オンライン TV チャネルの例:
{
"@context":["http://schema.org", {"@language": "en"}],
"@type":"TelevisionChannel",
"@id":"http://example.com/channels/my-online-example-tv/sport-channel",
"broadcastChannelId":"sport-channel",
"channelOrder": 3,
"broadcastServiceTier":"Premium",
"inBroadcastLineup":{
"@type":"CableOrSatelliteService",
"@id":"http://example.com/providers/my-online-example-tv"
},
"providesBroadcastService":{
"@type":"BroadcastService",
"@id":"http://example.com/stations/sport-channel"
}
}
Organization の仕様表
| プロパティ | タイプ | 説明 |
|---|---|---|
@context |
テキスト | 必須 - 常に ["http://schema.org", {"@language": "xx"}]に設定します。
|
@type |
テキスト | 必須 - 常に Organization に設定します。 |
@id |
URL | 必須 - URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc です。@id は次の要件を満たす必要があります。
url は識別子としてのすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳細については、識別子セクションをご覧ください。 |
name |
テキスト | 必須 - TV ネットワーク、TV コンテンツ プロバイダ、TV 事業者の名前。
|
description |
テキスト | 組織の説明。300 文字以下。配列を使用して複数の言語と長さの説明を提供します。 |
sameAs |
URL | 強く推奨理由テレビ ネットワークを識別できる Wikipedia ページの URL。これは url プロパティとは異なる値にする必要があります。単一のチャンネル/ネットワーク エンティティについて説明している Wikipedia ページのみを入力してください。Wikipedia のページでは「チャンネル」という用語が使用されている場合があります。 |
potentialAction |
WatchAction | 該当する場合は必須 - 組織を参照する複数のチャンネル（BroadcastService）がある場合に必要です。アクションの詳細を提供するアクション マークアップ オブジェクト。詳細については、アクション マークアップ プロパティをご覧ください。
|
url |
URL | 組織の URL。Google は、この URL を使用して、この組織を Google のデータベース内の組織と正確に一致させます。 |
identifier |
PropertyValue | 強く推奨理由- このエンティティを識別する外部 ID またはその他の ID（この組織の TMS ID など）。複数の識別子を使用できます。詳細については、「識別子プロパティ」セクションをご覧ください。 |
popularityScore |
PopularityScoreSpecification | 強く推奨理由Google が他のシグナルと組み合わせてユーザーのために再生するメディアを決定するために使用するスコア。このスコアは、カタログ内の他のコンテンツと比較したそのコンテンツの人気度を表します。そのため、スコアの基準は、フィード全体、カタログ内のすべてのエンティティ間で一貫している必要があります。デフォルトで、エンティティの人気度スコアは 0 に設定されます。 |
popularityScore.@type |
テキスト | 常に PopularityScoreSpecification に設定。 |
popularityScore.value |
数値 | エンティティの人気度を示す 0 以上の数値。スコアが高いほど人気度が高いことを意味します。 |
popularityScore.eligibleRegion |
国 | この人気度スコアを適用可能な地域。人気度スコアがグローバルに適用可能な場合は、EARTH に設定します。デフォルトでは、このプロパティは EARTH に設定されています。Note: ロケール固有の人気度は、グローバル（EARTH）人気度より優先されます。 |
Organization の例
{
"@context":["http://schema.org", {"@language": "en"}],
"@type":"Organization",
"@id":"http://example.com/networks/abcd-network",
"name":"ABCD",
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "TMS_ID",
"value": "12345"
},
{
"@type": "PropertyValue",
"propertyID": "_PARTNER_ID_",
"value": "exampletv-12345"
}
],
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://example.com/networkstream",
"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": "2050-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"@id": "http://example.com/subscription",
"name": "ABCD",
"sameAs": "http://example.com/subscription",
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 178,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
}
]
}
}
関連ページ
これらのプロパティに関連するトピックについては、次のページを確認してください。