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

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

本節將說明 BroadcastService、CableOrSatelliteService、TelevisionChannel、Organization 實體類型的內容標記屬性。如要進一步瞭解這些類型之間的關係，請參閱 LiveTV 頻道概念。

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` 符合 ID 的所有必要條件，建議您將實體的 `url` 做為 `@id`。詳情請參閱「識別碼」一節。
`url`	網址	如適用，則為必要欄位：如果頻道可透過網際網路觀看，請提供廣播服務的標準網址。如透過有線/衛星/無線方式提供服務，則不必提供。Google 會使用這個網址，將動態饋給中的內容與 Google 資料庫中的內容進行比對。 `url` 必須符合下列規定： `url` 須為全域唯一值 `url` 必須包含 Google 可檢索的有效標準網址。如要取得播放內容的深層連結，請改為參閱 target 物件的 `urlTemplate` 屬性。
`name`	Text	必填：網路名稱。使用陣列列出不同語言的名稱。請參閱「多個地區和語言」範例。請注意，每個語言代碼 (語言-國家/地區組合) 只支援一個名稱。
`broadcastDisplayName`	Text	必填：使用者通常會在節目指南等地方看到的電視網顯示名稱。這個值可以與名稱值相同。
`callSign`	Text	廣播服務的官方政府核發呼號。
`inLanguage`	Text 或 Language	強烈建議頻道的主要播送語言。請使用 IETF BCP 47 標準中的其中一個語言代碼。
`category`	Text	強烈建議商品類別。你可以使用大於號或斜線，非正式地指出類別階層，例如「體育、體育 > 足球、新聞、電影、音樂、紀錄片」。
`contentRating`	文字或評分	僅限成人觀看的電視廣播服務必須填寫：頻道上播出的內容最嚴格的分級。如果內容分級是以文字字串的形式提供，則分級機構必須置於分級前方，中間以空格分隔；例如，美國機構「TVPG」的「TV-Y」分級，會以「TVPG TV-Y」表示。請參閱代理商清單。使用陣列列出不同代理商的評分。針對每個代理商使用最嚴格的分級，且不得重複指定特定代理商。
`contentRating.author`	機構組織	如果 `contentRating` 使用 `Rating`，則為必要屬性：評級機構名稱。
`contentRating.ratingValue`	Text	如果 `contentRating` 使用 `Rating`，則為必要屬性 - 評分值。
`contentRating.advisoryCode`	Text	內容的警示代碼。可接受的值包括 D、FV、L、S 和 V。D = 對話、FV = 奇幻暴力、L = 語言、S = 性內容、V = 暴力。
`description`	Text	廣播服務的說明。長度上限為 300 個半形字元。使用陣列提供多種語言和/或不同長度的說明。
`slogan`	Text	廣播服務的標語。
`areaServed`	國家/地區、州/省、城市或GeoShape	如適用，則為必要 - 如果頻道切換由電視服務供應商執行，則為必要 - 使用者可預期接收廣播服務的地區。請使用 ISO 3166-1 國家/地區代碼指定國家/地區。使用陣列來表示多個區域。請勿將 Country、State、City 與 GeoShape 混用。
`logo`	ImageObject	如果與 GoogleTV 整合，則為必填屬性。否則強烈建議原因代表這項廣播服務的圖片。 GoogleTV 整合功能需要一個可用於深色背景的標誌。背景應為透明，標誌則應為彩色或白色，且在深色背景上清晰可見。標誌圖片的顯示比例應為 1:1、4:3 或 16:9 (依優先順序)，解析度至少為 80 x 80 像素。請使用自訂屬性名稱 `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，例如 _PARTNER_ID_。可使用多個 ID。詳情請參閱「ID 屬性」一節。
`popularityScore`	PopularityScoreSpecification	強烈建議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` 符合 ID 的所有必要條件，建議您將實體的 `url` 做為 `@id`。詳情請參閱「識別碼」一節。
`name`	Text	必填：電視服務名稱。使用陣列列出不同語言的名稱。請參閱「多個地區和語言」範例。請注意，每個語言代碼 (語言-國家/地區組合) 只支援一個名稱。
`areaServed`	國家/地區、州/省、城市或GeoShape	必填：使用者可預期接收廣播服務的地區。請使用 ISO 3166-1 國家/地區代碼指定國家/地區。使用陣列來表示多個區域。請勿將 Country、State 和 City 與 GeoShape 混用。如需詳細規定，請參閱「GeoShape 屬性」一節。
`provider`	機構組織	必要：服務的父項供應商 (如適用)。舉例來說，ExampleTV 是ExampleTV 舊金山和ExampleTV 聖地牙哥的區域服務供應商。
`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` 符合 ID 的所有必要條件，建議您將實體的 `url` 做為 `@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` 符合 ID 的所有必要條件，建議您將實體的 `url` 做為 `@id`。詳情請參閱「識別碼」一節。
`name`	Text	必填：電視聯播網、電視內容供應商或電視營運商的名稱。使用陣列列出不同語言的名稱。請參閱「多個地區和語言」範例。請注意，每個語言代碼 (語言-國家/地區組合) 只支援一個名稱。
`description`	Text	機構說明。長度上限為 300 個半形字元。使用陣列提供多種語言和/或不同長度的說明。
`sameAs`	網址	強烈建議可識別電視網絡的維基百科網頁網址。這個屬性必須與 url 屬性不同。請只填入討論單一頻道/聯播網實體的 Wikipedia 頁面。請注意，維基百科頁面可能會使用「管道」一詞。
`potentialAction`	WatchAction	如適用，則為必要屬性：如果您有多個頻道 (BroadcastService) 參照機構，則必須提供此屬性。提供動作詳細資料的動作標記物件。詳情請參閱動作標記屬性。使用陣列指定多個區域中的不同深層連結。請參閱「多個地區和語言」範例。如果頻道切換是由電視服務供應商負責，則可選擇提供深層連結。
`url`	網址	機構的網址。Google 會使用這個網址，將這個機構與 Google 資料庫中的機構進行準確比對。
`identifier`	PropertyValue	強烈建議- 可識別此實體的外部 ID 或其他 ID，例如該機構的 TMS ID。可使用多個 ID。詳情請參閱「ID 屬性」一節。
`popularityScore`	PopularityScoreSpecification	強烈建議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"
      }
    ]
  }
}