ここでは、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 |
テキストまたは言語 | 強く推奨理由チャンネルのメインのブロードキャスト言語。IETF BCP 47 規格のいずれかの言語コードを使用してください。 |
category |
テキスト | 強く推奨理由アイテムのカテゴリ。カテゴリの階層を非公式に示すために、より大きな記号またはスラッシュを使用できます（スポーツ、スポーツ > フットボール、ニュース、映画、音楽、ドキュメンタリーなど）。 |
contentRating |
テキストまたは評価 | 成人向けのテレビ放送サービスで必須 - チャンネルで放送されるコンテンツに関する最も厳しいレーティング。コンテンツ レーティングがテキスト文字列の形式である場合、レーティング機関は空白文字を付加する必要があります。たとえば、米国では「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 文字（全角 150 文字）まで。配列を使用して複数の言語と長さの説明を提供します。 |
slogan |
テキスト | 放送サービスのスローガン。 |
areaServed |
Country、State、City、GeoShape | 必須 - テレビサービス プロバイダがチャンネルの切り替えに対応する場合に必須です。ユーザーがブロードキャスト サービスを利用できる地域です。国は、ISO 3166-1 国コードで指定します。 |
logo |
ImageObject | Google TV と統合する場合は必須です。強く推奨（それ以外の場合は理由）この放送サービスを表す画像。
|
potentialAction |
WatchAction | 必須（省略可） - アクションの詳細を提供するアクション マークアップ オブジェクト。詳しくは、アクションのマークアップ プロパティをご覧ください。
|
videoFormat |
テキスト | この放送サービスでサポートされる最高品質の定義（例:
|
broadcastTimezone |
テキスト | この放送サービスのタイムゾーン（IANA 形式、America/Los_Angeles など）。複数のタイムゾーンの場合は配列を使用します。 |
broadcastAffiliateOf |
組織 | 必須 - この放送サービスまたはこの放送サービスが属している組織の番組を提供する TV ネットワーク。 |
broadcastAffiliateOf.@id |
テキスト | 必須 - TV ネットワークの @id に設定します。 |
broadcastAffiliateOf.@type |
テキスト | 必須 - 常に Organization に設定されます。 |
identifier |
PropertyValue | 強く推奨理由- このエンティティを識別する外部 ID またはその他の ID（_PARTNER_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 ネットワーク、テレビ コンテンツ プロバイダ、またはテレビ事業者の名前。
|
description |
テキスト | 組織の説明。半角 300 文字（全角 150 文字）まで。配列を使用して複数の言語と長さの説明を提供します。 |
sameAs |
URL | 強く推奨理由テレビ ネットワークを特定できる Wikipedia ページの URL。url プロパティとは異なる値にする必要があります。1 つのチャネル/ネットワーク エンティティについて説明する 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"
}
]
}
}
関連ページ
これらのプロパティに関連するトピックについては、次のページを確認してください。