電視節目的內容標記屬性

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

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

規格表

電視影集

屬性	預期類型	說明
@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 符合所有需求條件，因此建議您使用實體的 url 做為 @id。詳情請參閱「ID」一節。
url	網址	必要 - 內容的標準網址，Google 會使用這項資料將動態饋給中的內容與 Google 資料庫中的內容進行比對。 url 必須符合下列規定： 「url」不得重複 url 必須包含有效的標準網址，以供 Google 檢索。 如需播放的深層連結，請改為參閱目標物件的 urlTemplate 屬性。
name	Text	必要 - 該節目的名稱。 請使用陣列列出不同語言的名稱。請參閱支援多種語言和語言的範例。 請注意，每個語言代碼 (語言-國家/地區組合) 僅支援一個名稱。
titleEIDR	Text	強烈建議為什麼？- EIDR (娛樂 ID 識別碼) 這個 ID，代表最一般/抽象層級的作品或電影。 舉例來說，名為「權力遊戲」的影視影集標題為「10.5240/C1B5-3BA1-8991-A571-8472-W」。
potentialAction	WatchAction	必要 (如果適用) - 動作標記物件，提供動作的詳細資料。 如果影片可透過隨選影片 (VoD) 提供，就必須提供這個屬性；動作標記物件必須提供內容的深層連結。 如果該內容可在 LiveTV 頻道上架，那麼這項屬性則為選填；相關 BroadcastService 實體會提供頻道的深層連結。 使用 VoD 和 LiveTV 皆可使用 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 的必要必要和選用屬性，請參閱 Image 屬性。
trailer.description	Text	預告片的說明。請參閱宣傳短片範例。
trailer.inLanguage	Text	預告片格式 (BCP 47 格式)。
trailer.url	網址	預告片是由相關的製片工作室或授權來源公開發布及上傳。
trailer.regionsAllowed	地點	允許媒體的區域。如未指定，系統會假設所有位置皆可使用。請使用 ISO 3166 格式指定國家/地區。
identifier	PropertyValue	強烈建議為什麼？- 可明確識別這個實體的外部 ID 或其他 ID。可使用多個 ID。詳情請參閱「ID 屬性」一節。
popularityScore	熱門分數規範	強烈建議為什麼？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 = Dialogue, FV = Fantasy Violence, L = Language, 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 符合所有需求條件，因此建議您使用實體的 url 做為 @id。詳情請參閱「ID」一節。
url	網址	必要 - 內容的標準網址，Google 會使用這項資料將動態饋給中的內容與 Google 資料庫中的內容進行比對。 url 必須符合下列規定： 「url」不得重複 url 必須包含有效的標準網址，以供 Google 檢索。 如需播放的深層連結，請改為參閱目標物件的 urlTemplate 屬性。
name	Text	必要 - 單集節目的名稱。 請使用陣列列出不同語言的名稱。請參閱多重語言表示法範例。 請注意，每個語言代碼 (語言-國家/地區組合) 僅支援一個名稱。
titleEIDR	Text	強烈建議為什麼？- EIDR (娛樂 ID 識別碼) 這個 ID，代表最一般/抽象層級的作品或電影。 舉例來說，名為《權力遊戲》第 1 季第一集的 TitleEIDR 為「10.5240/B6A6-1B32-B5E5-D5CB-6B84-X」。
editEIDR	Text	強烈建議為什麼？- EIDR (娛樂識別碼識別碼) ID，代表電影或電視的特定編輯 / 版本。 舉例來說，《TV of Thrones》第一集的第一集節目《Game of Thrones》，名稱為「10.5240/B6A6-1B32-B5E5-D5CB-6B84-X」，其中含有 1 個剪輯版本，例如「10.5240/FB97-C847-296.-DABEC-C9D-02C9--C99--296 titleEIDR提供 EditEIDR 時必填屬性。
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	電視影集	必要 - 這集節目所屬的電視影集。
partOfSeries.@type	Text	必要 - 一律設為 TVSeries。
partOfSeries.@id	網址	必要 - 本集所屬 TVSeries 的 @id。
partOfSeries.name	Text	必要 - 電視影集的名稱。
partOfSeries.sameAs	Text	可識別節目的參照網頁網址，例如節目的維基百科頁面。這必須與 url 屬性不同。
potentialAction	WatchAction	必要 (如果適用) - 動作標記物件，提供動作的詳細資料。 如果影片可透過隨選影片 (VoD) 提供，就必須提供這個屬性；動作標記物件必須提供內容的深層連結。 如果該內容可在 LiveTV 頻道上架，那麼這項屬性則為選填；相關 BroadcastService 實體會提供頻道的深層連結。 使用 VoD 和 LiveTV 皆可使用 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) - 與電視劇集相關的各種圖片。如要進一步瞭解 image 的必要必要和選用屬性，請參閱 Image 屬性。
trailer.description	Text	預告片的說明。請參閱宣傳短片範例。
trailer.inLanguage	Text	預告片格式 (BCP 47 格式)。
trailer.url	網址	預告片是由相關的製片工作室或授權來源公開發布及上傳。
trailer.regionsAllowed	地點	允許媒體的區域。如未指定，系統會假設所有位置皆可使用。請使用 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 = Dialogue, FV = Fantasy Violence, L = Language, S = 色情內容，V = 暴力。
identifier	PropertyValue	強烈建議為什麼？- 可明確識別這個實體的外部 ID 或其他 ID。可使用多個 ID。詳情請參閱「ID 屬性」一節。
popularityScore	熱門分數規範	強烈建議為什麼？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 符合所有需求條件，因此建議您使用實體的 url 做為 @id。詳情請參閱「ID」一節。
url	網址	必要 - 內容的標準網址，Google 會使用這項資料將動態饋給中的內容與 Google 資料庫中的內容進行比對。 url 必須符合下列規定： 「url」不得重複 url 必須包含有效的標準網址，以供 Google 檢索。 如需播放的深層連結，請改為參閱目標物件的 urlTemplate 屬性。
name	Text	必要 - 整季電視節目的名稱。 請使用陣列列出不同語言的名稱。請參閱多重語言表示法範例。 請注意，每個語言代碼 (語言-國家/地區組合) 僅支援一個名稱。
titleEIDR	Text	強烈建議為什麼？- EIDR (娛樂 ID 識別碼) 這個 ID，代表最一般/抽象層級的作品或電影。 舉例來說，名為《權力遊戲》(Game of Thrones) 第一季的 TitleEIDR 是「10.5240/FD91-C72C-4161-FCBA-058B-1」。
seasonNumber	整數	必要 - 以季別表示電視台中季別的順序。
partOfSeries	電視影集	必要 - 本季所屬的電視劇集。
partOfSeries.@type	Text	必要 - 一律設為 TVSeries。
partOfSeries.@id	網址	必要 - 本季所屬 TVSeries 的 @id。
partOfSeries.name	Text	必要 - 電視影集的名稱。
partOfSeries.sameAs	Text	可識別節目的參照網頁網址，例如節目的維基百科頁面。這必須與 url 屬性不同。
potentialAction	WatchAction	必要 (如果適用) - 動作標記物件，提供動作的詳細資料。 如果影片可透過隨選影片 (VoD) 提供，就必須提供這個屬性；動作標記物件必須提供內容的深層連結。 如果該內容可在 LiveTV 頻道上架，那麼這項屬性則為選填；相關 BroadcastService 實體會提供頻道的深層連結。 使用 VoD 和 LiveTV 皆可使用 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 的必要必要和選用屬性，請參閱 Image 屬性。
genre	Text	所有相關類型的已排序清單。例如：["Action", "Fashion", "Environment", "Football"]
keywords	Text	用來描述這項內容的關鍵字或標記。系統也允許使用關鍵字陣列。舉例來說，["feature, biography"] 可以是關鍵字陣列來說明內容。
trailer.description	Text	預告片的說明。請參閱宣傳短片範例。
trailer.inLanguage	Text	預告片格式 (BCP 47 格式)。
trailer.url	網址	預告片是由相關的製片工作室或授權來源公開發布及上傳。
trailer.regionsAllowed	地點	允許媒體的區域。如未指定，系統會假設所有位置皆可使用。請使用 ISO 3166 格式指定國家/地區。
identifier	PropertyValue	強烈建議為什麼？- 可明確識別這個實體的外部 ID 或其他 ID。可使用多個 ID。詳情請參閱「ID 屬性」一節。
popularityScore	熱門分數規範	強烈建議為什麼？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 = Dialogue, FV = Fantasy Violence, L = Language, S = 色情內容，V = 暴力。

執行者規格

TVSeries、TVEpisode 和 TVSeason 實體類型的 actor 屬性可讓您指定演員的詳細資料，包括角色名稱以及他們在電視節目中扮演的角色。以下各節內容相同，另外再列舉幾個使用範例。

屬性	預期類型	說明
actor	Person 或 PerformingGroup 或 PerformanceRole	強烈建議為什麼？：投放成員的陣列。 播放角色時，請使用 PerformanceRole 類型，並視需要指派演員成員的角色名稱。在本例中，執行者 Person 或 PerformingGroup 已嵌入 PerformanceRole 物件。 使用「Person」類型來指出個別演員或 PerformingGroup，說明在演出者的角色沒有身分時，請提供表現群組/樂團的詳細資料。 使用陣列來代表多個 Person、PerformingGroups 或 PerformanceRole。

使用 Person 或 PerformingGroup 類型

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

屬性	預期類型	說明
@type	Person 或 PerformingGroup	必要 - 一律設定為 Person 或 PerformingGroup
@id	網址	強烈建議為什麼？- URI 格式的執行者或執行群組 ID，例如 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 資料類型時，投放成員。 使用 PerformanceingGroup 資料類型時，內容執行的群組/樂團。
actor.@type	Person 或 PerformingGroup	必要 - 一律設定為 Person 或 PerformingGroup
actor.@id	網址	強烈建議為什麼？- URI 格式的執行者或執行群組 ID，例如 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」	使用聲音時，演員或聲音會直接出現在畫面中。這通常會發生在動畫中，但當演員的旁白為配音員的聲音而配音時，也會發生這種情形。
「雙精度浮點數」	雙人代表要取代其他演員的人，以免對方臉未顯示。
「MotionCaptureActor」	MotionCaptureActor 是指某人在人類演員身上採取的動作，並使用該資訊為 2D 或 3D 電腦動畫製作數位角色模型。

一般來說，Person 和 PerformingGroup 類型接受這些值。

roleName 值	說明
「執行者」	演員或演員是指在場景中描繪某個角色 (例如電影、電台與電視) 的傳統表演者。
「吉他」	「來賓是演員，並且扮演某個角色，並顯示在其中一集或幾集中。在某些情況下，來賓雖然可能會擔任重要週期性角色，但可能會多次出現在一系列的系列活動中，即使他們不是主要演員也一樣。如果投放節目為客座演出或來賓是來賓，請將值設為「GuestStar」。只能提供單集節目層級的單集節目，請勿加入 TVSeries 層級。
「邀請對象」	「一位脫口秀的來賓。請注意，「GuestStar」是虛構的角色，但「邀請對象」並非虛構的畫面。
「公告」	播報員是在現場表演開場、閉幕演出、導演主持人、參賽者和/或名人嘉賓、描述可以獲得的獎勵，並在觀眾輕觸前保持熱度。
「評論員」	留言者通常會在直播期間為遊戲或活動提供即時評論。
「曝光次數」	即刻演出或模擬技藝的演出者，模仿名人和卡通角色的音效、配音和技巧。
「主機」	介紹、介紹或主持電視節目的節目，通常做為節目的主持人及觀眾。「主持人」通常是非虛構的角色。
「共同主辦人」	主辦活動/節目與他人與他人共同主辦的活動。
「GuestHost」	客座主辦人 (通常是談話節目) 主持人在主持人無法使用時，會代替一般主持人代管節目。
「Newscaster」	透過電視新聞節目在當地、全國和國際的報導中，向大眾呈現/告知新聞與事件的資訊。
「Corresponseent」	通信人員或實習生通常是指雜誌的記者或評論者，或是報紙、廣播、電視新聞或其他類型的公司，以遠距方式提供地點資訊。
「ShowJudge」	評審團通常為現場工作領域中的專家，並且擔任「判斷標準」的評審團，由稽核員主持電視劇的競賽。
「參與者」	無線電或電視台成員討論或顧問的成員。
「參賽者」	競賽或遊戲節目中的參賽者都是參與比賽的人士。
「StoryNarrator」	旁白是旁白的人，特別是角色扮演小說或敘述詩詞的人物
「MusicalArtist」	「音樂藝人可能是人物、團體，或是虛構的人物，通常在觀眾面前演出，或是已錄製音樂曲目或音樂專輯。只有在某些音樂作品的出處暗示觀眾也成為主要表演者時，否則詞曲和作曲者才需要使用這種類型。這個類型可用於與音樂人或音樂人團體建立關聯，以及為音樂人或音樂人團體表演。

分辨執行者的主要職責與演員角色

如要區分電視節目中的主要/一般/客座/來賓/演員，請在 TVSeries 實體上新增主要演員，然後在 TVEpisode 實體中加入支援演員的投放或投放畫面。確認主要/一般投放內容未新增至 TVEpisode 實體。

範例

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、網址和名稱
• 瞭解電視影集、電視節目季別和電視劇集之間的關係
• 收集內容的中繼資料