電視節目的內容標記屬性

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

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

規格表

TVSeries TVEpisode TVSeason

屬性	預期類型	說明
@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 = 暴力。

屬性	預期類型	說明
@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) 熱門程度

屬性	預期類型	說明
@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 類型提供表演團體/樂團的詳細資料。 使用陣列代表多個人物、表演團體或表演角色。

使用 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 TVEpisode TVSeason

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

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

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

相關網頁

如要瞭解與這些屬性相關的主題，請參閱下列頁面：

• 找出內容的實體類型
• 收集內容的 ID、網址和名稱
• 找出電視影集、電視季和電視劇集之間的關係
• 收集內容的中繼資料