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

電視節目的內容標記屬性

本節提供 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`	機構組織	如果 `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`	機構組織	如果 `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`	機構組織	如果 `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 物件中。在投放成員的角色不明時，使用人員類型來指出獨立發動者，或 PerformingGroup，提供表演群組/頻帶的詳細資料。您可以使用陣列來代表多位 Person、PerformingGroups 或 PerformanceRole。

actor

Person 或 PerformingGroup 或 PerformanceRole

強烈建議原因：轉換成員的陣列。

請在播放角色時使用 PerformanceRole 類型，並視需要得知演員的字元名稱。在本例中，演員 Person 或 PerformingGroup 會嵌入 PerformanceRole 物件中。
在投放成員的角色不明時，使用人員類型來指出獨立發動者，或 PerformingGroup，提供表演群組/頻帶的詳細資料。

您可以使用陣列來代表多位 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"
  }
]

電視節目的內容標記屬性

規格表

TVSeries

TVEpisode

TVSeason

執行者規格

使用 Person 或 PerformingGroup 類型

使用 PerformanceRole 類型

可接受的角色名稱

區分演員的主要角色和輔助角色

範例

TVSeries、TVEpisode 和 TVSeason 示例

TVSeries

TVEpisode

TVSeason

Actor 屬性範例

演員角色不明

演員角色已知

執行者子集的已知角色

相關網頁

使用 `Person` 或 `PerformingGroup` 類型

使用 `PerformanceRole` 類型

`TVSeries`、`TVEpisode` 和 `TVSeason` 示例

`Actor` 屬性範例