電視節目的內容標記屬性

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

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

規格表

TVSeries

屬性 預期類型 說明
@context 文字 必要 - 一律設為 ["http://schema.org", {"@language": "xx"}]
  • 地點」xx 英寸會呈現動態饋給中字串的語言。每個根實體內容都應將 @language 設為適當的語言代碼，並採用 BCP 47 格式。舉例來說，如果將語言設為西班牙文，即使字幕/配音語言是英文，系統也會假設名稱是以西班牙文顯示。
@type 文字 必要 - 一律設為 TVSeries。
@id 網址 必要 - 內容 ID，以 URI 格式表示；例如 https://example.com/1234abc。
@id 必須符合下列規定：
  • 產品目錄全球不重複
  • 這個 ID 應固定，不會隨時間而改變 (即使節目的網址資源有所變更)，系統會視為不透明字串，且不一定要是有效連結。
  • 採用統一資源識別碼 (URI) 格式
  • 用於 @id 值的網域必須由貴機構所擁有。
由於實體的 url 符合 ID 的所有規定，因此我們建議您使用實體的 url 做為 @id。詳情請參閱「ID」一節。
url 網址 必要 - Google 會使用內容的標準網址，將動態消息內容與 Google 資料庫中的內容進行比對。
url必須符合下列規定：
  • url 須為全域唯一值
  • url 必須包含可供 Google 檢索的有效標準網址。
如需播放的深層連結，請改為參閱目標物件的 urlTemplate 屬性。
name 文字 必填 - 節目名稱。
  • 使用陣列列出不同語言的名稱。請參閱「多個區域和語言」範例。
  • 請注意，每個語言代碼 (語言/國家/地區組合) 僅支援一個名稱。
titleEIDR 文字 強烈建議原因- EIDR (國際影視產業識別碼機構) 識別碼，以最高層級/抽象層級表示電影或電視作品。

例如，名為「權力遊戲」的電視影集名稱 EIDR「10.5240/C1B5-3BA1-8991-A571-8472-W」。
potentialAction WatchAction 如適用：提供動作詳細資料的動作標記物件。
  • 如果內容提供隨選即播影片 (VoD)，就必須使用這項屬性；動作標記物件必須提供內容的深層連結。
  • 如果影片可在 LiveTV 頻道上播放，這個屬性為選用項目；相關聯的 BroadcastService 實體會改為提供頻道的深層連結。
  • TVSeries 可以同時在 VoD 和 LiveTV 上使用。
使用陣列指定多個區域的不同深層連結。請參閱「多個區域和語言」範例。
sameAs 網址 強烈建議原因可識別節目的參考網頁網址例如節目的 Wikipedia 頁面。這必須與 url 屬性不同。
inLanguage 文字 系列叢書的原始語言，採用 BCP 47 格式。
genre 文字 所有相關類型的排序清單。例如：["Action", "Fashion", "Environment", "Football"]
keywords 文字 用來描述此內容的關鍵字或標記。也可以使用陣列。舉例來說，["feature, Bigraphy"] 可以是描述內容的關鍵字陣列。
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 機構或 Person 選用 - 發布這個實體的機構或人員。
description 文字 強烈建議原因節目概要。繪製摘要時，建議採用事實摘要。長度上限為 300 個半形字元。
actor Person 或 PerformingGroup 或 PerformanceRole 強烈建議原因系列演員陣容的陣列。請參閱這裡的模型指南。
director Person 強烈建議原因節目的導演。
producer 機構或 Person 強烈建議原因節目的製作人。
image ImageObject Google TV 必填 - 與 TVSeries 相關的圖片。如要進一步瞭解要與 image 加入的必要和選用屬性，請參閱「圖片屬性」一節。
trailer.description 文字 預告片的說明。請參閱預告片範例。
trailer.inLanguage 文字 預告片的語言，採用 BCP 47 格式。
trailer.url 網址 由各製片公司或授權來源公開代管及上傳的預告片網址。
trailer.regionsAllowed 地點 允許播放媒體內容的區域。如果未指定，則系統會假設可以在任何國家/地區播放。請採用 ISO 3166 格式來指定國家/地區。
identifier PropertyValue 強烈建議原因- 可明確識別這個實體的外部 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 如果是成人內容，此為必填屬性，否則強烈建議使用 - 整體內容分級。如果內容分級以文字字串的形式表示，可接受兩種變化版本：
  • 評分機構在評分前面加上空格，例如「TV-MA」來自代理商「TVPG」的分級應稱之為「TVPG TV-MA」。詳情請參閱代理商名單。
  • 「評分不認識」的值(不區分大小寫)，表示您不知道該內容的分級。
contentRating.author Text 或 Organization 如果 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 網址 必要 - 內容 ID，以 URI 格式表示；例如 https://example.com/1234abc。
@id 必須符合下列規定：
  • 產品目錄全球不重複
  • 這個 ID 應固定，不會隨時間而改變 (即使節目的網址資源有所變更)，系統會視為不透明字串，且不一定要是有效連結。
  • 採用統一資源識別碼 (URI) 格式
  • 用於 @id 值的網域必須由貴機構所擁有。
由於實體的 url 符合 ID 的所有規定，因此我們建議您使用實體的 url 做為 @id。詳情請參閱「ID」一節。
url 網址 必要 - Google 會使用內容的標準網址，將動態消息內容與 Google 資料庫中的內容進行比對。
url必須符合下列規定：
  • url 須為全域唯一值
  • url 必須包含可供 Google 檢索的有效標準網址。
如需播放的深層連結，請改為參閱目標物件的 urlTemplate 屬性。
name 文字 必要 - 劇集的名稱。
  • 使用陣列列出不同語言的名稱。請參閱多語言表示法範例。
  • 請注意，每個語言代碼 (語言/國家/地區組合) 僅支援一個名稱。
titleEIDR 文字 強烈建議原因- EIDR (國際影視產業識別碼機構) 識別碼，以最高層級/抽象層級表示電影或電視作品。

例如，電視影集第一季 (名為「《權力遊戲》) 第一集的 titleEIDR。」為「10.5240/B6A6-1B32-B5E5-D5CB-6B84-X」。
editEIDR 文字 強烈建議原因- 代表電影或電視作品的特定剪輯 / 版本 EIDR (國際影視產業識別碼機構) ID。

例如，在名為「權力遊戲」第一季的 TVSeries 第一季的第一集節目中，標題是「10.5240/B6A6-1B32-B5E5-D5CB-6B84-X」具有一個剪輯版本，例如："10.5240/FB97-C847-2969-D0AB-ECD1-C".

titleEIDR 提供 EditEIDR 時，為必要屬性。
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 網址 必要 - 這集節目所屬的 TVSeason 的 @id。
partOfSeason.seasonNumber 整數 必填 - 這個數字代表季別在電視影集的季別順序位置。
partOfSeries TVSeries 必填 - 此劇集所屬的電視影集。
partOfSeries.@type 文字 必要 - 一律設為 TVSeries。
partOfSeries.@id 網址 必要 - 這集節目所屬的 TVSeries 的 @id。
partOfSeries.name 文字 必填 - 電視影集的名稱。
partOfSeries.sameAs 文字 可識別節目的參考網頁網址例如節目的 Wikipedia 頁面。這必須與 url 屬性不同。
potentialAction WatchAction 如適用：提供動作詳細資料的動作標記物件。
  • 如果內容提供隨選即播影片 (VoD)，就必須使用這項屬性；動作標記物件必須提供內容的深層連結。
  • 如果影片可在 LiveTV 頻道上播放，這個屬性為選用項目；相關聯的 BroadcastService 實體會改為提供頻道的深層連結。
  • TVEpisode 可以同時在 VoD 和 LiveTV 上使用。
使用陣列指定多個區域的不同深層連結。請參閱「多個區域和語言」範例。
sameAs 強烈建議原因網址 可識別單集節目的參考網頁網址；即可查看該集節目的 Wikipedia 頁面。這必須與 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 機構或 Person 選用 - 發布這個實體的機構或人員。
description 文字 強烈建議原因該集節目的概要。繪製摘要時，建議採用事實摘要。長度上限為 300 個半形字元。
genre 文字 所有相關類型的排序清單。例如：["Action", "Fashion", "Environment", "Football"]
keywords 文字 用來描述此內容的關鍵字或標記。也可以使用陣列。舉例來說，["feature, Bigraphy"] 可以是描述內容的關鍵字陣列。
actor Person 或 PerformingGroup 或 PerformanceRole 強烈建議原因劇集的演員陣列。請參閱這裡的模型指南。
director Person 強烈建議原因劇集的導演。
producer 機構或 Person 強烈建議原因當季的製作人。
image ImageObject 強烈建議 Google TV 的原因：各種與電視劇集相關的圖片。如要進一步瞭解要與 image 加入的必要和選用屬性，請參閱「圖片屬性」一節。
trailer.description 文字 預告片的說明。請參閱預告片範例。
trailer.inLanguage 文字 預告片的語言，採用 BCP 47 格式。
trailer.url 網址 由各製片公司或授權來源公開代管及上傳的預告片網址。
trailer.regionsAllowed 地點 允許播放媒體內容的區域。如果未指定，則系統會假設可以在任何國家/地區播放。請採用 ISO 3166 格式來指定國家/地區。
review 評論 查看電視劇集的分級
review.reviewRating 評分 如果提供 review，則為必填；這個欄位是用來指定評論中的評分。
contentRating Text 或 Rating 如果是成人內容，此為必填屬性，否則強烈建議使用 - 整體內容分級。如果內容分級以文字字串的形式表示，可接受兩種變化版本：
  • 評分機構在評分前面加上空格，例如「TV-MA」來自代理商「TVPG」的分級應稱之為「TVPG TV-MA」。詳情請參閱代理商名單。
  • 「評分不認識」的值(不區分大小寫)，表示您不知道該內容的分級。
contentRating.author Text 或 Organization 如果 contentRating 使用 Rating，則為必填 - 評分機構的名稱。如要查看可接受的分級機構清單，請參閱內容分級機構頁面
contentRating.ratingValue 文字 如果 contentRating 使用 Rating，則為必要屬性 - 評分值。
contentRating.advisoryCode 文字 內容的指導程式碼。接受的值包括 D、FV、L、S 和 V. D = 對話、FV = 奇幻暴力、L = 語言、S = 色情內容、V = 暴力內容。
identifier PropertyValue 強烈建議原因- 可明確識別這個實體的外部 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 網址 必要 - 內容 ID，以 URI 格式表示；例如 https://example.com/1234abc。
@id 必須符合下列規定：
  • 產品目錄全球不重複
  • 這個 ID 應固定，不會隨時間而改變 (即使節目的網址資源有所變更)，系統會視為不透明字串，且不一定要是有效連結。
  • 採用統一資源識別碼 (URI) 格式
  • 用於 @id 值的網域必須由貴機構所擁有。
由於實體的 url 符合 ID 的所有規定，因此我們建議您使用實體的 url 做為 @id。詳情請參閱「ID」一節。
url 網址 必要 - Google 會使用內容的標準網址，將動態消息內容與 Google 資料庫中的內容進行比對。
url必須符合下列規定：
  • url 須為全域唯一值
  • url 必須包含可供 Google 檢索的有效標準網址。
如需播放的深層連結，請改為參閱目標物件的 urlTemplate 屬性。
name 文字 必填 - 這個電視節目季別的名稱。
  • 使用陣列列出不同語言的名稱。請參閱多語言表示法範例。
  • 請注意，每個語言代碼 (語言/國家/地區組合) 僅支援一個名稱。
titleEIDR 文字 強烈建議原因- EIDR (國際影視產業識別碼機構) 識別碼，以最高層級/抽象層級表示電影或電視作品。

例如：電視影集第一季的 titleEIDR，稱為「權力遊戲」是「10.5240/FD91-C72C-4161-FCBA-058B-1」。
seasonNumber 整數 必填 - 這個數字代表季別在電視影集的季別順序位置。
partOfSeries TVSeries 必填 - 本季所屬的電視影集。
partOfSeries.@type 文字 必要 - 一律設為 TVSeries。
partOfSeries.@id 網址 必填 - 該季別的 TVSeries @id。
partOfSeries.name 文字 必填 - 電視影集的名稱。
partOfSeries.sameAs 文字 可識別節目的參考網頁網址例如節目的 Wikipedia 頁面。這必須與 url 屬性不同。
potentialAction WatchAction 如適用：提供動作詳細資料的動作標記物件。
  • 如果內容提供隨選即播影片 (VoD)，就必須使用這項屬性；動作標記物件必須提供內容的深層連結。
  • 如果影片可在 LiveTV 頻道上播放，這個屬性為選用項目；相關聯的 BroadcastService 實體會改為提供頻道的深層連結。
  • TVSeason 可以同時在 VoD 和 LiveTV 上使用。
使用陣列指定多個區域的不同深層連結。請參閱「多個區域和語言」範例。
sameAs 網址 強烈建議原因可識別季別的參考網頁網址例如當季的 Wikipedia 頁面。這必須與 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 機構或 Person 選用 - 發布這個實體的機構或人員。
description 文字 強烈建議原因賽季簡介。繪製摘要時，建議採用事實摘要。長度上限為 300 個半形字元。
actor [Person、PerformingGroup 或 PerformanceRole 強烈建議原因該季演員陣容的陣列。請參閱這裡的模型指南。
director Person 強烈建議原因節目導演陣列。
producer 機構或 Person 強烈建議原因當季的製作人。
image ImageObject 與 TVSeason 相關的圖片。如要進一步瞭解要與 image 加入的必要和選用屬性，請參閱「圖片屬性」一節。
genre 文字 所有相關類型的排序清單。例如：["Action", "Fashion", "Environment", "Football"]
keywords 文字 用來描述此內容的關鍵字或標記。也可以使用陣列。舉例來說，["feature, Bigraphy"] 可以是描述內容的關鍵字陣列。
trailer.description 文字 預告片的說明。請參閱預告片範例。
trailer.inLanguage 文字 預告片的語言，採用 BCP 47 格式。
trailer.url 網址 由各製片公司或授權來源公開代管及上傳的預告片網址。
trailer.regionsAllowed 地點 允許播放媒體內容的區域。如果未指定，則系統會假設可以在任何國家/地區播放。請採用 ISO 3166 格式來指定國家/地區。
identifier PropertyValue 強烈建議原因- 可明確識別這個實體的外部 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 如果是成人內容，此為必填屬性，否則強烈建議使用 - 整體內容分級。如果內容分級以文字字串的形式表示，可接受兩種變化版本：
  • 評分機構在評分前面加上空格，例如「TV-MA」來自代理商「TVPG」的分級應稱之為「TVPG TV-MA」。詳情請參閱代理商名單。
  • 「評分不認識」的值(不區分大小寫)，表示您不知道該內容的分級。
contentRating.author Text 或 Organization 如果 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 強烈建議原因：轉換成員的陣列。

您可以使用陣列來代表多位 Person、PerformingGroups 或 PerformanceRole。

使用 Person 或 PerformingGroup 類型

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

屬性 預期類型 說明
@type Person 或 PerformingGroup 必要 - 一律設為 Person 或 PerformingGroup
@id 網址 強烈建議原因- 執行者或執行 URI 格式的群組 ID；例如 https://example.com/actor/abc。@id 必須符合下列規定：
  • 為每位演員/表演群組的目錄建立全域專屬 ID
  • 這個 ID 應固定，不會隨時間而改變。系統會視為不透明字串，且不一定要是有效連結。
  • 採用統一資源識別碼 (URI) 格式
  • 貴機構必須擁有用於 @id 值的網域。

請注意，演員屬性中使用的 @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 網址 強烈建議原因- 執行者或執行 URI 格式的群組 ID；例如 https://example.com/actor/abc。@id 必須符合下列規定：
  • 為每位演員/表演群組的目錄建立全域專屬 ID
  • 這個 ID 應固定，不會隨時間而改變。系統會視為不透明字串，且不一定要是有效連結。
  • 採用統一資源識別碼 (URI) 格式
  • 貴機構必須擁有用於 @id 值的網域。

請注意，演員屬性中使用的 @id 應在整個動態饋給中一致。舉例來說，如有兩部電影含有同一名演員，則這兩個演員物件中的 @id 值應保持一致。
actor.name 文字 必要 - 演員/演員/演員/表演團體的名稱。
actor.sameAs 網址 強烈建議原因- 可識別演員或表演團體的參考網頁網址；例如這位演員的維基百科頁面。此屬性必須與 actor.@id 屬性不同。

可接受的角色名稱

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

roleName 值 說明
〈Cameo〉 客串角色 (又稱客串角色) 是一位知名人士在表演藝術過程中短暫出現的畫面，
「VoiceActor」 語音效能是指使用演員的聲音，但畫面上未出現該名演員的聲音。這種動畫最常出現在動畫中，不過當演員的說話者配音時，其他演員的說話時會發生這種情況。
「雙倍」 雙精度浮點數是一種取代其他演員，導致臉部無法顯示。
「MotionCaptureActor」 MotionCaptureActor 是指真人演員錄製動作的畫面，以及使用該資訊製作 2D 或 3D 電腦動畫中的數位角色模型動畫。

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

roleName 值 說明
「執行者」 演員或演員就是在劇院傳統媒介或現代媒體 (如電影、電台與電視) 中呈現角色的人物。
「GuestStar」 「客座明星是扮演虛構角色，且出現在一或多集節目中的演員。有時來賓的明星可能正在扮演重要的反覆出現角色，雖然並非主要演員，但該主角仍會重複出現在同一系列影片中。將值設為「GuestStar」與來賓共同演出或來賓。客串節目只能在單集節目層級提供，請勿在電視影集層級新增。
「Guest」 「一位來賓上演談話節目，請注意，「GuestStar」是虛構角色「訪客」以非虛構的呈現方式
「播報員」 播報員是指負責為節目提供開幕和閉幕式、介紹主持人、參賽者及/或名人嘉賓、介紹獎勵內容，並在活動休息前暖身並暖場。
「評論者」 評論者為遊戲或活動提供即時評論，通常是在現場直播期間。
「印象派」 印象派或模仿表演者是指表演者，其行為包含模仿名人和卡通人物的聲音、聲音和刻板印象。
「主機」 介紹、展示或主持電視節目的人，通常是節目和目標對象的中介者。「主機」通常指非虛構角色
「CoHost」 與其他參與者聯合舉辦活動/計畫的人員。
「GuestHost」 嘉賓是主持人，通常為談話性節目，由主持人負責主持該節目，以取代一般主辦人。
「Newscaster」 一名民眾透過電視新聞節目向大眾呈現或告知民眾有關地方、全國和國際發生的新聞與事件。
「當事者」 記者或現場記者通常是指某期雜誌的記者或評論員，或是擔任報紙、廣播或電視新聞或其他類型公司報導的代理人 (通常是遠處的偏遠地區)。
「ShowJudge」 法官是節目領域專家，也是「評審」角色。評論參賽者 並參加電視影集的競賽
「窗格清單」 參與廣播或電視面板的討論或顧問小組。
「參賽者」 競賽或遊戲節目中的參賽者是指參加競賽的人。
「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"
  }
]

請參閱下列網頁，瞭解與這些房源相關的主題：