本節提供 Movie 實體類型的內容標記屬性的詳細資料。
規格表
| 屬性 | 預期類型 | 說明 |
|---|---|---|
@context |
Text | 必要 - 一律設定為 ["http://schema.org", {"@language": "xx"}]
|
@type |
Text | 必要 - 一律將電影設為 Movie。 |
@id |
網址 | 必要 - 內容 ID 的 URI 格式，例如 https://example.com/1234abc。@id 必須符合下列規定：
url 符合所有需求條件，因此建議您使用實體的 url 做為 @id。詳情請參閱「ID」一節。 |
url |
網址 | 必要 - 內容的標準網址，Google 會使用這項資料將動態饋給中的內容與 Google 資料庫中的內容進行比對。url 必須符合下列規定：
urlTemplate 屬性。 |
name |
Text | 必要 - 電影的名稱。
|
titleEIDR |
Text | 強烈建議為什麼？- EIDR (娛樂 ID 識別碼) 這個 ID，代表最一般/抽象層級的作品或電影。 舉例來說，名為「Ghostbusters」的動態圖片標題為「10.5240/7EC7-228A-510A-053E-CBB8-J」。 |
editEIDR |
Text | 強烈建議為什麼？- EIDR (娛樂識別碼識別碼) ID，代表電影或電視的特定編輯 / 版本。 舉例來說，名為「Ghostbuster」的標題相片為「G0buster-10.5240/7EC7-228A-510A-053E-CBB8-1-294--2-69-5-46-E-46-E-46-E-46-E-69-5-4-6-E-46-E-46-E-69-5-4-2-49-5-4-2-6-8-2-4-5-4-4-5-4-4-5-4-5-4-2-4-5-4-5-4-4-5-4-5-4-5-4-5-4-4-5-4-4-5-4-4-5-4-5-4-4 titleEIDR提供 EditEIDR 時必填屬性。 |
potentialAction |
WatchAction | 必要 (如果適用) - 動作標記物件，提供動作的詳細資料。
|
sameAs |
網址 | 強烈建議為什麼？可識別電影的參照網頁網址，例如電影的維基百科頁面。這必須與 url 屬性不同。 |
inLanguage |
Text | 電影的原始語言，格式為 BCP 47。 |
genre |
Text | 所有相關類型的已排序清單。例如：[動作]、[時尚]、[環境]、[足球]] |
keywords |
Text | 用來描述這項內容的關鍵字或標記。系統也允許使用關鍵字陣列。舉例來說，["feature, biography"] 可以是關鍵字陣列來說明內容。 |
releasedEvent |
PublicationEvent、FeaturedEvent 或 ExclusiveEvent |
強烈建議為什麼？- PublicationEvent 是用來指定發布者的原始內容 (全球或當地內容)，例如電影的原始戲劇發行日期。此外，請使用 FeaturedEvent 來表示你的服務有原創、精選、特殊內容等性質，可以適時展示你的服務市場。ExclusiveEvent 請參閱相關服務的詳細資料，包括發布時間和地點。 |
releasedEvent.@type |
Text | 必要 - 請務必一律將這個屬性設為下列其中一個值：
|
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 個半形字元。
|
duration |
時間長度 | 影片畫質，採 ISO 8601 格式。請使用以下格式：「PT00H00M」。 |
director |
Person | 強烈建議為什麼？電影導演。 |
actor |
Person | 強烈建議為什麼？電影的演員。 |
producer |
機構或人員 | 強烈建議為什麼？電影的製作人。 |
image |
ImageObject | Google TV 必填 - 與電影相關的圖片。如要進一步瞭解 image 的必要必要和選用屬性，請參閱 Image 屬性。 |
trailer.description |
Text | 預告片的說明。請參閱宣傳短片範例。 |
trailer.inLanguage |
Text | 預告片格式 (BCP 47 格式)。 |
trailer.url |
網址 | 預告片是由相關的製片工作室或授權來源公開發布及上傳。 |
trailer.regionsAllowed |
地點 | 允許媒體的區域。如未指定，系統會假設所有位置皆可使用。請使用 ISO 3166 格式指定國家/地區。 |
identifier |
PropertyValue | 強烈建議為什麼？- 可明確識別這個實體的外部 ID 或其他 ID。可使用多個 ID。詳情請參閱「ID 屬性」一節。 |
review |
評論 | 電影的評分 |
review.reviewRating |
評分 | 如有提供，此為必要欄位。用來指定評論中的評分。 |
contentRating |
文字或評分 | 成人內容為必填，強烈建議使用 為什麼？- 整體內容分級。如果內容分級採用文字字串，則可接受兩種變化版本：
|
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 = 暴力。 |
popularityScore |
熱門分數規範 | 強烈建議為什麼？Google 會根據分數和其他信號，決定向使用者播放的媒體。這個分數代表內容相對於目錄中其他內容的熱門程度，因此該分數在動態饋給中的所有實體中必須保持一致。實體的熱門程度預設為 0。 |
popularityScore.@type |
Text | 一律設為 PopularityScoreSpecification。 |
popularityScore.value |
Number | 非負數數值代表實體的熱門程度，分數越高，表示人氣越高。 |
popularityScore.eligibleRegion |
國家/地區 | 適用此熱門分數的區域。如果熱門分數適用於全球，請將設為 EARTH。根據預設，此屬性會設為 EARTH。Note: 地區專屬熱門內容的優先順序高於全球 (EARTH) 熱門程度 |
category |
Text | 必要 (如果適用)：如果實體是 Movie 變化版本，請填入這個屬性。將 category 設為下列其中一個值：
|
workExample |
電影 | 指定電影的變化版本。請在這個屬性加入主要 Movie 實體，而非變化版本的 Movie 實體。 |
workExample.@id |
網址 | 如果是 Movie 變化版本，這個屬性會提供 @id 實體的 Movie 實體。 |
workExample.@type |
Text | 必要 - 一律設為 Movie。這可以是 Movie 陣列，其中包含多個變化版本的陣列。 |
workExample.@id |
網址 | 必要 - Movie 變化版本的 @id。 |
workExample.name |
Text | 必要 - Movie 變數的名稱。 |
workExample.category |
Text | 必要 - 特定版本的電影子類。將類別設為下列任一選項：
|
範例
主要電影
具有延展片段的電影。
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie",
"url": "http://www.example.com/my_favorite_movie",
"name": "My Favorite Movie",
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_movie?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",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "https://example.com/package/example"
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
"contentRating": "RATING NOT KNOWN",
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2008-01-20",
"location": {
"@type": "Country",
"name": "US"
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 78,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
},
"description": "This is my favorite movie.",
"actor": [
{
"@type": "Person",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/John_Doe"
},
{
"@type": "Person",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
}
],
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt0123456"
}
],
"workExample": {
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie_extended_cut",
"name": "My Favorite Movie Extended Cut"
"category": "Extended Cut"
}
}
延伸剪裁子類
主要電影的延長版。
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie_extended_cut",
"url": "http://www.example.com/my_favorite_movie_extended_cut",
"name": "My Favorite Movie Extended Cut",
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_movie_extended_cut?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",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "http://www.example.com/example_package",
"identifier": "example.com:example_package"
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie_extended_cut",
"contentRating": {
"@type": "Rating",
"author": "MPAA",
"ratingValue": "R",
"advisoryCode": "FV"
},
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2008-01-20",
"location": {
"@type": "Country",
"name": "US"
}
},
"description": "This is the extended cut of my favorite movie.",
"actor": [
{
"@type": "Person",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/John_Doe"
},
{
"@type": "Person",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
}
],
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt0123456"
}
],
"exampleOfWork": {
"@id": "http://www.example.com/my_favorite_movie",
}
"category": "Extended Cut"
}
相關網頁
請參閱下列網頁，瞭解與這些資源相關的主題：