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

電視節目的內容標記屬性

本節將詳細說明 TVSeries、TVEpisode 和 TVSeason 實體類型的內容標記屬性。

您可以選擇是否要提供 TVSeason 做為完整實體。詳情請參閱「TVSeries、TVSeason 和 TVEpisode 關聯」一節。

規格表

TVSeries

屬性	預期類型	說明
`@context`	Text	必要 - 一律設為 `["http://schema.org", {"@language": "xx"}]` 其中「xx」代表動態饋給中的字串語言。每個根實體內容都應將 @language 設為適當的語言代碼，格式為 BCP 47 格式。舉例來說，如果語言設為西班牙文，系統會假設名稱為西班牙文，即使字幕/配音語言為英文也一樣。
`@type`	Text	必要：一律設為 `TVSeries`。
`@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	必填：節目的名稱。使用陣列列出不同語言的名稱。請參閱「多個地區和語言」範例。請注意，每個語言代碼 (語言-國家/地區組合) 只支援一個名稱。
`titleEIDR`	Text	強烈建議- EIDR (Entertainment Identifier Registry) 識別碼，用於表示最一般/抽象層級的電影或電視作品。舉例來說，「權力遊戲」(Game of Thrones) 這部電視影集的 titleEIDR 為「10.5240/C1B5-3BA1-8991-A571-8472-W」。
`potentialAction`	WatchAction	如適用則為必要屬性：提供動作詳細資料的動作標記物件。如果內容可在隨選影片 (VoD) 中觀看，就必須使用這個屬性；Action 標記物件需要提供內容的深層連結。如果內容可在 LiveTV 頻道上觀看，則可選擇使用這項屬性；相關聯的 `BroadcastService` 實體會提供頻道的深層連結。 `TVSeries` 可用於隨選影片和直播。使用陣列指定多個區域中的不同深層連結。請參閱「多個地區和語言」範例。
`sameAs`	網址	強烈建議可識別節目的參考網頁網址，例如節目的維基百科網頁。這必須與 `url` 屬性不同。
`inLanguage`	Text	系列叢書的原文語言，格式為 BCP 47。
`genre`	Text	所有相關類型的排序清單。例如：`["Action", "Fashion", "Environment", "Football"]`
`keywords`	Text	用來描述這項內容的關鍵字或標記。也允許關鍵字陣列。舉例來說，["feature, biography"] 可以是描述內容的關鍵字陣列。
`releasedEvent`	`PublicationEvent`、`FeaturedEvent` 或 `ExclusiveEvent`	強烈建議- `PublicationEvent` 用於指定發布者原始 (全球或本地) 發布內容，例如電影的原始戲院上映日期。此外，請使用 `FeaturedEvent` 指出您的服務將這項內容行銷為原創、精選、特輯等。 `ExclusiveEvent` 則可指定您的服務擁有獨家發行權，並包含發行地點和時間。詳情和範例請參閱示例。
`releasedEvent.@type`	Text	必要：請務必將這個屬性設為下列其中一個值： `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	國家/地區	必填：與這項活動相關聯的區域。如果是 `PublicationEvent`，則是內容發布區域。如果是 `FeaturedEvent` 和 `ExclusiveEvent`，則是內容精選或獨家區域。請使用 ISO 3166 國家/地區代碼。如要表示全世界，請將其設為 `EARTH`。
`releasedEvent.startDate`	Date 或 DateTime	建議 - `ExclusiveEvent` 必填 - 實體的發布日期。對於 `PublicationEvent`，這表示實體的初始發布日期，例如電影首次在戲院上映的日期。對於 `ExclusiveEvent` 和 `FeaturedEvent`，這表示實體的獨家或精選內容開始日期。
`releasedEvent.endDate`	Date 或 DateTime	建議 - `ExclusiveEvent` 為必填屬性 - 僅適用於 `ExclusiveEvent` 和 `FeaturedEvent` 類型。對於 `ExclusiveEvent`，此屬性代表內容權利到期日。對於 `FeaturedEvent`，此屬性代表供應商最後一次刊登實體的日期。如果內容是永久專屬或精選，請將 `endDate` 設為自目前日期起算的 20 年。
`releasedEvent.publishedBy`	機構或個人	選填：發布這個實體的機構或人員。
`description`	Text	強烈建議節目的簡介。請提供情節摘要，而非事實摘要。長度上限為 300 個半形字元。使用陣列標記多種語言的說明。請參閱「多個地區和語言」範例。
`actor`	Person 或 PerformingGroup 或 PerformanceRole	強烈建議該系列影集的演員陣容陣列。請參閱這篇文章的建模指南。
`director`	Person	強烈建議節目的導演。
`producer`	機構或個人	強烈建議節目的製作人。
`image`	ImageObject	Google TV 專屬必填：與 TVSeries 相關的圖片。如要進一步瞭解 `image` 所需和選用的屬性，請參閱「圖片屬性」。
`trailer.description`	Text	預告片的說明。請參閱預告片示例。
`trailer.inLanguage`	Text	預告片的語言，格式為 BCP 47。
`trailer.url`	網址	預告片的網址，由相關製作公司或授權來源公開代管及上傳。
`trailer.regionsAllowed`	Place	允許觀看這部媒體的區域。如果未指定，系統會假設任何地方的使用者都可以瀏覽這部影片。請採用 ISO 3166 格式來指定國家/地區。
`identifier`	PropertyValue	強烈建議- 可明確識別此實體的外部 ID 或其他 ID。可使用多個 ID。詳情請參閱「ID 屬性」一節。
`popularityScore`	PopularityScoreSpecification	強烈建議Google 會使用這個分數，搭配其他信號，判斷要為使用者播放哪些媒體。這個分數代表內容相對於目錄中其他內容的熱門程度，因此分數的評分標準必須在目錄中的所有實體和動態消息中保持一致。實體的熱門程度分數預設為 0。
`popularityScore.@type`	Text	一律設為 `PopularityScoreSpecification`。
`popularityScore.value`	Number	非負數值，表示實體的熱門程度；分數越高，代表熱門程度越高。
`popularityScore.eligibleRegion`	國家/地區	這個熱門程度分數適用的區域。如果人氣分數適用於全球，請將其設為 `EARTH`。根據預設，此屬性會設為 `EARTH`。 `Note:` 當地熱門程度優先於全球 (EARTH) 熱門程度
`review`	評論	查看電視影集的分級
`review.reviewRating`	評分	如果提供 `review`，則為必填屬性：用於指定評論中給予的評分。
`contentRating`	文字或評分	成人內容必填，其他內容則強烈建議填寫：整體內容分級。如果內容分級是以文字字串的形式提供，系統會接受兩種變化形式：評級機構會在評級前加上空格，舉例來說，美國「TVPG」評級的「TV-MA」分級應描述為「TVPG TV-MA」。請參閱代理商清單。值為「RATING NOT KNOWN」(大小寫皆可)，表示您不知道內容的評級。
`contentRating.author`	機構組織	如果 `contentRating` 使用 `Rating`，則為必要屬性：評等機構名稱。如要查看接受的內容分級機構清單，請參閱「內容分級機構」頁面
`contentRating.ratingValue`	Text	如果 `contentRating` 使用 `Rating`，則為必要屬性 - 評分值。
`contentRating.advisoryCode`	Text	內容的警示代碼。可接受的值包括 D、FV、L、S 和 V。D = 對話、FV = 奇幻暴力、L = 語言、S = 性內容、V = 暴力。

TVEpisode

屬性	預期類型	說明
`@context`	Text	必要 - 一律設為 `["http://schema.org", {"@language": "xx"}]` 其中「xx」代表動態饋給中的字串語言。每個根實體內容都應將 @language 設為適當的語言代碼，格式為 BCP 47 格式。舉例來說，如果語言設為西班牙文，系統會假設名稱為西班牙文，即使字幕/配音語言為英文也一樣。
`@type`	Text	必要：一律設為 `TVEpisode`。
`@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	必填：劇集名稱。使用陣列列出不同語言的名稱。請參閱「多語言表示法」範例。請注意，每個語言代碼 (語言-國家/地區組合) 只支援一個名稱。
`titleEIDR`	Text	強烈建議- EIDR (Entertainment Identifier Registry) 識別碼，用於表示最一般/抽象層級的電影或電視作品。舉例來說，如果電視影集的名稱為「Game of Thrones」，第 1 季第 1 集的 titleEIDR 為「10.5240/B6A6-1B32-B5E5-D5CB-6B84-X」。
`editEIDR`	Text	強烈建議- EIDR (Entertainment Identifier Registry) 識別碼，代表電影或電視作品的特定編輯 / 版本。舉例來說，電視影集「Game of Thrones」第一季第一集的 TitleEIDR 為「10.5240/B6A6-1B32-B5E5-D5CB-6B84-X」，其中包含一個編輯版本，編輯版本的 TitleEIDR 為「10.5240/FB97-C847-2969-D0AB-ECD1-C」。提供 editEIDR 時，必須使用 `titleEIDR` 屬性。
`inLanguage`	Text	系列叢書的原文語言，格式為 BCP 47。
`episodeNumber`	整數	必填：這個數字表示該集節目在該季節目中的順序位置。`episodeNumber` 需要為每個季節重啟，也就是說，每個季節的第一集必須是 1。
`partOfSeason`	TVSeason	必填：這個劇集所屬的電視季別。即使 `TVEpisode` 沒有對應的 `TVSeason`，您仍需提供 `partOfSeason.@id` 和 `partOfSeason.seasonNumber` 屬性。解決方法如下：以 `partofSeries.@id` (例如 http://www.example.com/my_favorite_tv_show) 為例，附加預留位置查詢欄位 (例如 ?season1) 即可建立不重複的 `partOfSeason.@id` (例如 http://www.example.com/my_favorite_tv_show?season1)。將 `partOfSeason.seasonNumber` 設為 1。
`partOfSeason.@type`	Text	必要：一律設為 `TVSeason`。
`partOfSeason.@id`	網址	必填：這個劇集所屬 `TVSeason` 的 `@id`。
`partOfSeason.seasonNumber`	整數	必填：這個數字代表該季在電視影集季別順序中的編號。
`partOfSeries`	TVSeries	必填：該集所屬的電視影集。
`partOfSeries.@type`	Text	必要：一律設為 `TVSeries`。
`partOfSeries.@id`	網址	必填：這個劇集所屬 `TVSeries` 的 `@id`。
`partOfSeries.name`	Text	必填：電視影集的名稱。
`partOfSeries.sameAs`	Text	可識別節目的參考網頁網址，例如節目的維基百科網頁。這必須與 `url` 屬性不同。
`potentialAction`	WatchAction	如適用，則為必要屬性：提供動作詳細資料的動作標記物件。如果內容可在隨選影片 (VoD) 中觀看，就必須使用這個屬性；Action 標記物件需要提供內容的深層連結。如果內容可在 LiveTV 頻道上觀看，則可選擇使用這項屬性；相關聯的 `BroadcastService` 實體會提供頻道的深層連結。 `TVEpisode` 可用於隨選影片和直播。使用陣列指定多個區域中的不同深層連結。請參閱「多個地區和語言」範例。
`sameAs`	強烈建議網址	可識別單集的參考網頁網址，例如單集的維基百科網頁。這必須與 `url` 屬性不同。
`duration`	時間長度	劇集的放送時間，採用 ISO 8601 格式。請使用以下格式：「PT00H00M」。
`releasedEvent`	`PublicationEvent`、`FeaturedEvent` 或 `ExclusiveEvent`	強烈建議- `PublicationEvent` 用於指定發布者原始 (全球或本地) 發布內容，例如電影的原始戲院上映日期。此外，請使用 `FeaturedEvent` 表示您的服務將這項內容行銷為原創、精選、特輯等。 `ExclusiveEvent` 可指定您的服務擁有獨家發行權，並包含發行地點和時間。詳情和範例請參閱示例。
`releasedEvent.@type`	Text	必要：請務必將這個屬性設為下列其中一個值： `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	國家/地區	必填：與這項活動相關聯的區域。如果是 `PublicationEvent`，則是內容發布區域。如果是 `FeaturedEvent` 和 `ExclusiveEvent`，則是內容精選或獨家區域。請使用 ISO 3166 國家/地區代碼。如要表示全世界，請將其設為 `EARTH`。
`releasedEvent.startDate`	Date 或 DateTime	建議 - `ExclusiveEvent` 必填 - 實體的發布日期。對於 `PublicationEvent`，這表示實體的初始發布日期，例如電影首次在戲院上映的日期。對於 `ExclusiveEvent` 和 `FeaturedEvent`，這表示實體的獨家或精選內容開始日期。
`releasedEvent.endDate`	Date 或 DateTime	建議 - `ExclusiveEvent` 為必填屬性 - 僅適用於 `ExclusiveEvent` 和 `FeaturedEvent` 類型。對於 `ExclusiveEvent`，此屬性代表內容權利到期日。對於 `FeaturedEvent`，此屬性代表供應商最後一次刊登實體的日期。如果內容是永久專屬或精選，請將 `endDate` 設為自目前日期起算的 20 年。
`releasedEvent.publishedBy`	機構或個人	選填：發布這個實體的機構或人員。
`description`	Text	強烈建議劇集摘要。請提供情節摘要，而非事實摘要。長度上限為 300 個半形字元。使用陣列標記多種語言的說明。請參閱「多語言表示法」範例。
`genre`	Text	所有相關類型的排序清單。例如：`["Action", "Fashion", "Environment", "Football"]`
`keywords`	Text	用來描述這項內容的關鍵字或標記。也允許關鍵字陣列。舉例來說，["feature, biography"] 可以是描述內容的關鍵字陣列。
`actor`	Person 或 PerformingGroup 或 PerformanceRole	強烈建議劇集演員陣容陣列。請參閱這篇文章的建模指南。
`director`	Person	強烈建議劇集的導演。
`producer`	機構或個人	強烈建議本季的製作人。
`image`	ImageObject	強烈建議 (為 Google TV 提供) - 與 TVEpisode 相關的各種圖片。如要進一步瞭解 `image` 所需和選用的屬性，請參閱「圖片屬性」。
`trailer.description`	Text	預告片的說明。請參閱預告片示例。
`trailer.inLanguage`	Text	預告片的語言，格式為 BCP 47。
`trailer.url`	網址	預告片的網址，由相關製作公司或授權來源公開代管及上傳。
`trailer.regionsAllowed`	Place	允許觀看這部媒體的區域。如果未指定，系統會假設任何地方的使用者都可以瀏覽這部影片。請採用 ISO 3166 格式來指定國家/地區。
`review`	評論	查看電視節目的評分
`review.reviewRating`	評分	如果提供 `review`，則為必填屬性：用於指定評論中給予的評分。
`contentRating`	文字或評分	成人內容必填，其他內容則強烈建議填寫：整體內容分級。如果內容分級是以文字字串的形式提供，系統會接受兩種變化形式：評級機構會在評級前加上空格，舉例來說，美國「TVPG」評級的「TV-MA」評級應描述為「TVPG TV-MA」。請參閱代理商清單。值為「RATING NOT KNOWN」(大小寫皆可)，表示您不知道內容的評級。
`contentRating.author`	機構組織	如果 `contentRating` 使用 `Rating`，則為必要屬性：評等機構名稱。如要查看接受的內容分級機構清單，請參閱「內容分級機構」頁面
`contentRating.ratingValue`	Text	如果 `contentRating` 使用 `Rating`，則為必要屬性 - 評分值。
`contentRating.advisoryCode`	Text	內容的警示代碼。可接受的值包括 D、FV、L、S 和 V。D = 對話、FV = 奇幻暴力、L = 語言、S = 性內容、V = 暴力。
`identifier`	PropertyValue	強烈建議- 可明確識別此實體的外部 ID 或其他 ID。可使用多個 ID。詳情請參閱「ID 屬性」一節。
`popularityScore`	PopularityScoreSpecification	強烈建議Google 會使用這個分數和其他信號，判斷要為使用者播放哪些媒體。這個分數代表內容相對於目錄中其他內容的熱門程度，因此分數的評分標準必須在目錄中的所有實體和動態消息中保持一致。實體的熱門程度分數預設為 0。
`popularityScore.@type`	Text	一律設為 `PopularityScoreSpecification`。
`popularityScore.value`	Number	非負數值，表示實體的熱門程度；分數越高，代表熱門程度越高。
`popularityScore.eligibleRegion`	國家/地區	這個人氣分數適用的區域。如果人氣分數適用於全球，請將其設為 `EARTH`。根據預設，此屬性會設為 `EARTH`。 `Note:` 當地熱門程度優先於全球 (EARTH) 熱門程度

TVSeason

屬性	預期類型	說明
`@context`	Text	必要 - 一律設為 `["http://schema.org", {"@language": "xx"}]` 其中「xx」代表動態饋給中的字串語言。每個根實體內容都應將 @language 設為適當的語言代碼，格式為 BCP 47 格式。舉例來說，如果語言設為西班牙文，系統會假設名稱為西班牙文，即使字幕/配音語言為英文也一樣。
`@type`	Text	必要：一律設為 `TVSeason`。
`@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	必填：這個電視節目的名稱。使用陣列列出不同語言的名稱。請參閱「多語言表示法」範例。請注意，每個語言代碼 (語言-國家/地區組合) 只支援一個名稱。
`titleEIDR`	Text	強烈建議- EIDR (Entertainment Identifier Registry) 識別碼，用於表示最一般/抽象層級的電影或電視作品。舉例來說，如果電視影集的名稱為「Game of Thrones」，第 1 季的 titleEIDR 為「10.5240/FD91-C72C-4161-FCBA-058B-1」。
`seasonNumber`	整數	必填：這個數字代表該季在電視影集季別順序中的編號。
`partOfSeries`	TVSeries	必填：這個季別所屬的電視影集。
`partOfSeries.@type`	Text	必要：一律設為 `TVSeries`。
`partOfSeries.@id`	網址	必填：這個季別所屬的 `TVSeries` 的 `@id`。
`partOfSeries.name`	Text	必填：電視影集的名稱。
`partOfSeries.sameAs`	Text	可識別節目的參考網頁網址，例如節目的維基百科網頁。這必須與 `url` 屬性不同。
`potentialAction`	WatchAction	如適用則為必要屬性：提供動作詳細資料的動作標記物件。如果內容可在隨選影片 (VoD) 中觀看，就必須使用這個屬性；Action 標記物件需要提供內容的深層連結。如果內容可在 LiveTV 頻道上觀看，則可選擇使用這項屬性；相關聯的 `BroadcastService` 實體會提供頻道的深層連結。 `TVSeason` 可用於隨選影片和直播。使用陣列指定多個區域中的不同深層連結。請參閱「多個地區和語言」範例。
`sameAs`	網址	強烈建議可識別季度的參考網頁網址，例如季度的維基百科網頁。這必須與 `url` 屬性不同。
`releasedEvent`	`PublicationEvent`、`FeaturedEvent` 或 `ExclusiveEvent`	強烈建議- `PublicationEvent` 用於指定發布者原始 (全球或本地) 發布內容，例如電影的原始戲院上映日期。此外，請使用 `FeaturedEvent` 表示您的服務將這項內容行銷為原創、精選、特輯等。 `ExclusiveEvent` 可指定您的服務擁有獨家發行權，並包含發行地點和時間。詳情和範例請參閱示例。
`releasedEvent.@type`	Text	必要：請務必將這個屬性設為下列其中一個值： `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	國家/地區	必填：與這項活動相關聯的區域。如果是 `PublicationEvent`，則是內容發布區域。如果是 `FeaturedEvent` 和 `ExclusiveEvent`，則是內容精選或獨家區域。請使用 ISO 3166 國家/地區代碼。如要表示全世界，請將其設為 `EARTH`。
`releasedEvent.startDate`	Date 或 DateTime	建議 - `ExclusiveEvent` 必填 - 實體的發布日期。對於 `PublicationEvent`，這表示實體的初始發布日期，例如電影首次在戲院上映的日期。對於 `ExclusiveEvent` 和 `FeaturedEvent`，這表示實體的獨家或精選內容開始日期。
`releasedEvent.endDate`	Date 或 DateTime	建議 - `ExclusiveEvent` 為必填屬性 - 僅適用於 `ExclusiveEvent` 和 `FeaturedEvent` 類型。對於 `ExclusiveEvent`，此屬性代表內容權利到期日。對於 `FeaturedEvent`，此屬性代表供應商最後一次刊登實體的日期。如果內容是永久專屬或精選，請將 `endDate` 設為自目前日期起算的 20 年。
`releasedEvent.publishedBy`	機構或個人	選填：發布這個實體的機構或人員。
`description`	Text	強烈建議本季的簡介。請提供情節摘要，而非事實摘要。長度上限為 300 個半形字元。使用陣列標記多種語言的說明。請參閱「多語言表示法」範例。
`actor`	[Person 或 PerformingGroup 或 PerformanceRole]	強烈建議這個陣列包含該季的演員陣容。請參閱這篇文章的建模指南。
`director`	Person	強烈建議節目導演的陣列。
`producer`	機構或個人	強烈建議本季的製作人。
`image`	ImageObject	與 TVSeason 相關的圖片。如要進一步瞭解 `image` 所需和選用的屬性，請參閱「圖片屬性」。
`genre`	Text	所有相關類型的排序清單。例如：`["Action", "Fashion", "Environment", "Football"]`
`keywords`	Text	用來描述這項內容的關鍵字或標記。也允許關鍵字陣列。舉例來說，["feature, biography"] 可以是描述內容的關鍵字陣列。
`trailer.description`	Text	預告片的說明。請參閱預告片示例。
`trailer.inLanguage`	Text	預告片的語言，格式為 BCP 47。
`trailer.url`	網址	預告片的網址，由相關製作公司或授權來源公開代管及上傳。
`trailer.regionsAllowed`	Place	允許觀看這部媒體的區域。如果未指定，系統會假設任何地方的使用者都可以瀏覽這部影片。請採用 ISO 3166 格式來指定國家/地區。
`identifier`	PropertyValue	強烈建議- 可明確識別此實體的外部 ID 或其他 ID。可使用多個 ID。詳情請參閱「識別碼屬性」一節。
`popularityScore`	PopularityScoreSpecification	強烈建議Google 會使用這個分數，搭配其他信號，判斷要為使用者播放哪些媒體。這個分數代表內容相對於目錄中其他內容的熱門程度，因此分數的評分標準必須在目錄中的所有實體和動態消息中保持一致。實體的熱門程度分數預設為 0。
`popularityScore.@type`	Text	一律設為 `PopularityScoreSpecification`。
`popularityScore.value`	Number	非負數值，表示實體的熱門程度；分數越高，代表熱門程度越高。
`popularityScore.eligibleRegion`	國家/地區	這個熱門程度分數適用的區域。如果人氣分數適用於全球，請將其設為 `EARTH`。根據預設，此屬性會設為 `EARTH`。 `Note:` 當地熱門程度優先於全球 (EARTH) 熱門程度
`review`	評論	查看電視季的評分
`review.reviewRating`	評分	如果提供 `review`，則為必填屬性：用於指定評論中給予的評分。
`contentRating`	文字或評分	成人內容必填，其他內容則強烈建議填寫：整體內容分級。如果內容分級是以文字字串的形式提供，系統會接受兩種變化形式：評級機構會在評級前加上空格，舉例來說，美國「TVPG」評級的「TV-MA」評級應描述為「TVPG TV-MA」。請參閱代理商清單。值為「RATING NOT KNOWN」(大小寫皆可)，表示您不知道內容的評級。
`contentRating.author`	機構組織	如果 `contentRating` 使用 `Rating`，則為必要屬性：評等機構名稱。如要查看接受的內容分級機構清單，請參閱「內容分級機構」頁面
`contentRating.ratingValue`	Text	如果 `contentRating` 使用 `Rating`，則為必要屬性 - 評分值。
`contentRating.advisoryCode`	Text	內容的警示代碼。可接受的值包括 D、FV、L、S 和 V。D = 對話、FV = 奇幻暴力、L = 語言、S = 性內容、V = 暴力。

執行者規格

TVSeries、TVEpisode 和 TVSeason 實體類型的 actor 屬性可讓您指定演員的更多詳細資料，包括角色名稱和他們在電視節目中的角色。以下各節會說明相同的內容，並提供幾個示例說明用法。

屬性預期類型說明

屬性	預期類型	說明
`actor`	Person 或 PerformingGroup 或 PerformanceRole	強烈建議：演員陣容陣列。在已知演出角色和 (選用) 演員姓名時，請使用 PerformanceRole 類型。在這種情況下，演員 Person 或 PerformingGroup 會嵌入 PerformanceRole 物件中。當演員的角色不明時，請使用 Person 類型來表示個別演員，或使用 PerformingGroup 類型提供表演團體/樂團的詳細資料。使用陣列代表多個人物、表演團體或表演角色。

actor

Person 或 PerformingGroup 或 PerformanceRole

強烈建議：演員陣容陣列。

在已知演出角色和 (選用) 演員姓名時，請使用 PerformanceRole 類型。在這種情況下，演員 Person 或 PerformingGroup 會嵌入 PerformanceRole 物件中。
當演員的角色不明時，請使用 Person 類型來表示個別演員，或使用 PerformingGroup 類型提供表演團體/樂團的詳細資料。

使用陣列代表多個人物、表演團體或表演角色。

使用 `Person` 或 `PerformingGroup` 類型

使用 Person 或 PerformingGroup 類型時，請提供下列屬性

屬性	預期類型	說明
`@type`	Person 或 PerformingGroup	必要：一律設為 Person 或 PerformingGroup
`@id`	網址	強烈建議- 演員或表演團體 ID，以 URI 格式表示，例如 https://example.com/actor/abc。`@id` 必須符合下列規定：在目錄中每個演員/表演團體的全球專屬值這個 ID 應固定，不會隨著時間而改變。系統會將這個值視為不透明字串，且不一定要是有效連結。統一資源識別碼 (URI) 格式貴機構必須擁有用於 `@id` 值的網域。請注意，在 actor 屬性中使用的 `@id` 應在動態消息中一致使用。舉例來說，如果有兩部電影都出現同一位演員，那麼這兩個演員物件的 `@id` 值應保持一致。
`name`	Text	必填：演員/演員團體/表演團體的名稱。
`sameAs`	網址	強烈建議- 可識別演員或表演團體的參考網頁網址，例如演員的維基百科網頁。這必須與 `@id` 屬性不同。

使用 `PerformanceRole` 類型

使用 PerformanceRole 類型時，請提供下列屬性

屬性	預期類型	說明
`@type`	PerformanceRole	必要：一律設為 PerformanceRole
`roleName`	Text	強烈建議- 演員所飾演、扮演或擔任的角色。請參閱這裡的有效值清單。
`characterName`	Text	在某些表演或演出角色中扮演的角色名稱。如果行為者類型為 PerformingGroup，請勿設定這個欄位。
`actor`	Person 或 PerformingGroup	必填 - 使用資料類型 Person 時，內容的演員陣容。使用資料類型 PerformingGroup 時，內容的演出團體/樂團。
`actor.@type`	Person 或 PerformingGroup	必要：一律設為 Person 或 PerformingGroup
`actor.@id`	網址	強烈建議- 演員或表演團體 ID，以 URI 格式表示，例如 https://example.com/actor/abc。`@id` 必須符合下列規定：在目錄中每個演員/表演團體的全球專屬值這個 ID 應固定，不會隨著時間而改變。系統會將這個值視為不透明字串，且不一定要是有效連結。統一資源識別碼 (URI) 格式貴機構必須擁有用於 `@id` 值的網域。請注意，在 actor 屬性中使用的 `@id` 應在動態消息中一致使用。舉例來說，如果有兩部電影都出現同一位演員，那麼這兩個演員物件的 `@id` 值應保持一致。
`actor.name`	Text	必填：演員/演員團體/表演團體的名稱。
`actor.sameAs`	網址	強烈建議- 可識別演員或表演團體的參考網頁網址，例如演員的維基百科網頁。這必須與 actor.@id 屬性不同。

可接受的角色名稱

這些值需要 actor.@type 為 Person。

`roleName`值	說明
“Cameo”	客串角色，又稱為客串演出，是指知名人士在表演藝術作品中短暫出場。
「VoiceActor」	所謂的「配音」是指使用演員的聲音，但演員不會出現在畫面上。這類情況最常見於動畫，但如果某位演員的聲音被配音到另一位演員的對白，也會發生這種情況。
「Double」	替身是指代替其他演員演出，以免對方臉孔曝光。
「MotionCaptureActor」	MotionCaptureActor 是指記錄真人演員動作的人，並使用這些資訊在 2D 或 3D 電腦動畫中為數位角色模型製作動畫。

這些值通常適用於 Person 和 PerformingGroup 類型。

`roleName`值	說明
「Actor」	演員是指在傳統戲劇或現代媒體 (例如電影、廣播和電視) 中飾演角色的人。
「GuestStar」	「客串是指演員飾演虛構角色，並出現在一或幾集節目中。在某些情況下，客串明星可能會飾演重要角色，並在系列劇中多次亮相，但並非主要演員。如果演員是客串演出者或節目嘉賓，請將值設為「GuestStar」。客串演員應只在劇集層級提供，不應在電視劇層級新增。
「Guest」	「談話節目的嘉賓。請注意，「GuestStar」是虛構角色，而「Guest」則是真實人物。
「播報員」	廣播員負責為節目開場和結尾說話，介紹主持人、參賽者和/或嘉賓，說明可獲得的獎品，並在錄影前暖場，在廣告期間維持觀眾的興趣。
「Commentator」	評論員會即時提供遊戲或活動的評論，通常是在直播期間進行。
「Impressionist」	模仿家或模仿者是指模仿名人和卡通人物的聲音、聲調和舉止的藝人。
「Host」	介紹、主持或主持電視節目，通常是節目與觀眾之間的橋樑。「主持人」通常是指非虛構角色。
「CoHost」	與其他人共同主辦活動/節目的使用者。
「GuestHost」	客座主持人通常是談話節目的主持人，在常任主持人缺席時，由他們代為主持節目。
「Newscaster」	透過電視新聞節目，向大眾介紹/告知當地、全國和國際層級的新聞和事件。
「特約記者」	特派員或現場記者通常是雜誌的記者或評論員，或是從遠端 (通常是遠處) 為報紙、電台或電視新聞，或其他類型公司提供報導的代理人。
「ShowJudge」	評審通常是該節目領域的專家，並擔任「評審」一職，評論節目試鏡並進入比賽的參賽者。
「Panelist」	廣播或電視節目討論或諮詢小組的成員。
「Contestant」	比賽或遊戲節目的參賽者是指參與其中的人士。
「StoryNarrator」	敘述者是指敘述某件事的人，尤其是在小說或敘事詩中敘述事件的角色
「MusicalArtist」	「音樂藝人可以是個人、團體或虛構人物，通常會定期在觀眾面前表演，或錄製音樂曲目或音樂專輯。編曲者和作詞者只有在某些音樂作品的製作人員名單中，同時列出他們是主要表演者時，才應使用這類型別。這類型可用於將永久的音樂人或音樂人群組，以及嘉賓音樂人或音樂人群組，與節目建立關聯。

區分演員的主要角色和配角

如要區分電視節目中的主角/常駐演員和客串/配角，請只在 TVSeries 實體上新增主角，並只在 TVEpisode 實體上新增客串或配角。確認主演/常規演員未新增至 TVEpisode 實體。

範例

`TVSeries`、`TVEpisode` 和 `TVSeason` 範例

TVSeries

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeries",
  "@id": "http://www.example.com/my_favorite_tv_show/",
  "url": "http://www.example.com/my_favorite_tv_show/",
  "name": "My Favorite TV Show",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
       },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 4.1,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite TV show.",
  "contentRating": "RATING NOT KNOWN",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": [
     {
       "@type": "PropertyValue",
       "propertyID": "IMDB_ID",
       "value":  "tt0903747"
     }
   ]
}

TVEpisode

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVEpisode",
  "@id": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "url": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "name": "John Doe returns with a horse.",
  "episodeNumber": 14,
  "contentRating": "TVPG TV-MA",
  "partOfSeason": {
    "@type": "TVSeason",
    "@id": "http://www.example.com/my_favorite_tv_show/s7",
    "seasonNumber": 7
  },
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/e14?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/john_doe_returns_with_a_horse",
  "duration": "PT00H25M",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2014-01-09",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 3.9,
    "eligibleRegion": "EARTH"
  },
  "description": "John Doe returns to the village three years after his disappearance.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": {
     "@type": "PropertyValue",
     "propertyID": "IMDB_ID",
     "value":  "tt3453320"
   }
}

TVSeason

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeason",
  "@id": "http://www.example.com/my_favorite_tv_show/s7",
  "url": "http://www.example.com/my_favorite_tv_show/s7",
  "name": "Season 7",
  "seasonNumber": 7,
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
      "eligibleRegion": [
       {
          "@type": "Country",
          "name": "US"
       },
       {
          "@type": "Country",
          "name": "CA"
       }
      ]
     }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show_(season_7)",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2010-09-23",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "The seventh season of My Favorite TV Show.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ]
}

`Actor` 屬性範例

不明的演員角色

如果不知道演員的角色，建議你使用 Person 或 PerformingGroup 類型提供演員資訊。

"actor": [
    {
      "@type": "Person",
      "@id": "https://example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
    }
  ]

已知執行者的角色

如果已知演員的角色，建議您使用 PerformanceRole 類型提供演員資訊

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "GuestStar",
      "characterName": "Dr. Peter Venkman",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/jane_doe",
        "name": "Jane Doe",
        "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
      }
  }
]

部分演員的已知角色

如果不知道表演角色中繼資料，建議你使用 Person 或 PerformingGroup 類型提供演員資訊。在已知這項資訊的其他情況下，請使用 PerformanceRole 類型。這些類型可一起新增至同一個陣列。

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "Person",
      "@id": "https://example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
  },
  {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
  }
]

電視節目的內容標記屬性 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

規格表

TVSeries

TVEpisode

TVSeason

執行者規格

使用 Person 或 PerformingGroup 類型

使用 PerformanceRole 類型

可接受的角色名稱

區分演員的主要角色和配角

範例

TVSeries、TVEpisode 和 TVSeason 範例

TVSeries

TVEpisode

TVSeason

Actor 屬性範例

不明的演員角色

已知執行者的角色

部分演員的已知角色

相關網頁

電視節目的內容標記屬性

使用 `Person` 或 `PerformingGroup` 類型

使用 `PerformanceRole` 類型

`TVSeries`、`TVEpisode` 和 `TVSeason` 範例

`Actor` 屬性範例