直播電視頻道的內容標記屬性

本節提供 BroadcastServiceCableOrSatelliteServiceTelevisionChannelOrganization 實體類型的內容標記屬性詳細資料。如要進一步瞭解這些類型之間的關係,請參閱「電視直播頻道」概念。

BroadcastService 規格表格

屬性 預期類型 說明
@context 文字 必要 - 一律設為 ["http://schema.org", {"@language": "xx"}]
  • 「xx」的位置會呈現動態饋給中字串的語言。每個根實體內容都應將 @language 設為適當的語言代碼,並採用 BCP 47 格式。舉例來說,如果將語言設為西班牙文,即使字幕/配音語言是英文,系統也會假設名稱是以西班牙文顯示。
@type 文字 必要 - 一律設為 BroadcastService
@id 網址 必要 - 內容 ID,以 URI 格式表示;例如 https://example.com/1234abc
@id 必須符合下列規定:
  • 產品目錄全球不重複
  • 靜態;這個 ID 應固定,不會隨時間而改變 (即使節目的網址資源有所變更),系統會視為不透明字串,且不一定要是有效連結。
  • 採用統一資源識別碼 (URI) 格式
  • 用於 @id 值的網域必須由貴機構所擁有。
由於實體的 url 符合 ID 的所有規定,因此我們建議您使用實體的 url 做為 @id。詳情請參閱「ID」一節。
url 網址 如適用:如果頻道可透過網際網路觀看廣播服務的標準網址,則此為必填屬性。對於透過有線/衛星/無線傳輸的服務,此為選用功能。Google 會使用這個網址,將你的動態饋給內容與 Google 資料庫中的內容進行比對。
url必須符合下列規定:
  • url 須為全域唯一值
  • url 必須包含可供 Google 檢索的有效標準網址。
如需播放的深層連結,請改為參閱目標物件的 urlTemplate 屬性。
name 文字 必要 - 網路的名稱。
  • 使用陣列列出不同語言的名稱。請參閱「多個區域和語言」範例。
  • 請注意,每個語言代碼 (語言/國家/地區組合) 僅支援一個名稱。
broadcastDisplayName 文字 必要 - 使用者通常會在節目指南等中看到的網路顯示名稱。這個值可以與名稱值相同。
callSign 文字 官方政府核發的廣播服務呼號。
inLanguage TextLanguage 強烈建議原因頻道的主要廣播語言。請使用 IETF BCP 47 標準的其中一種語言代碼。
category 文字 強烈建議原因商品類別。較大型的符號或斜線,可用於正式表示類別階層。例如:運動、運動 >足球、新聞、電影、音樂、紀錄片。`
contentRating TextRating 僅限成人的電視廣播服務的必要項目 - 頻道直播內容設有最嚴格的分級。如果內容分級是以文字字串的形式表示,分級機構必須在分級前加上空格;例如「TV-Y」來自代理商「TVPG」的分級包括「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 CountryStateCityGeoShape 如適用 - 如果頻道切換鈕由電視服務供應商填入,則此為必填屬性 - 使用者可預期接收廣播服務的區域。請使用 ISO 3166-1 國家/地區代碼來指定國家/地區。
  • 使用陣列來表示多個區域。
  • 請勿將 CountryStateCityGeoShape 搭配使用。
  • logo ImageObject 如要與 Google TV 整合,此為必填屬性。強烈建議在其他情況下推薦原因代表這項廣播服務的圖片。
    • Google TV 整合功能需要一個可用於深色背景的標誌。這類產品使用透明背景,搭配彩色或白色標誌,且在深色背景上清晰可見。
    • 標誌圖片的顯示比例應為 1:1、4:3 或 16:9 (按照偏好順序),且解析度應為 80x80 像素以上。
    • additionalProperty 屬性中,請使用自訂屬性名稱 contentAttributesforDarkBackground 值,指出使用標誌的背景類型。
    • 如果為了維持長寬比,則支援長度或寬度的邊框間距 (但兩者不能同時填)。
    • 如要瞭解其他需求和規格,請參閱圖片一節。
    請參閱下方範例
    potentialAction WatchAction 如果適用,則為必要:提供動作詳細資料的動作標記物件。詳情請參閱動作標記屬性
    videoFormat 文字 這項廣播服務支援的最高畫質;例如:
    • 「SD 標準畫質」「標準內容」規則
    • 「HD」。
    • 「2,000」2K 解析度
    • 「4K」4K 解析度
    • 「8,000」7K 解析度
    broadcastTimezone 文字 這項廣播服務的時區 (IANA 格式);例如 America/Los_Angeles。使用陣列指定多個時區。
    broadcastAffiliateOf 機構組織 必要 - 提供此廣播服務節目或該廣播服務所屬組織的電視網路。
    broadcastAffiliateOf.@id 文字 必要 - 請設為電視聯播網的 @id
    broadcastAffiliateOf.@type 文字 必要 - 一律設為 Organization
    identifier PropertyValue 強烈建議原因- 可識別這個實體的外部 ID,例如 _PARTNER_ID_。你可以使用多個 ID。詳情請參閱「ID 屬性」一節。
    popularityScore PopularityScoreSpecification 強烈建議原因Google 運用分數和其他信號來判斷要向使用者顯示的媒體。這個分數代表相較於你的目錄中其他內容,該內容的熱門程度。因此,動態饋給中所有實體的分數都必須一致。根據預設,實體的熱門程度分數會設為 0。
    popularityScore.@type 文字 一律設為 PopularityScoreSpecification
    popularityScore.value Number 非負數的數值,用來表示實體的熱門程度;分數越高表示熱門程度越高。
    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 網址 必要 - 內容 ID,以 URI 格式表示;例如 https://example.com/1234abc
    @id 必須符合下列規定:
    • 產品目錄全球不重複
    • 靜態
    • 採用統一資源識別碼 (URI) 格式
    由於實體的 url 符合 ID 的所有規定,因此我們建議您使用實體的 url 做為 @id。詳情請參閱「ID」一節。
    name 文字 必要 - 電視服務的名稱。
    • 使用陣列列出不同語言的名稱。請參閱「多個區域和語言」範例。
    • 請注意,每個語言代碼 (語言/國家/地區組合) 僅支援一個名稱。
    areaServed CountryStateCityGeoShape 必要 - 使用者希望收到廣播服務的區域。
    provider 機構組織 必要 - 服務的上層提供者 (如適用)。舉例來說,ExampleTVExampleTV San FranciscoExampleTV San Diego 區域服務的供應商。
    provider.@id 文字 必要 - 電視業者的 ID。
    provider.@type 文字 必要 - 一律設為 Organization
    identifier PropertyValue 強烈建議原因- 可識別這個實體的外部 ID,例如這個廣播服務的 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"
      ]
    }
    

    虛擬多頻道影片策劃發布商 (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 網址 必要 - 內容 ID,以 URI 格式表示;例如 https://example.com/1234abc
    @id 必須符合下列規定:
    • 產品目錄全球不重複
    • 靜態
    • 採用統一資源識別碼 (URI) 格式
    由於實體的 url 符合 ID 的所有規定,因此我們建議您使用實體的 url 做為 @id。詳情請參閱「ID」一節。
    broadcastChannelId 文字 必要 - 此為專屬 ID,BroadcastService可供識別為有線電視、衛星電視或網路電視服務。
    • 在美國,這通常會是有線電視或衛星電視的專用數字。
    • 如果是網路電視服務 (例如 vMVPD),請提供頻道名稱。
    channelOrder Number 如果是 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"
      }
    }
    

    線上電視頻道範例:

    {
      "@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"
      }
    }
    

    機構規格表格

    屬性 預期類型 說明
    @context 文字 必要 - 一律設為 ["http://schema.org", {"@language": "xx"}]
    • 「xx」的位置會呈現動態饋給中字串的語言。每個根實體內容都應將 @language 設為適當的語言代碼,並採用 BCP 47 格式。舉例來說,如果將語言設為西班牙文,即使字幕/配音語言是英文,系統也會假設名稱是以西班牙文顯示。
    @type 文字 必要 - 一律設為 Organization
    @id 網址 必要 - 內容 ID,以 URI 格式表示;例如 https://example.com/1234abc
    @id 必須符合下列規定:
    • 產品目錄全球不重複
    • 靜態
    • 採用統一資源識別碼 (URI) 格式
    由於實體的 url 符合 ID 的所有規定,因此我們建議您使用實體的 url 做為 @id。詳情請參閱「ID」一節。
    name 文字 必要 - 電視聯播網、電視內容供應商或電視業者的名稱。
    • 使用陣列列出不同語言的名稱。請參閱「多個區域和語言」範例。
    • 請注意,每個語言代碼 (語言/國家/地區組合) 僅支援一個名稱。
    description 文字 機構的說明。長度上限為 300 個半形字元。使用陣列提供多種語言和/或不同長度的說明。
    sameAs 網址 強烈建議原因可識別電視電視網的維基百科頁面網址。這個值必須與網址資源不同。只能填入提及單一管道/聯播網實體的維基百科頁面。請注意,維基百科網頁可能會使用「channel」這個術語。
    potentialAction WatchAction 如適用 (如適用):如有多個頻道 (BroadcastService) 參照該機構,則此為必要欄位。用於提供動作詳細資料的動作標記物件。詳情請參閱動作標記屬性
    url 網址 機構的網址。Google 會使用這個網址來準確比對此組織與 Google 資料庫中的機構。
    identifier PropertyValue 強烈建議原因- 可識別這個實體的外部 ID,例如這個機構的 TMS ID。你可以使用多個 ID。詳情請參閱「ID 屬性」一節。
    popularityScore PopularityScoreSpecification 強烈建議原因Google 運用分數和其他信號來判斷要向使用者顯示的媒體。這個分數代表相較於你的目錄中其他內容,該內容的熱門程度。因此,動態饋給中所有實體的分數都必須一致。根據預設,實體的熱門程度分數會設為 0。
    popularityScore.@type 文字 一律設為 PopularityScoreSpecification
    popularityScore.value Number 非負數的數值,用來表示實體的熱門程度;分數越高表示熱門程度越高。
    popularityScore.eligibleRegion 國家/地區 適用此熱門程度分數的區域。如果熱門程度分數適用於全球,請設為 EARTH。這個屬性的預設值為 EARTH
    Note: 各地的熱門程度高於全球 (EARTH) 熱門程度

    機構範例

    {
      "@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"
          }
        ]
      }
    }
    

    請參閱下列網頁,瞭解與這些房源相關的主題: