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

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

ここでは、BroadcastServiceCableOrSatelliteServiceTelevisionChannelOrganization エンティティ タイプのコンテンツ マークアップ プロパティについて詳しく説明します。各タイプの関係については、LiveTV のコンセプト ページをご覧ください。

BroadcastService の仕様表

プロパティ タイプ 説明
@context Text 必須 - 常に ["http://schema.org", {"@language": "xx"}]
    に設定
  • "xx" はフィード内の文字列の言語を表します。各ルート エンティティのコンテキストは、その @language を BCP 47 形式の適切な言語コードに設定する必要があります。たとえば、言語をスペイン語に設定すると、字幕言語が英語であっても、名前はスペイン語とみなされます。
@type Text 必須 - 常に BroadcastService に設定されます。
@id URL 必須 - URI 形式のコンテンツ ID(例: https://example.com/1234abc)。
@id は次の要件を満たしている必要があります。
  • カタログ全体でグローバルに一意
  • 静的。ID は安定していて、時間の経過とともに変化しないはずです(番組の URL プロパティが変更されても変わりません)。これは不透明な文字列として扱われ、有効なリンクである必要はありません。
  • Unified Resource Identifier(URI)の形式
  • @id 値に使用するドメインが、自分の組織が所有するものであること。
エンティティの url は識別子としてすべての要件を満たしているため、エンティティの url@id として使用することをおすすめします。詳しくは、ID のセクションをご覧ください。
url URL 必須(該当する場合) - チャンネルがインターネットで視聴できる場合、ブロードキャスト サービスの正規 URL。ケーブル/衛星/無線で配信されるサービスの場合、省略可能です。Google はこの URL を使用して、フィード内のコンテンツと Google のデータベースのコンテンツを照合します。
url は次の要件を満たす必要があります。
  • url はグローバルに一意である必要があります
  • url には、Google がクロールできる有効な正規 URL を含める必要があります。
再生のディープリンクについては、代わりにターゲット オブジェクトの urlTemplate プロパティをご覧ください。
name Text 必須 - ネットワークの名前。
  • 配列を使用して、各種言語で名前を列挙します。「複数の地域と言語」の例をご覧ください。
  • ロケール(言語と国のペア)ごとにサポートされる名前は 1 つのみです。
broadcastDisplayName Text 必須 - 一般的に番組ガイドなどでユーザーに表示される、ネットワークの表示名。この値は name と同じ値でもかまいません。
callSign Text 放送サービスの公式な政府発行コールサイン。
inLanguage テキストまたは言語 強くおすすめする理由チャンネルのメインのブロードキャスト言語。IETF BCP 47 標準の言語コードのいずれかを使用してください。
category Text 強くおすすめする理由商品アイテムのカテゴリ。カテゴリの階層を非公式に表すために大きな記号やスラッシュを付けることもできます(例: スポーツ、スポーツ、サッカー、ニュース、映画、音楽、ドキュメンタリー)。
contentRating テキストまたは評価 成人向けテレビ放送サービスで必須 - 総合的なコンテンツのレーティング。コンテンツのレーティングがテキスト文字列の形式で示されている場合、レーティング代理店は、レーティングを先頭に空白を挿入します(例: 「TV-Y」である場合)。米国では、「TVPG TV-Y」と記載されます。代理店のリストをご覧ください。
contentRating.author テキスト または組織 contentRatingRating を使用している場合は必須 - レーティング代理店の名前。
contentRating.ratingValue Text contentRatingRating を使用している場合は必須 - 評価の値。
contentRating.advisoryCode Text コンテンツのアドバイザリ コード。有効な値は、D、FV、L、S、V です。D = 会話、FV = 空想上の暴力、L = 言語、S = 性的なコンテンツ、V = 暴力。
description Text ブロードキャスト サービスの説明。300 文字が上限です。配列を使用して複数の言語と長さの説明を提供します。
slogan Text 放送サービスのスローガン。
areaServed CountryStateCityGeoShape 必須(該当する場合) - チャンネル切り替えがテレビサービス プロバイダによって満たされている場合に必須 - ユーザーが放送サービスを期待できる地域。ISO 3166-1 国コードを使用して、国を指定します。
  • 複数の地域を表すには配列を使用します。
  • CountryStateCityGeoShape を混在させないでください。
  • logo ImageObject Google TV と統合する場合は必須です。強くおすすめします。理由: この放送サービスを表す画像。
    • ロゴの画像は、アスペクト比 4:3、1:1、16:9 で、それぞれ 32x32 ピクセル以上の解像度で表示する必要があります。
    • その他の要件と仕様については、イメージ セクションをご覧ください。
    • additionalProperty プロパティの一部として、カスタム プロパティ名 contentAttributesforLightBackgroundforDarkBackground の値を使用して、ロゴを使用する背景の種類を指定します。
    以下の例をご覧ください。
    potentialAction WatchAction 該当する場合は必須 - アクションの詳細を提供するアクション マークアップ オブジェクト。詳しくは、アクション マークアップのプロパティをご覧ください。
    videoFormat Text このブロードキャスト サービスでサポートされる最高品質の定義(例:
    • 標準画質用の「SD」。
    • ハイビジョン用の「HD」。
    • 2K 解像度用の「2K」。
    • 4K 解像度用の「4K」。
    • 8K 解像度用の「8K」。
    broadcastTimezone Text このブロードキャスト サービスのタイムゾーン。IANA 形式で指定します(例: America/Los_Angeles)。複数のタイムゾーンの場合は配列を使用します。
    broadcastAffiliateOf 組織 必須 - この放送サービスまたはこの放送サービスが属している組織の番組を提供する TV ネットワーク。
    broadcastAffiliateOf.@id Text 必須 - テレビ ネットワークの @id に設定します。
    broadcastAffiliateOf.@type Text 必須 - 常に Organization に設定されます。
    identifier PropertyValue 強くおすすめする理由- このエンティティを識別する外部 ID またはその他の ID(_PARTNER_ID_ など)。複数の識別子を使用できます。詳しくは、ID プロパティ セクションをご覧ください。
    popularityScore PopularityScoreSpecification 強くおすすめする理由Google が他のシグナルと組み合わせてユーザーのために再生するメディアを決定するために使用するスコア。このスコアは、カタログ内の他のコンテンツと比較したそのコンテンツの人気度を表します。そのため、スコアの基準は、フィード全体、カタログ内のすべてのエンティティ間で一貫している必要があります。デフォルトで、エンティティの人気度スコアは 0 に設定されます。
    popularityScore.@type Text 常に PopularityScoreSpecification に設定されます。
    popularityScore.value Number エンティティの人気度を示す 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 Text 必須 - 常に ["http://schema.org", {"@language": "xx"}]
      に設定
    • "xx" はフィード内の文字列の言語を表します。各ルート エンティティのコンテキストは、その @language を BCP 47 形式の適切な言語コードに設定する必要があります。たとえば、言語をスペイン語に設定すると、字幕言語が英語であっても、名前はスペイン語とみなされます。
    @type Text 必須 - 常に CableOrSatelliteService に設定されます。
    @id URL 必須 - URI 形式のコンテンツ ID(例: https://example.com/1234abc)。
    @id は次の要件を満たしている必要があります。
    • カタログ全体でグローバルに一意
    • 静的
    • Unified Resource Identifier(URI)の形式
    エンティティの url は識別子としてすべての要件を満たしているため、エンティティの url@id として使用することをおすすめします。詳しくは、ID のセクションをご覧ください。
    name Text 必須 - テレビサービスの名前。
    • 配列を使用して、さまざまな言語で名前を一覧表示します。「複数の地域と言語」の例をご覧ください。
    • ロケール(言語と国のペア)ごとにサポートされる名前は 1 つのみです。
    areaServed CountryStateCityGeoShape 必須 - ユーザーが放送サービスを期待できる地域。
    provider 組織 必須 - 該当する場合は、サービスの親プロバイダ。たとえば、ExampleTV 社は、その地域サービスの ExampleTV San FranciscoExampleTV San Diego のプロバイダです。
    provider.@id Text 必須 - TV オペレータの ID。
    provider.@type Text 必須 - 常に Organization に設定されます。
    identifier PropertyValue 強くおすすめする理由- このブロードキャスト サービスを識別する Gracenote TMS ID など、このエンティティを識別する外部 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 Text 必須 - 常に ["http://schema.org", {"@language": "xx"}]
      に設定
    • "xx" はフィード内の文字列の言語を表します。各ルート エンティティのコンテキストは、その @language を BCP 47 形式の適切な言語コードに設定する必要があります。たとえば、言語をスペイン語に設定すると、字幕言語が英語であっても、名前はスペイン語とみなされます。
    @type Text 必須 - 常に TelevisionChannel に設定されます。
    @id URL 必須 - URI 形式のコンテンツ ID(例: https://example.com/1234abc)。
    @id は次の要件を満たしている必要があります。
    • カタログ全体でグローバルに一意
    • 静的
    • Unified Resource Identifier(URI)の形式
    エンティティの url は識別子としてすべての要件を満たしているため、エンティティの url@id として使用することをおすすめします。詳しくは、ID のセクションをご覧ください。
    broadcastChannelId Text 必須 - この BroadcastService がケーブル、衛星、インターネット TV サービスとして識別できる一意の識別子。
    • 米国では、多くの場合、ケーブル TV や衛星 TV の番号です。
    • インターネット TV サービス(vMVPD など)の場合は、チャネル名を指定します。
    channelOrder Number Google TV の場合は必須、それ以外の場合は必須 - このプロパティを使用すると、Google TV 統合用の電子プログラミング ガイドで、チャンネルを表示する順序を指定できます。

    channelOrderはフィード内の複数のチャネル間で一意である必要があり、1 から始めるのが理想的です。channelOrder に負の値または 0 の値は指定できません。
    broadcastServiceTier Text 次の値を使用します。
    • 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 Text 必須 - 常に ["http://schema.org", {"@language": "xx"}]
      に設定
    • "xx" はフィード内の文字列の言語を表します。各ルート エンティティのコンテキストは、その @language を BCP 47 形式の適切な言語コードに設定する必要があります。たとえば、言語をスペイン語に設定すると、字幕言語が英語であっても、名前はスペイン語とみなされます。
    @type Text 必須 - 常に Organization に設定されます。
    @id URL 必須 - URI 形式のコンテンツ ID(例: https://example.com/1234abc)。
    @id は次の要件を満たしている必要があります。
    • カタログ全体でグローバルに一意
    • 静的
    • Unified Resource Identifier(URI)の形式
    エンティティの url は識別子としてすべての要件を満たしているため、エンティティの url@id として使用することをおすすめします。詳しくは、ID のセクションをご覧ください。
    name Text 必須 - テレビ ネットワーク、テレビ コンテンツ プロバイダ、テレビ オペレータの名前。
    • 配列を使用して、さまざまな言語で名前を一覧表示します。「複数の地域と言語」の例をご覧ください。
    • ロケール(言語と国のペア)ごとにサポートされる名前は 1 つのみです。
    description Text 組織の説明。300 文字が上限です。配列を使用して複数の言語と長さの説明を提供します。
    sameAs URL 強くおすすめする理由テレビ ネットワークを識別できるウィキペディア ページの URL です。これを url プロパティとは別にする必要があります。単一のチャネル / ネットワーク エンティティに関する Wikipedia ページのみを入力します。Wikipedia のページでは、「チャネル」という用語が使用されている場合があります。
    potentialAction WatchAction 該当する場合必須 - 組織を参照する複数のチャンネル(BroadcastService)がある場合は必須。アクションの詳細を提供するアクション マークアップ オブジェクト。詳しくは、アクション マークアップのプロパティをご覧ください。
    url URL 組織の URL。Google は、この URL を使用して、この組織を Google のデータベース内の組織と正確に一致させます。
    identifier PropertyValue 強くおすすめする理由- このエンティティの識別に使用される外部 ID またはその他の ID(この組織の TMS ID など)。複数の識別子を使用できます。詳しくは、ID プロパティ セクションをご覧ください。
    popularityScore PopularityScoreSpecification 強くおすすめする理由Google が他のシグナルと組み合わせてユーザーのために再生するメディアを決定するために使用するスコア。このスコアは、カタログ内の他のコンテンツと比較したそのコンテンツの人気度を表します。そのため、スコアの基準は、フィード全体、カタログ内のすべてのエンティティ間で一貫している必要があります。デフォルトで、エンティティの人気度スコアは 0 に設定されます。
    popularityScore.@type Text 常に PopularityScoreSpecification に設定されます。
    popularityScore.value Number エンティティの人気度を示す 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"
          }
        ]
      }
    }
    

    これらのプロパティに関連するトピックについては、次のページを確認してください。