本頁面由 Cloud Translation API 翻譯而成。

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

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

BroadcastService 規格表

屬性	預期類型	說明
`@context`	Text	必要 - 一律設定為 `["http://schema.org", {"@language": "xx"}]` 「xx」代表字串中的字串語言。每個根實體內容都必須將 @language 設為適當的 BCP 47 格式語言代碼。舉例來說，如果語言設為西班牙文，即使字幕/配音語言為英文，系統仍將以西班牙文輸入。
`@type`	Text	必要 - 一律設為 `BroadcastService`。
`@id`	網址	必要 - 內容 ID 的 URI 格式，例如 https://example.com/1234abc。 `@id` 必須符合下列規定：在目錄中所有不重複的產品靜態；影片 ID 應固定，且不會隨時間改變 (即使節目的網址屬性有所變更)。系統會將其視為不透明字串，且不一定要是有效連結。格式為統一資源識別碼 (URI) @id 值使用的網域必須由貴機構所擁有。。由於實體的 `url` 符合所有需求條件，因此建議您使用實體的 `url` 做為 `@id`。詳情請參閱「ID」一節。
`url`	網址	必要 (如果適用)：播送服務的標準網址 (如果頻道可在網際網路上觀看)。對於透過有線電視/衛星服務/無線傳輸的服務，這是選擇性性。Google 會使用這個網址比對動態饋給中的內容與 Google 資料庫中的內容。「`url`」必須符合下列規定：「`url`」不得重複 `url` 必須包含有效的標準網址，以供 Google 檢索。如需播放的深層連結，請改為參閱目標物件的 `urlTemplate` 屬性。
`name`	Text	必要 - 網路的名稱。請使用陣列列出不同語言的名稱。請參閱支援多種語言和語言的範例。請注意，每個語言代碼 (語言-國家/地區組合) 僅支援一個名稱。
`broadcastDisplayName`	Text	必要 - 使用者通常能在節目指南中看到的聯播網顯示名稱；值可能與名稱相同。
`callSign`	Text	政府發布的廣播服務招牌。
`inLanguage`	文字或語言	強烈建議為什麼？頻道的主要廣播語言。請使用 IETF BCP 47 標準中的其中一個語言代碼。
`category`	Text	強烈建議為什麼？商品類別。較寬的符號或斜線可用來非正式的指定類別階層，例如「運動」、「運動」>「足球」、「新聞」、「電影」、「音樂」、「紀錄片」。
`contentRating`	文字或評分	這是僅限成人使用的電視廣播服務的必要選項：這是針對頻道內容播送最嚴格的限制。如果內容分級採用「文字」字串，則內容分級前必須在內容分級開頭加上空格，例如美國的「TVPG」分級是「TVPG TV-Y」。請參閱代理商清單。
`contentRating.author`	文字或機構	如果 `contentRating` 使用 `Rating`，則為必要欄位 - 評分機構的名稱。
`contentRating.ratingValue`	Text	如果 `contentRating` 使用 `Rating`，則為必要值。
`contentRating.advisoryCode`	Text	內容的諮詢程式碼。接受的值包括：D、FV、L、S 和 V。D = Dialogue, FV = Fantasy Violence, L = Language, S = 色情內容，V = 暴力。
`description`	Text	廣播服務的說明。長度上限為 300 個半形字元請使用陣列提供多種語言和/或時間長度不同的說明。
`slogan`	Text	廣播服務的標語。
`areaServed`	Country、State、City 或 GeoShape	必要 (如果適用)：如果頻道切換設定已由電視服務供應商填寫 - 使用者預期可以接收廣播服務的區域，就必須完成這項設定。請使用 ISO 3166-1 國家/地區代碼指定國家/地區。使用陣列來代表多個區域。請勿將 Country、State、City 和 GeoShape 混合。
`logo`	ImageObject	如果與 Google TV 整合，則為必填。強烈建議，否則為什麼？代表這項廣播服務的圖片。如要使用 Google TV 整合項目，必須有可在深色背景上使用的標誌。背景應是透明背景 (彩色或白色標誌)，在深色背景中清楚可見。標誌圖片應採用 1:1 或 4:3 或 16:9 的顯示比例 (依偏好順序)，解析度至少須為 80x80 像素。將自訂屬性名稱 `contentAttributes` 的 `forDarkBackground` 值做為 `additionalProperty` 屬性的一部分，使用標誌使用的背景類型。如果延長長寬比，系統可以支援任何長度或寬度的邊框間距，但請勿同時保留兩者。如要瞭解其他需求和規格，請參閱「圖片」一節。請參閱下方範例
`potentialAction`	WatchAction	必要 (必要) - 動作標記物件，提供動作的詳細資料。詳情請參閱動作標記屬性。使用陣列指定多個區域的不同深層連結。請參閱支援多種語言和語言的範例。如果頻道切換功能已由電視服務供應商填入，可以選擇是否要提供深層連結。
`videoFormat`	Text	此廣播服務支援的最高品質定義，例如「SD」代表標準畫質。如為高畫質，請選取「HD」。「2K」代表 2K 解析度。「4K」代表 4K 解析度。「8K」代表 8K 解析度。
`broadcastTimezone`	Text	這項廣播服務的時區，採用 IANA 格式，例如 America/Los_Angeles。陣列包含多個時區。
`broadcastAffiliateOf`	機構組織	必要 - 提供這項廣播服務或節目所屬的機構的電視聯播網。
`broadcastAffiliateOf.@id`	Text	必要 - 設為電視聯播網的 `@id`。
`broadcastAffiliateOf.@type`	Text	必要 - 一律設為 `Organization`。
`identifier`	PropertyValue	強烈建議為什麼？- 代表這個實體的外部 ID 或其他 ID，例如 _PARTNER_ID_。可使用多個 ID。詳情請參閱「ID 屬性」一節。
`popularityScore`	熱門分數規範	強烈建議為什麼？Google 會根據分數和其他信號，決定向使用者播放的媒體。這個分數代表內容相對於目錄中其他內容的熱門程度，因此該分數在動態饋給中的所有實體中必須保持一致。實體的熱門程度預設為 0。
`popularityScore.@type`	Text	一律設為 `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`	Text	必要 - 一律設定為 `["http://schema.org", {"@language": "xx"}]` 「xx」代表字串中的字串語言。每個根實體內容都必須將 @language 設為適當的 BCP 47 格式語言代碼。舉例來說，如果語言設為西班牙文，即使字幕/配音語言為英文，系統仍將以西班牙文輸入。
`@type`	Text	必要 - 一律設為 `CableOrSatelliteService`。
`@id`	網址	必要 - 內容 ID 的 URI 格式，例如 https://example.com/1234abc。 `@id` 必須符合下列規定：在目錄中所有不重複的產品靜態格式為統一資源識別碼 (URI) 。由於實體的 `url` 符合所有需求條件，因此建議您使用實體的 `url` 做為 `@id`。詳情請參閱「ID」一節。
`name`	Text	必要 - 電視服務的名稱。請使用陣列列出不同語言的名稱。請參閱支援多種語言和語言的範例。請注意，每個語言代碼 (語言-國家/地區組合) 僅支援一個名稱。
`areaServed`	Country、State、City 或 GeoShape	必要 - 使用者預期可以接收廣播服務的區域。請使用 ISO 3166-1 國家/地區代碼指定國家/地區。使用陣列來代表多個區域。請勿將 Country、State、City 和 GeoShape 混合。詳細規定請參閱 GeoShape 屬性一節。
`provider`	機構組織	必要 - 服務的父項供應商 (如適用)。舉例來說，「ExampleTV」是區域服務 ExampleTV San Francisco 和「ExampleTV San Diego」等區域的服務供應商。
`provider.@id`	Text	必要 - 電視業者的 ID。
`provider.@type`	Text	必要 - 一律設為 `Organization`。
`identifier`	PropertyValue	強烈建議為什麼？- 可識別這個實體的外部 ID 或其他 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`	Text	必要 - 一律設定為 `["http://schema.org", {"@language": "xx"}]` 「xx」代表字串中的字串語言。每個根實體內容都必須將 @language 設為適當的 BCP 47 格式語言代碼。舉例來說，如果語言設為西班牙文，即使字幕/配音語言為英文，系統仍將以西班牙文輸入。
`@type`	Text	必要 - 一律設為 `TelevisionChannel`。
`@id`	網址	必要 - 內容 ID 的 URI 格式，例如 https://example.com/1234abc。 `@id` 必須符合下列規定：在目錄中所有不重複的產品靜態格式為統一資源識別碼 (URI) 。由於實體的 `url` 符合所有需求條件，因此建議您使用實體的 `url` 做為 `@id`。詳情請參閱「ID」一節。
`broadcastChannelId`	Text	必要 - 會將這個 `BroadcastService` 視為有線電視、衛星網路或網際網路電視服務的專用 ID。在美國境內，這通常是有線電視或衛星電視的一個數字。如果是網際網路電視服務 (例如 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"
  }
}

線上電視頻道範例：

{
  "@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`	Text	必要 - 一律設定為 `["http://schema.org", {"@language": "xx"}]` 「xx」代表字串中的字串語言。每個根實體內容都必須將 @language 設為適當的 BCP 47 格式語言代碼。舉例來說，如果語言設為西班牙文，即使字幕/配音語言為英文，系統仍將以西班牙文輸入。
`@type`	Text	必要 - 一律設為 `Organization`。
`@id`	網址	必要 - 內容 ID 的 URI 格式，例如 https://example.com/1234abc。 `@id` 必須符合下列規定：在目錄中所有不重複的產品靜態格式為統一資源識別碼 (URI) 。由於實體的 `url` 符合所有需求條件，因此建議您使用實體的 `url` 做為 `@id`。詳情請參閱「ID」一節。
`name`	Text	必要 - 電視聯播網、電視內容供應者或電視業者的名稱。請使用陣列列出不同語言的名稱。請參閱支援多種語言和語言的範例。請注意，每個語言代碼 (語言-國家/地區組合) 僅支援一個名稱。
`description`	Text	機構的說明。長度上限為 300 個半形字元請使用陣列提供多種語言和/或時間長度不同的說明。
`sameAs`	網址	強烈建議為什麼？可識別電視聯播網的維基百科頁面網址。這個值必須與網址屬性不同。僅在維基百科上介紹「單一」頻道/網路實體。請注意，維基百科頁面中可能會使用「頻道」一詞。
`potentialAction`	WatchAction	必要 (如果適用) - 如果你有多個頻道 (BroadcastService)，就必須提供此項目。動作標記物件，提供動作的詳細資料。詳情請參閱動作標記屬性。使用陣列指定多個區域的不同深層連結。請參閱支援多種語言和語言的範例。如果頻道切換功能已由電視服務供應商填入，可以選擇是否要提供深層連結。
`url`	網址	機構的網址。Google 會使用這個網址準確比對這個機構與 Google 資料庫中的機構。
`identifier`	PropertyValue	強烈建議為什麼？- 可識別這個實體的外部 ID 或其他 ID，例如這個機構的 TMS ID。可使用多個 ID。詳情請參閱「ID 屬性」一節。
`popularityScore`	熱門分數規範	強烈建議為什麼？Google 會根據分數和其他信號，決定向使用者播放的媒體。這個分數代表內容相對於目錄中其他內容的熱門程度，因此該分數在動態饋給中的所有實體中必須保持一致。實體的熱門程度預設為 0。
`popularityScore.@type`	Text	一律設為 `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"
      }
    ]
  }
}