電視節目的內容標記屬性

本節提供 TVSeries、TVEpisode 和 TVSeason 實體類型的內容標記屬性詳細資料。

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

規格表

TVSeries

屬性	預期類型	說明
@context	文字	必要 - 一律設為 ["http://schema.org", {"@language": "xx"}] 其中「xx」代表動態饋給中字串的語言。每個根實體內容的 @language 都應設為適當的語言代碼，並採用 BCP 47 格式。舉例來說，如果語言設為西班牙文，即使字幕/配音語言為英文，系統也會假設名稱為西班牙文。
@type	文字	必要 - 一律設為 TVSeries。
@id	網址	必要 - 內容的 URI 格式 ID，例如 https://example.com/1234abc。 @id 必須符合下列規定： 目錄中全域專屬 這個 ID 應固定，不會隨著時間而改變 (即使節目的網址屬性有所變更)。系統會將這個值視為不透明字串，且不一定要是有效連結。 格式為統一資源識別碼 (URI) 用於 @id 值的網域必須由貴機構所擁有。 由於實體的 url 符合所有 ID 規定，因此建議您使用實體的 url 做為 @id。詳情請參閱「ID」一節。
url	網址	必要 - 內容的標準網址。Google 會使用這個網址，將動態饋給中的內容與 Google 資料庫中的內容進行比對。 url必須符合下列規定： url 須為全域唯一值 url 必須包含 Google 可檢索的有效標準網址。 如要取得播放的深層連結，請改為查看 target 物件的 urlTemplate 屬性。
name	文字	必填 - 節目名稱。 使用陣列列出不同語言的名稱。請參閱多個地區和語言範例。 請注意，每個語言代碼 (語言和國家/地區的配對) 只能有一個名稱。
titleEIDR	文字	強烈建議 為什麼？ - EIDR (國際影視產業識別碼機構) 識別碼，代表電影或電視作品最一般/抽象的層級。 舉例來說，電視影集《權力遊戲》的 titleEIDR 為「10.5240/C1B5-3BA1-8991-A571-8472-W」。
potentialAction	WatchAction	視情況而定 - 提供動作詳細資料的動作標記物件。 如果內容可透過隨選影片 (VoD) 觀看，則必須提供這項屬性；動作標記物件必須提供內容的深層連結。 如果內容可透過 LiveTV 頻道觀看，這項屬性為選填，因為相關聯的 BroadcastService 實體會提供頻道的深層連結。 TVSeries 可在隨選影片和 LiveTV 上使用。 使用陣列在多個區域中指定不同的深層連結。請參閱多個地區和語言範例。
sameAs	網址	強烈建議 為什麼？ 可識別節目的參考網頁網址，例如節目的維基百科頁面。這必須與 url 屬性不同。
inLanguage	文字	強烈建議：以 BCP 47 格式提供影集原始語言。
genre	文字	所有相關類型的排序清單。例如：["Action", "Fashion", "Environment", "Football"]
keywords	文字	用來描述這項內容的關鍵字或標記。您也可以使用關鍵字陣列。舉例來說，["feature, biography"] 可以是描述內容的關鍵字陣列。
releasedEvent	PublicationEvent、FeaturedEvent 或 ExclusiveEvent	強烈建議 為什麼？ - PublicationEvent 用於指定發布者發布的原始內容 (全球或當地)，例如電影的原始上映日期。 此外，使用 FeaturedEvent 指出服務將此內容行銷為原創、精選、特別等。 ExclusiveEvent 則用於指定服務擁有獨家發行權，並包含地點和時間。 詳情和範例請參閱範例部分。
releasedEvent.@type	文字	必要 - 請務必將這個屬性設為下列其中一項： 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	Organization 或 Person	選用 - 發布這個實體的機構或個人。
description	文字	強烈建議 為什麼？ 節目簡介。請提供劇情簡介，而非事實摘要。長度上限為 300 個半形字元。 使用陣列標記多種語言的說明。請參閱多個地區和語言範例。
actor	Person 或 PerformingGroup 或 PerformanceRole	強烈建議 為什麼？ 影集演員陣容的陣列。如需模型建立指南，請參閱這篇文章。
director	Person	強烈建議 為什麼？ 節目導演。
producer	Organization 或 Person	強烈建議 為什麼？ 節目的製作人。
image	ImageObject	Google TV 必填 - 與電視連續劇相關的圖片。如要進一步瞭解 image 必須加入的屬性，以及選用屬性，請參閱「圖片屬性」。
trailer.description	文字	預告片的說明。請參閱預告片範例。
trailer.inLanguage	文字	強烈建議：預告片的語言，格式為 BCP 47。
trailer.url	網址	由各製作公司或授權來源上傳並公開代管的預告片網址。
trailer.regionsAllowed	地點	允許瀏覽這部媒體的地區。如果未指定，系統會假設任何地方的使用者都可以瀏覽這部影片。請採用 ISO 3166 格式來指定國家/地區。
identifier	PropertyValue	強烈建議 為什麼？ - 可明確識別這個實體的外部 ID 或其他 ID。可使用多個 ID。詳情請參閱「ID 屬性」一節。
popularityScore	PopularityScoreSpecification	強烈建議 為什麼？ Google 會使用這項分數和其他信號，判斷要為使用者播放哪種媒體。這個分數代表內容相對於目錄中其他內容的熱門程度，因此，目錄中所有實體的動態消息都必須採用一致的分數範圍。實體的熱門程度分數預設為 0。
popularityScore.@type	文字	一律設為 PopularityScoreSpecification。
popularityScore.value	Number	非負數值，表示實體的熱門程度；分數越高，表示熱門程度越高。
popularityScore.eligibleRegion	國家/地區	適用這項熱門度分數的區域。如果熱門度分數適用於全球，請設為 EARTH。這項屬性預設為 EARTH。 Note: 地區專屬熱門度會優先於全球 (EARTH) 熱門度
review	評論	查看電視影集的評分
review.reviewRating	評分	如果提供 review，則為必填：用於指定評論給出的評分。
contentRating	Text 或 Rating	成人內容為必填，其他內容則強烈建議填寫 - 內容整體分級。如果內容分級是以文字字串的形式提供，系統接受兩種變體： 評等機構名稱會加在評等前面，並以半形空格分隔。舉例來說，美國「TVPG」機構的「TV-MA」分級應描述為「TVPG TV-MA」。請參閱機構清單。 如果不知道內容的評等，請輸入「RATING NOT KNOWN」(不區分大小寫)。
contentRating.author	機構組織	如果 contentRating 使用 Rating，則為必要屬性 - 評等機構的名稱。如要查看可接受的分級機構清單，請參閱「內容分級機構」頁面
contentRating.ratingValue	文字	如果 contentRating 使用 Rating，則為必要項目 - 評分值。
contentRating.advisoryCode	文字	內容的警示代碼。可接受的值包括 D、FV、L、S 和 V。D = 對話、FV = 奇幻暴力、L = 語言、S = 性內容、V = 暴力。

TVEpisode

屬性	預期類型	說明
@context	文字	必要 - 一律設為 ["http://schema.org", {"@language": "xx"}] 其中「xx」代表動態饋給中字串的語言。每個根實體內容的 @language 都應設為適當的語言代碼，並採用 BCP 47 格式。舉例來說，如果語言設為西班牙文，即使字幕/配音語言為英文，系統也會假設名稱為西班牙文。
@type	文字	必要 - 一律設為 TVEpisode。
@id	網址	必要 - 內容的 URI 格式 ID，例如 https://example.com/1234abc。 @id 必須符合下列規定： 目錄中全域專屬 這個 ID 應固定，不會隨著時間而改變 (即使節目的網址屬性有所變更)。系統會將這個值視為不透明字串，且不一定要是有效連結。 格式為統一資源識別碼 (URI) 用於 @id 值的網域必須由貴機構所擁有。 由於實體的 url 符合所有 ID 規定，因此建議您使用實體的 url 做為 @id。詳情請參閱「ID」一節。
url	網址	必要 - 內容的標準網址。Google 會使用這個網址，將動態饋給中的內容與 Google 資料庫中的內容進行比對。 url必須符合下列規定： url 須為全域唯一值 url 必須包含 Google 可檢索的有效標準網址。 如要取得播放的深層連結，請改為查看 target 物件的 urlTemplate 屬性。
name	文字	必要 - 集數名稱。 使用陣列列出不同語言的名稱。請參閱「多種語言的表示方式」範例。 請注意，每個語言代碼 (語言和國家/地區的配對) 只能有一個名稱。
titleEIDR	文字	強烈建議 為什麼？ - EIDR (國際影視產業識別碼機構) 識別碼，代表電影或電視作品最一般/抽象的層級。 舉例來說，電視影集「冰與火之歌」第一季第一集的 titleEIDR 為「10.5240/B6A6-1B32-B5E5-D5CB-6B84-X」。
editEIDR	文字	強烈建議 為什麼？ - 代表電影或電視作品特定編輯 / 版本的 EIDR (國際影視產業識別碼機構) 識別碼。 舉例來說，電視節目「冰與火之歌」第一季第一集 (EIDR 標題為「10.5240/B6A6-1B32-B5E5-D5CB-6B84-X」) 有一個編輯版本，例如「10.5240/FB97-C847-2969-D0AB-ECD1-C」。提供 editEIDR 時， titleEIDR 屬性為必要屬性。
inLanguage	文字	強烈建議：集數的原始語言，格式為 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	文字	必要 - 一律設為 TVSeason。
partOfSeason.@id	網址	必要 - 此集所屬的 @idTVSeason。
partOfSeason.seasonNumber	整數	必填 - 這個數字表示本季在電視影集季別順序中的位置。
partOfSeries	TVSeries	必填 - 該集所屬的電視影集。
partOfSeries.@type	文字	必要 - 一律設為 TVSeries。
partOfSeries.@id	網址	必要 - 此集所屬的 @idTVSeries。
partOfSeries.name	文字	必要 - 電視影集的名稱。
partOfSeries.sameAs	文字	可識別節目的參考網頁網址，例如節目的維基百科頁面。這必須與 url 屬性不同。
potentialAction	WatchAction	視情況而定 - 提供動作詳細資料的動作標記物件。 如果內容可透過隨選影片 (VoD) 觀看，則必須提供這項屬性；動作標記物件必須提供內容的深層連結。 如果內容可透過 LiveTV 頻道觀看，這項屬性為選填，因為相關聯的 BroadcastService 實體會提供頻道的深層連結。 TVEpisode 可在隨選影片和 LiveTV 上使用。 使用陣列在多個區域中指定不同的深層連結。請參閱多個地區和語言範例。
sameAs	強烈建議 為什麼？ 網址	可識別集數的參照網頁網址，例如集數的維基百科頁面。這必須與 url 屬性不同。
duration	時間長度	集數的執行時間，採 ISO 8601 格式。請使用「PT00H00M」格式。
releasedEvent	PublicationEvent、FeaturedEvent 或 ExclusiveEvent	強烈建議 為什麼？ - PublicationEvent 用於指定發布者發布的原始內容 (全球或當地)，例如電影的原始院線上映日期。 此外，使用 FeaturedEvent 指出你的服務將此內容行銷為原創、精選、特別等。 ExclusiveEvent 則指定你的服務擁有獨家發行權，並包含地點和時間。 詳情和範例請參閱範例部分。
releasedEvent.@type	文字	必要 - 請務必將這個屬性設為下列其中一項： 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	Organization 或 Person	選用 - 發布這個實體的機構或個人。
description	文字	強烈建議 為什麼？ 劇集簡介。請提供劇情簡介，而非事實摘要。長度上限為 300 個半形字元。 使用陣列標記多種語言的說明。請參閱「多種語言的表示方式」範例。
genre	文字	所有相關類型的排序清單。例如：["Action", "Fashion", "Environment", "Football"]
keywords	文字	用來描述這項內容的關鍵字或標記。您也可以使用關鍵字陣列。舉例來說，["feature, biography"] 可以是描述內容的關鍵字陣列。
actor	Person 或 PerformingGroup 或 PerformanceRole	強烈建議 為什麼？ 劇集演員陣容的陣列。如需模型建立指南，請參閱這篇文章。
director	Person	強烈建議 為什麼？ 劇集導演。
producer	Organization 或 Person	強烈建議 為什麼？ 本季的製作人。
image	ImageObject	Google TV Why? 推薦 - 與 TVEpisode 相關的各種圖片。如要進一步瞭解 image 必須加入的屬性，以及選用屬性，請參閱「圖片屬性」。
trailer.description	文字	預告片的說明。請參閱預告片範例。
trailer.inLanguage	文字	強烈建議：預告片的語言，格式為 BCP 47。
trailer.url	網址	由各製作公司或授權來源上傳並公開代管的預告片網址。
trailer.regionsAllowed	地點	允許瀏覽這部媒體的地區。如果未指定，系統會假設任何地方的使用者都可以瀏覽這部影片。請採用 ISO 3166 格式來指定國家/地區。
review	評論	查看電視節目集數的評分
review.reviewRating	評分	如果提供 review，則為必填：用於指定評論給出的評分。
contentRating	Text 或 Rating	成人內容為必填，其他內容則強烈建議填寫 - 內容整體分級。如果內容分級是以文字字串的形式提供，系統接受兩種變體： 評等機構名稱會加在評等前面，並以半形空格分隔。舉例來說，美國「TVPG」機構的「TV-MA」分級應描述為「TVPG TV-MA」。請參閱機構清單。 如果不知道內容的評等，請輸入「RATING NOT KNOWN」(不區分大小寫)。
contentRating.author	機構組織	如果 contentRating 使用 Rating，則為必要屬性 - 評等機構的名稱。如要查看可接受的分級機構清單，請參閱「內容分級機構」頁面
contentRating.ratingValue	文字	如果 contentRating 使用 Rating，則為必要項目 - 評分值。
contentRating.advisoryCode	文字	內容的警示代碼。可接受的值包括 D、FV、L、S 和 V。D = 對話、FV = 奇幻暴力、L = 語言、S = 性內容、V = 暴力。
identifier	PropertyValue	強烈建議 為什麼？ - 可明確識別這個實體的外部 ID 或其他 ID。可使用多個 ID。詳情請參閱「ID 屬性」一節。
popularityScore	PopularityScoreSpecification	強烈建議 為什麼？ Google 會使用這項分數和其他信號，判斷要為使用者播放哪種媒體。這個分數代表內容相對於目錄中其他內容的熱門程度，因此，目錄中所有實體的動態消息都必須採用一致的分數範圍。實體的熱門程度分數預設為 0。
popularityScore.@type	文字	一律設為 PopularityScoreSpecification。
popularityScore.value	Number	非負數值，表示實體的熱門程度；分數越高，表示熱門程度越高。
popularityScore.eligibleRegion	國家/地區	適用這項熱門度分數的區域。如果熱門度分數適用於全球，請設為 EARTH。這項屬性預設為 EARTH。 Note: 地區專屬熱門度會優先於全球 (EARTH) 熱門度

TVSeason

屬性	預期類型	說明
@context	文字	必要 - 一律設為 ["http://schema.org", {"@language": "xx"}] 其中「xx」代表動態饋給中字串的語言。每個根實體內容的 @language 都應設為適當的語言代碼，並採用 BCP 47 格式。舉例來說，如果語言設為西班牙文，即使字幕/配音語言為英文，系統也會假設名稱為西班牙文。
@type	文字	必要 - 一律設為 TVSeason。
@id	網址	必要 - 內容的 URI 格式 ID，例如 https://example.com/1234abc。 @id 必須符合下列規定： 目錄中全域專屬 這個 ID 應固定，不會隨著時間而改變 (即使節目的網址屬性有所變更)。系統會將這個值視為不透明字串，且不一定要是有效連結。 格式為統一資源識別碼 (URI) 用於 @id 值的網域必須由貴機構所擁有。 由於實體的 url 符合所有 ID 規定，因此建議您使用實體的 url 做為 @id。詳情請參閱「ID」一節。
url	網址	必要 - 內容的標準網址。Google 會使用這個網址，將動態饋給中的內容與 Google 資料庫中的內容進行比對。 url必須符合下列規定： url 須為全域唯一值 url 必須包含 Google 可檢索的有效標準網址。 如要取得播放的深層連結，請改為查看 target 物件的 urlTemplate 屬性。
name	文字	必填 - 電視節目季的名稱。 使用陣列列出不同語言的名稱。請參閱「多種語言的表示方式」範例。 請注意，每個語言代碼 (語言和國家/地區的配對) 只能有一個名稱。
titleEIDR	文字	強烈建議 為什麼？ - EIDR (國際影視產業識別碼機構) 識別碼，代表電影或電視作品最一般/抽象的層級。 舉例來說，電視影集「冰與火之歌」第一季的影集 EIDR 為「10.5240/FD91-C72C-4161-FCBA-058B-1」。
seasonNumber	整數	必填 - 這個數字表示本季在電視影集季別順序中的位置。
partOfSeries	TVSeries	必要 - 這個季別所屬的電視影集。
partOfSeries.@type	文字	必要 - 一律設為 TVSeries。
partOfSeries.@id	網址	必填 - 這個季別所屬 TVSeries 的 @id。
partOfSeries.name	文字	必要 - 電視影集的名稱。
partOfSeries.sameAs	文字	可識別節目的參考網頁網址，例如節目的維基百科頁面。這必須與 url 屬性不同。
potentialAction	WatchAction	視情況而定 - 提供動作詳細資料的動作標記物件。 如果內容可透過隨選影片 (VoD) 觀看，則必須提供這項屬性；動作標記物件必須提供內容的深層連結。 如果內容可透過 LiveTV 頻道觀看，這項屬性為選填，因為相關聯的 BroadcastService 實體會提供頻道的深層連結。 TVSeason 可在隨選影片和 LiveTV 上使用。 使用陣列在多個區域中指定不同的深層連結。請參閱多個地區和語言範例。
sameAs	網址	強烈建議 為什麼？ 可識別賽季的參考網頁網址，例如賽季的維基百科頁面。這必須與 url 屬性不同。
releasedEvent	PublicationEvent、FeaturedEvent 或 ExclusiveEvent	強烈建議 原因 - PublicationEvent 用於指定發布者發行的原始內容 (全球或當地)，例如電影的原始戲院上映日期。 此外，使用 FeaturedEvent 指出你的服務將此內容宣傳為原創、精選、特別等。 ExclusiveEvent 則指定你的服務擁有獨家發行權，並包含發行地點和時間。 詳情和範例請參閱範例部分。
releasedEvent.@type	文字	必要 - 請務必將這個屬性設為下列其中一項： 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	Organization 或 Person	選用 - 發布這個實體的機構或個人。
description	文字	強烈建議 為什麼？ 本季的劇情簡介。請提供劇情簡介，而非事實摘要。長度上限為 300 個半形字元。 使用陣列標記多種語言的說明。請參閱「多種語言的表示方式」範例。
actor	[Person 或 PerformingGroup 或 PerformanceRole	強烈建議 為什麼？ 該季的演員陣容陣列。如需模型建立指南，請參閱這篇文章。
director	Person	強烈建議 為什麼？ 節目導演陣列。
producer	Organization 或 Person	強烈建議 為什麼？ 本季的製作人。
image	ImageObject	與 TVSeason 相關的圖片。如要進一步瞭解 image 必須加入的屬性，以及選用屬性，請參閱「圖片屬性」。
genre	文字	所有相關類型的排序清單。例如：["Action", "Fashion", "Environment", "Football"]
keywords	文字	用來描述這項內容的關鍵字或標記。您也可以使用關鍵字陣列。舉例來說，["feature, biography"] 可以是描述內容的關鍵字陣列。
trailer.description	文字	預告片的說明。請參閱預告片範例。
trailer.inLanguage	文字	強烈建議：預告片的語言，格式為 BCP 47。
trailer.url	網址	由各製作公司或授權來源上傳並公開代管的預告片網址。
trailer.regionsAllowed	地點	允許瀏覽這部媒體的地區。如果未指定，系統會假設任何地方的使用者都可以瀏覽這部影片。請採用 ISO 3166 格式來指定國家/地區。
identifier	PropertyValue	強烈建議 為什麼？ - 可明確識別這個實體的外部 ID 或其他 ID。可使用多個 ID。詳情請參閱「ID 屬性」一節。
popularityScore	PopularityScoreSpecification	強烈建議 為什麼？ Google 會使用這項分數和其他信號，判斷要為使用者播放哪種媒體。這個分數代表內容相對於目錄中其他內容的熱門程度，因此，目錄中所有實體的動態消息都必須採用一致的分數範圍。實體的熱門程度分數預設為 0。
popularityScore.@type	文字	一律設為 PopularityScoreSpecification。
popularityScore.value	Number	非負數值，表示實體的熱門程度；分數越高，表示熱門程度越高。
popularityScore.eligibleRegion	國家/地區	適用這項熱門度分數的區域。如果熱門度分數適用於全球，請設為 EARTH。這項屬性預設為 EARTH。 Note: 地區專屬熱門度會優先於全球 (EARTH) 熱門度
review	評論	查看電視節目季的評分
review.reviewRating	評分	如果提供 review，則為必填：用於指定評論給出的評分。
contentRating	Text 或 Rating	成人內容為必填，其他內容則強烈建議填寫 - 內容整體分級。如果內容分級是以文字字串的形式提供，系統接受兩種變體： 評等機構名稱會加在評等前面，並以半形空格分隔。舉例來說，美國「TVPG」機構的「TV-MA」分級應描述為「TVPG TV-MA」。請參閱機構清單。 如果不知道內容的評等，請輸入「RATING NOT KNOWN」(不區分大小寫)。
contentRating.author	機構組織	如果 contentRating 使用 Rating，則為必要屬性 - 評等機構的名稱。如要查看可接受的分級機構清單，請參閱「內容分級機構」頁面
contentRating.ratingValue	文字	如果 contentRating 使用 Rating，則為必要項目 - 評分值。
contentRating.advisoryCode	文字	內容的警示代碼。可接受的值包括 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 或 PerformanceRole。

使用 Person 或 PerformingGroup 類型

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

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

使用 PerformanceRole 類型

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

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

可接受的角色名稱

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

roleName值	說明
「Cameo」	客串角色又稱客串演出，是指知名人士在表演藝術作品中短暫現身。
「VoiceActor」	配音表演是指使用演員的聲音，但演員不會出現在螢幕上。這類情況最常出現在動畫中，但如果演員的聲音是配音，也會發生這種情況。
「Double」	替身是指代替其他演員演出，且不會露出臉部的人。
「MotionCaptureActor」	MotionCaptureActor 是指記錄真人演員動作的人，並使用該資訊在 2D 或 3D 電腦動畫中製作數位角色模型動畫。

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

roleName值	說明
「Actor」	演員是指在傳統的劇場表演中，或在電影、廣播和電視等現代媒體中扮演角色的表演者。
「GuestStar」	「客串明星是指飾演虛構角色，並在一或多集節目中演出的演員。在某些情況下，客串明星可能會飾演重要的常駐角色，並在劇中多次出現，但並非主要演員。如果演員客串演出或擔任節目嘉賓，請將值設為「GuestStar」。客串明星只能在劇集層級提供，不得在電視連續劇層級新增。
「訪客」	「A guest on a talk show. 請注意，「GuestStar」是虛構角色，但「Guest」是真實人物。
「播報員」	播報員負責開場和結尾的串場詞，介紹主持人、參賽者和/或名人來賓，說明獎項，並在錄影前暖場，以及在休息期間娛樂觀眾。
「Commentator」	賽評通常會在賽事或活動的直播期間，即時提供解說。
「印象派」	模仿藝人或口技表演者會模仿名人和卡通人物的聲音、語調和舉止。
「主機」	負責介紹、主持電視節目，通常會擔任節目與觀眾之間的橋樑。「主持人」通常是實況主。
「CoHost」	與他人共同主辦活動/計畫的人。
「GuestHost」	代班主持人通常是脫口秀主持人，在原主持人無法主持節目時代班。
「Newscaster」	透過電視新聞節目向大眾報導地方、全國和國際新聞與事件的人員。
「Correspondent」	特派員或現場記者通常是雜誌的記者或評論員，或是為報紙、電台或電視新聞或其他類型公司提供報導的代理人，他們通常位於遠端，甚至是遠方。
「ShowJudge」	評審通常是節目領域的專家，負責評斷參加電視節目海選和比賽的參賽者。
「Panelist」	廣播或電視節目討論或顧問小組成員。
「參賽者」	競賽或遊戲節目中的參賽者是指參與者。
「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"
  }
]

相關網頁

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

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