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

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

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 つのロケール(言語と国のペア)につき 1 つの名前のみがサポートされます。
broadcastDisplayName テキスト 必須 - 一般的に番組ガイドなどでユーザーに表示される、ネットワークの表示名。この値は name と同じ値でもかまいません。
callSign テキスト 放送サービスの公式な政府発行コールサイン。
inLanguage テキストまたは言語 強く推奨理由チャンネルのメインのブロードキャスト言語。IETF BCP 47 標準のいずれかの言語コードを使用してください。
category テキスト 強く推奨理由商品アイテムのカテゴリ。大きい記号やスラッシュは、カテゴリ階層を非公式に表すために使用することができます。例: スポーツ >サッカー、ニュース、映画、音楽、ドキュメンタリー。
contentRating Text または Rating 成人専用のテレビ放送サービスでは必須 - チャンネルで放送されるコンテンツに対する最も厳しいレーティング。コンテンツのレーティングがテキスト文字列の形式で指定されている場合、レーティング機関はレーティングの前に空白文字を付加する必要があります。たとえば“TV-Y”の代理店「TVPG」の評価は「TVPG TV-Y」と呼ばれます。代理店のリストをご覧ください。
contentRating.author 組織 contentRatingRating を使用している場合は必須 - レーティング機関の名前。
contentRating.ratingValue テキスト contentRatingRating を使用する場合は必須 - 評価の値。
contentRating.advisoryCode テキスト コンテンツのアドバイザリ コード。指定可能な値は、D、FV、L、S、V です。D = 対話、FV = ファンタジーの暴力、L = 言語、S = 性的なコンテンツ、V = 暴力。
description テキスト ブロードキャスト サービスの説明。最大 300 文字。配列を使用して複数の言語と長さの説明を提供します。
slogan テキスト 放送サービスのスローガン。
areaServed CountryStateCityGeoShape 必須(該当する場合) - チャンネルの切り替えが TV サービス プロバイダによって提供される場合は必須 - ユーザーが放送サービスを受けることを期待できる地域。国の指定には ISO 3166-1 国コードを使用します。
  • 複数の地域を表すには配列を使用します。
  • CountryStateCityGeoShape を混在させないでください。
  • logo ImageObject Google TV と統合する場合は必須です。それ以外の場合は強く推奨理由この放送サービスを表す画像。
    • Google TV との統合には、暗い背景で使用できるロゴが 1 つ必要です。透明な背景に色または白のロゴを配置し、暗い背景でもはっきりと見えるようにします。
    • ロゴの画像は、アスペクト比が 1:1、4:3、または 16:9(ご希望の順)で、解像度が 80×80 ピクセル以上である必要があります。
    • ロゴを使用する背景の種類を指定するには、additionalProperty プロパティの一部としてカスタム プロパティ名 contentAttributesforDarkBackground 値を使用します。
    • アスペクト比を維持するためにパディングを追加した場合は、長さまたは幅のいずれか(両方は不可)を追加できます。
    • その他の要件と仕様については、画像セクションをご覧ください。
    下記の例をご覧ください。
    potentialAction WatchAction 必須(該当する場合) - アクションの詳細を提供するアクション マークアップ オブジェクト。詳しくは、アクション マークアップのプロパティをご覧ください。
    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 サービスの名前。
    • 複数の言語で名前を列挙するには、配列を使用します。複数の地域と言語の例をご覧ください。
    • 1 つのロケール(言語と国のペア)につき 1 つの名前のみがサポートされます。
    areaServed CountryStateCityGeoShape 必須 - ユーザーがブロードキャスト サービスを受けることが想定される地域。
    provider 組織 必須 - 該当する場合は、サービスの親プロバイダ。たとえば、ExampleTV は、ExampleTV San FranciscoExampleTV 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)がある場合は必須です。アクションの詳細を提供するアクション マークアップ オブジェクト。詳しくは、アクション マークアップのプロパティをご覧ください。
    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"
          }
        ]
      }
    }
    

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