本節提供 Movie 實體類型的內容標記屬性詳細資料。
規格表
| 屬性 | 預期類型 | 說明 |
|---|---|---|
@context |
文字 | 必要 - 一律設為 ["http://schema.org", {"@language": "xx"}]
|
@type |
文字 | 必填 - 電影一律設為 Movie。 |
@id |
網址 | 必要 - 內容的 URI 格式 ID，例如 https://example.com/1234abc。@id 必須符合下列規定：
url 符合所有 ID 規定，建議您使用實體的 url 做為 @id。詳情請參閱「ID」一節。 |
url |
網址 | 必要 - 內容的標準網址。Google 會使用這個網址，比對動態饋給中的內容與 Google 資料庫中的內容。url必須符合下列規定：
urlTemplate 屬性。 |
name |
文字 | 必要 - 電影片名。
|
titleEIDR |
文字 | 強烈建議 為什麼？ - EIDR (國際影視產業識別碼機構) 識別碼，代表電影或電視作品最一般/抽象的層級。 舉例來說，電影「魔鬼剋星」的 titleEIDR 為「10.5240/7EC7-228A-510A-053E-CBB8-J」。 |
editEIDR |
文字 | 強烈建議 為什麼？ - 代表電影或電視作品特定編輯 / 版本的 EIDR (國際影視產業識別碼機構) 識別碼。 舉例來說，電影「魔鬼剋星」的片名 EIDR 為「10.5240/7EC7-228A-510A-053E-CBB8-J」，但有幾個版本，例如「10.5240/1F2A-E1C5-680A-14C6-E76B-I」和「10.5240/8A35-3BEE-6497-5D12-9E4F-3」。提供 editEIDR 時， titleEIDR 屬性為必要屬性。 |
potentialAction |
WatchAction | 視情況而定 - 提供動作詳細資料的動作標記物件。
|
sameAs |
網址 | 強烈建議 為什麼？ 可識別電影的參考網頁網址，例如電影的維基百科頁面。這必須與 url 屬性不同。 |
inLanguage |
文字 | 強烈建議：電影的原始語言，格式為 BCP 47。 |
genre |
文字 | 所有相關類型的排序清單。例如：["Action", "Fashion", "Environment", "Football"] |
keywords |
文字 | 用來描述這項內容的關鍵字或標記。您也可以使用關鍵字陣列。舉例來說，["feature, biography"] 可以是描述內容的關鍵字陣列。 |
releasedEvent |
PublicationEvent、FeaturedEvent 或 ExclusiveEvent |
強烈建議 為什麼？ - PublicationEvent 用於指定發布者發布的原始內容 (全球或當地)，例如電影的原始戲院上映日期。此外，使用 FeaturedEvent 指出服務將此內容行銷為原創、精選、特別等。ExclusiveEvent 則指定服務擁有獨家發行權，並包含發行地點和時間。詳情和範例請參閱範例部分。 |
releasedEvent.@type |
文字 | 必要 - 請務必將這個屬性設為下列其中一項：
|
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 個半形字元。
|
duration |
時間長度 | 電影的片長，採 ISO 8601 格式。請使用「PT00H00M」格式。 |
director |
Person | 強烈建議 為什麼？ 電影導演。 |
actor |
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 屬性」一節。 |
review |
評論 | 電影的評論評分 |
review.reviewRating |
評分 | 如果提供評論，則為必填。用於指定評論中給出的評分。 |
contentRating |
Text 或 Rating | 成人內容必須提供，其他內容則強烈建議提供為什麼？ - 整體內容分級。如果內容分級是以文字字串的形式提供，系統接受兩種變體：
|
contentRating.author |
機構組織 | 如果 contentRating 使用 Rating，則為必要屬性 - 評等機構的名稱。 |
contentRating.ratingValue |
文字 | 如果 contentRating 使用 Rating，則為必要項目 - 評分值。 |
contentRating.advisoryCode |
文字 | 內容的警示代碼。可接受的值包括 D、FV、L、S 和 V。D = 對話、FV = 奇幻暴力、L = 語言、S = 性內容、V = 暴力。 |
popularityScore |
PopularityScoreSpecification | 強烈建議 為什麼？ Google 會使用這項分數和其他信號，判斷要為使用者播放哪種媒體。這個分數代表內容相對於目錄中其他內容的熱門程度，因此，目錄中所有實體的動態消息都必須採用一致的分數範圍。實體的熱門程度分數預設為 0。 |
popularityScore.@type |
文字 | 一律設為 PopularityScoreSpecification。 |
popularityScore.value |
Number | 非負數值，表示實體的熱門程度；分數越高，表示熱門程度越高。 |
popularityScore.eligibleRegion |
國家/地區 | 適用這項熱門度分數的區域。如果熱門度分數適用於全球，請設為 EARTH。這項屬性預設為 EARTH。Note: 地區專屬熱門度會優先於全球 (EARTH) 熱門度 |
category |
文字 | 適用時為必填 - 如果實體是 Movie 子類，請填入這個屬性。將 category 設為下列任一值：
|
workExample |
電影 | 指定電影的變體。請在主要 Movie 實體中加入這項屬性，而非變體版本的 Movie 實體。 |
workExample.@id |
網址 | 如果是 Movie 變數，這個屬性會提供 Movie 實體的 @id，也就是這個變數所屬的實體。 |
workExample.@type |
文字 | 必要 - 一律設為 Movie。如果 Movie 有多個變化版本，則可以表示為陣列。 |
workExample.@id |
網址 | 必要 - Movie 變體的 @id。 |
workExample.name |
文字 | 必要 - Movie 變體版本的名稱。 |
workExample.category |
文字 | 必要 - 特定版本的電影子類類型。將類別設為下列任一項：
|
範例
主要電影
電影的加長版。
{
"@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"
}
相關網頁
如要瞭解與這些屬性相關的主題，請參閱下列頁面：