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

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

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

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`	テキスト	必須 - ネットワークの名前。<ph type="x-smartling-placeholder"> </ph> 配列を使用して、各種言語で名前を列挙します。複数の地域と言語の例をご覧ください。 1 つのロケール（言語と国のペア）につき 1 つの名前のみがサポートされます。
`broadcastDisplayName`	テキスト	必須 - 一般的に番組ガイドなどでユーザーに表示される、ネットワークの表示名。この値は name と同じ値でもかまいません。
`callSign`	テキスト	放送サービスの公式な政府発行コールサイン。
`inLanguage`	テキストまたは言語	強く推奨理由チャンネルのメインのブロードキャスト言語。IETF BCP 47 標準のいずれかの言語コードを使用してください。
`category`	テキスト	強く推奨理由商品アイテムのカテゴリ。大きい記号やスラッシュは、カテゴリ階層を非公式に表すために使用することができます。例: スポーツ >サッカー、ニュース、映画、音楽、ドキュメンタリー。
`contentRating`	Text または Rating	成人専用のテレビ放送サービスでは必須 - チャンネルで放送されるコンテンツに対する最も厳しいレーティング。コンテンツのレーティングがテキスト文字列の形式で指定されている場合、レーティング機関はレーティングの前に空白文字を付加する必要があります。たとえば“TV-Y”の代理店「TVPG」の評価は「TVPG TV-Y」と呼ばれます。代理店のリストをご覧ください。
`contentRating.author`	Text または Organization	`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	必須（該当する場合） - チャンネルの切り替えが TV サービスプロバイダによって提供される場合は必須 - ユーザーが放送サービスを受けることを期待できる地域。国の指定には ISO 3166-1 国コードを使用します。複数の地域を表すには配列を使用します。 Country、State、City と GeoShape を混在させないでください。
`logo`	ImageObject	Google TV と統合する場合は必須です。それ以外の場合は強く推奨理由この放送サービスを表す画像。 Google TV との統合には、暗い背景で使用できるロゴが 1 つ必要です。透明な背景に色または白のロゴを配置し、暗い背景でもはっきりと見えるようにします。ロゴの画像は、アスペクト比が 1:1、4:3、または 16:9（ご希望の順）で、解像度が 80×80 ピクセル以上である必要があります。ロゴを使用する背景の種類を指定するには、`additionalProperty` プロパティの一部としてカスタムプロパティ名 `contentAttributes` の `forDarkBackground` 値を使用します。アスペクト比を維持するためにパディングを追加した場合は、長さまたは幅のいずれか（両方は不可）を追加できます。その他の要件と仕様については、画像セクションをご覧ください。下記の例をご覧ください。
`potentialAction`	WatchAction	必須（該当する場合） - アクションの詳細を提供するアクションマークアップオブジェクト。詳しくは、アクションマークアップのプロパティをご覧ください。配列を使用して、複数の地域内の異なるディープリンクを指定します。「複数の地域と言語」の例をご覧ください。チャンネルの切り替えが TV サービスプロバイダによって行われる場合、ディープリンクの指定は任意です。
`videoFormat`	テキスト	この放送サービスでサポートされる最高画質の定義。例: 標準画質用の「SD」。ハイビジョン用の「HD」。 2K 解像度用の「2K」。 4K 解像度用の「4K」。 8K 解像度用の「8K」。
`broadcastTimezone`	テキスト	この放送サービスのタイムゾーン（IANA 形式）。例: America/Los_Angeles。複数のタイムゾーンの場合は配列を使用します。
`broadcastAffiliateOf`	組織	必須 - この放送サービスまたはこの放送サービスが属している組織の番組を提供する TV ネットワーク。
`broadcastAffiliateOf.@id`	テキスト	必須 - テレビネットワークの `@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"}]` に設定します。「xx」フィード内の文字列の言語を表します。各ルートエンティティコンテキストでは、その @language を BCP 47 形式の適切な言語コードに設定する必要があります。たとえば、言語がスペイン語に設定されている場合は、字幕や吹き替えの言語が英語であっても、名前はスペイン語であると見なされます。
`@type`	テキスト	必須 - 常に `CableOrSatelliteService` に設定します。
`@id`	URL	必須 - URI 形式のコンテンツの識別子。（例: https://example.com/1234abc）。 `@id` は次の要件を満たしている必要があります。カタログ全体でグローバルに一意静的 Unified Resource Identifier（URI）の形式エンティティの `url` は識別子としてのすべての要件を満たしているため、エンティティの `url` を `@id` として使用することをおすすめします。詳細については、識別子セクションをご覧ください。
`name`	テキスト	必須 - TV サービスの名前。<ph type="x-smartling-placeholder"> </ph> 複数の言語で名前を列挙するには、配列を使用します。複数の地域と言語の例をご覧ください。 1 つのロケール（言語と国のペア）につき 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`	番号	Google TV では必須、それ以外の場合は省略可 - このプロパティを使用して、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 ネットワーク、テレビコンテンツプロバイダ、またはテレビ事業者の名前。複数の言語で名前を列挙するには、配列を使用します。複数の地域と言語の例をご覧ください。 1 つのロケール（言語と国のペア）につき 1 つの名前のみがサポートされます。
`description`	テキスト	組織の説明。最大 300 文字。配列を使用して複数の言語と長さの説明を提供します。
`sameAs`	URL	強く推奨理由テレビネットワークを識別できる Wikipedia ページの URL。URL プロパティとは異なる値を指定する必要があります。1 つのチャンネル/ネットワークエンティティに関する Wikipedia ページのみを含めます。ウィキペディアのページでは、「チャンネル」という用語が使用されている場合があります。
`potentialAction`	WatchAction	必須（該当する場合） - 組織を参照する複数のチャンネル（BroadcastService）がある場合は必須です。アクションの詳細を提供するアクションマークアップオブジェクト。詳しくは、アクションマークアップのプロパティをご覧ください。配列を使用して、複数の地域内の異なるディープリンクを指定します。「複数の地域と言語」の例をご覧ください。チャンネルの切り替えが TV サービスプロバイダによって行われる場合、ディープリンクの指定は任意です。
`url`	URL	組織の URL。Google は、この URL を使用して、この組織を Google のデータベース内の組織と正確に一致させます。
`identifier`	PropertyValue	強く推奨理由- この組織の TMS ID など、このエンティティを識別する外部 ID またはその他の 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"
      }
    ]
  }
}