このページは Cloud Translation API によって翻訳されました。

ライブ TV チャネルのコンテンツマークアッププロパティ

このセクションでは、BroadcastService、CableOrSatelliteService、TelevisionChannel、Organization エンティティタイプのコンテンツマークアッププロパティについて詳しく説明します。これらのタイプの関係を理解するには、LiveTV チャンネルのコンセプトをご覧ください。

BroadcastService の仕様表

プロパティ	タイプ	説明
`@context`	テキスト	必須 - 常に `["http://schema.org", {"@language": "xx"}]` に設定します。ここで「xx」は、フィード内の文字列の言語を表します。各ルートエンティティコンテキストの @language は、BCP 47 形式の適切な言語コードに設定する必要があります。たとえば、言語がスペイン語に設定されている場合、字幕/吹き替えの言語が英語であっても、名前はスペイン語であると見なされます。
`@type`	テキスト	必須 - 常に `BroadcastService` に設定します。
`@id`	URL	必須 - URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc です。 `@id` は次の要件を満たす必要があります。カタログ全体でグローバルに一意静的。ID は、番組の URL プロパティが変更されても、時間が経過しても変化しないものにする必要があります。これは不透明な文字列として扱われ、有効なリンクである必要はありません。 Unified Resource Identifier（URI）の形式 @id 値に使用するドメインが、自分の組織が所有するものであること。エンティティの `url` は識別子としてのすべての要件を満たしているため、エンティティの `url` を `@id` として使用することをおすすめします。詳細については、識別子セクションをご覧ください。
`url`	URL	該当する場合は必須 - インターネット上でチャンネルを視聴できる場合は、放送サービスの正規 URL。ケーブル/衛星/地上波で配信されるサービスの場合は省略可能です。Google は、この URL を使用して、フィード内のコンテンツを Google のデータベース内のコンテンツと照合します。 `url` は次の要件を満たしている必要があります。 `url` はグローバルに一意である必要があります `url` には Google がクロールすることが可能な機能する正規 URL を含める必要があります。再生のディープリンクについては、代わりに、ターゲットオブジェクトの `urlTemplate` プロパティをご覧ください。
`name`	テキスト	必須 - ネットワークの名前。配列を使用して、各種言語で名前を列挙します。複数の地域と言語の例をご覧ください。ロケール（言語と国）ごとにサポートされる名前は 1 つだけです。
`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 国コードを使用します。複数の地域を表すには配列を使用します。 Country、State、City を GeoShape と組み合わせないでください。
`logo`	ImageObject	GoogleTV と統合する場合は必須です。強く推奨理由この放送サービスを表す画像。 Google TV との統合には、暗い背景で使用できるロゴが 1 つ必要です。背景は透明にし、色付きまたは白のロゴを配置します。ロゴは、暗い背景でもはっきりと見えるものにしてください。ロゴの画像は、アスペクト比が 1:1、4:3、または 16:9（優先順位は上記の順）で、解像度が 80x80 ピクセル以上である必要があります。 `additionalProperty` プロパティの一部としてカスタムプロパティ名 `contentAttributes` に `forDarkBackground` 値を使用して、ロゴを使用する背景のタイプを指定します。縦横比を維持するために長さまたは幅（両方ではない）にパディングを追加することは許可されています。その他の要件と仕様については、画像のセクションをご覧ください。以下の例をご覧ください。
`potentialAction`	WatchAction	該当する場合は必須 - アクションの詳細を提供するアクションマークアップオブジェクト。詳細については、アクションマークアッププロパティをご覧ください。配列を使用して、複数の地域内の異なるディープリンクを指定します。「複数の地域と言語」の例をご覧ください。チャンネル切り替えがテレビサービスプロバイダによって行われる場合、ディープリンクの指定は省略可能です。
`videoFormat`	テキスト	この放送サービスでサポートされる最高品質の定義。次に例を示します。標準画質用の「SD」。ハイビジョン用の「HD」。 2K 解像度用の「2K」。 4K 解像度用の「4K」。 8K 解像度用の「8K」。
`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"}]` に設定します。ここで「xx」は、フィード内の文字列の言語を表します。各ルートエンティティコンテキストの @language は、BCP 47 形式の適切な言語コードに設定する必要があります。たとえば、言語がスペイン語に設定されている場合、字幕/吹き替えの言語が英語であっても、名前はスペイン語であると見なされます。
`@type`	テキスト	必須 - 常に `CableOrSatelliteService` に設定します。
`@id`	URL	必須 - URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc です。 `@id` は次の要件を満たす必要があります。カタログ全体でグローバルに一意静的 Unified Resource Identifier（URI）の形式エンティティの `url` は識別子としてのすべての要件を満たしているため、エンティティの `url` を `@id` として使用することをおすすめします。詳細については、識別子セクションをご覧ください。
`name`	テキスト	必須 - TV サービスの名前。複数の言語で名前を列挙するには、配列を使用します。複数の地域と言語の例をご覧ください。ロケール（言語と国）ごとにサポートされる名前は 1 つだけです。
`areaServed`	Country、State、City、または GeoShape	必須 - ユーザーが放送サービスの受信を期待できる地域。国を指定するには、ISO 3166-1 国コードを使用します。複数の地域を表すには配列を使用します。 Country、State、City を GeoShape と組み合わせないでください。詳細な要件については、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"}]` に設定します。ここで「xx」は、フィード内の文字列の言語を表します。各ルートエンティティコンテキストの @language は、BCP 47 形式の適切な言語コードに設定する必要があります。たとえば、言語がスペイン語に設定されている場合、字幕/吹き替えの言語が英語であっても、名前はスペイン語であると見なされます。
`@type`	テキスト	必須 - 常に `TelevisionChannel` に設定します。
`@id`	URL	必須 - URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc です。 `@id` は次の要件を満たす必要があります。カタログ全体でグローバルに一意静的 Unified Resource Identifier（URI）の形式エンティティの `url` は識別子としてのすべての要件を満たしているため、エンティティの `url` を `@id` として使用することをおすすめします。詳細については、識別子セクションをご覧ください。
`broadcastChannelId`	テキスト	必須 - この `BroadcastService` をケーブル、衛星、インターネット TV サービスとして識別可能な一意の識別子。米国では、多くの場合、ケーブル TV や衛星 TV の番号です。インターネット TV サービス（vMVPD など）の場合は、チャネル名を指定します。
`channelOrder`	数値	GoogleTV では必須、それ以外の場合は省略可 - このプロパティは、Google TV との統合で電子番組ガイドにチャンネルを表示する順序を指定するために使用します。 `channelOrder` は、フィード内のチャネル間で一意である必要があります。理想的には 1 から始めてください。`channelOrder` の値を負の値または 0 にすることはできません。
`broadcastServiceTier`	テキスト	次の値を使用します。購読が不要なチャネル用の `Free`。基本購読に含まれるチャネルの場合は `Standard`。基本購入をした上でさらに支払いが必要なチャネル用の `Premium`。複数の値を指定するには、配列を使用します。
`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"}]` に設定します。ここで「xx」は、フィード内の文字列の言語を表します。各ルートエンティティコンテキストの @language は、BCP 47 形式の適切な言語コードに設定する必要があります。たとえば、言語がスペイン語に設定されている場合、字幕/吹き替えの言語が英語であっても、名前はスペイン語であると見なされます。
`@type`	テキスト	必須 - 常に `Organization` に設定します。
`@id`	URL	必須 - URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc です。 `@id` は次の要件を満たす必要があります。カタログ全体でグローバルに一意静的 Unified Resource Identifier（URI）の形式エンティティの `url` は識別子としてのすべての要件を満たしているため、エンティティの `url` を `@id` として使用することをおすすめします。詳細については、識別子セクションをご覧ください。
`name`	テキスト	必須 - TV ネットワーク、TV コンテンツプロバイダ、TV 事業者の名前。複数の言語で名前を列挙するには、配列を使用します。複数の地域と言語の例をご覧ください。ロケール（言語と国）ごとにサポートされる名前は 1 つだけです。
`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"
      }
    ]
  }
}