本節提供 Movie 實體類型的內容標記屬性詳細資料。
規格表
| 屬性 | 預期類型 | 說明 |
|---|---|---|
@context |
文字 | 必要 - 一律設為 ["http://schema.org", {"@language": "xx"}]
|
@type |
文字 | 必要 - 電影一律設為 Movie。 |
@id |
網址 | 必要 - 內容 ID，以 URI 格式表示；例如 https://example.com/1234abc。@id 必須符合下列規定：
url 符合 ID 的所有規定，因此我們建議您使用實體的 url 做為 @id。詳情請參閱「ID」一節。 |
url |
網址 | 必要 - Google 會使用內容的標準網址，將動態消息內容與 Google 資料庫中的內容進行比對。url必須符合下列規定：
urlTemplate 屬性。 |
name |
文字 | 必要 - 電影名稱。
|
titleEIDR |
文字 | 強烈建議原因- EIDR (國際影視產業識別碼機構) 識別碼，以最高層級/抽象層級表示電影或電視作品。 例如「Ghostbusters」動態相片的 titleEIDR為「10.5240/7EC7-228A-510A-053E-CBB8-J」。 |
editEIDR |
文字 | 強烈建議原因- 代表電影或電視作品的特定剪輯 / 版本 EIDR (國際影視產業識別碼機構) ID。 舉例來說，電影名稱為「Ghostbusters」其 titleEIDR 為「10.5240/7EC7-228A-510A-053E-CBB8-J」具有幾次編輯，例如"10.5240/1F2A-E1C5-680A-14C6-E76B-I"和「10.5240/8A35-3BEE-6497-5D12-9E4F-3」。 titleEIDR 提供 EditEIDR 時，為必要屬性。 |
potentialAction |
WatchAction | 如適用：提供動作詳細資料的動作標記物件。
|
sameAs |
網址 | 強烈建議原因可識別電影的參考網頁網址例如電影的維基百科頁面這必須與 url 屬性不同。 |
inLanguage |
文字 | 電影的原始語言，採用 BCP 47 格式。 |
genre |
文字 | 所有相關類型的排序清單。例如：["Action", "Fashion", "Environment", "Football"] |
keywords |
文字 | 用來描述此內容的關鍵字或標記。也可以使用陣列。舉例來說，["feature, Bigraphy"] 可以是描述內容的關鍵字陣列。 |
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 |
機構或 Person | 選用 - 發布這個實體的機構或人員。 |
description |
文字 | 強烈建議原因這部電影的概要。繪製摘要時，建議採用事實摘要。長度上限為 300 個半形字元。
|
duration |
時間長度 | 電影的執行階段 (ISO 8601 格式)。請使用以下格式：「PT00H00M」。 |
director |
Person | 強烈建議原因電影的導演。 |
actor |
Person | 強烈建議原因電影的演員。 |
producer |
機構或 Person | 強烈建議原因電影的製作人。 |
image |
ImageObject | Google TV 必填 - 電影相關圖片。如要進一步瞭解要與 image 加入的必要和選用屬性，請參閱「圖片屬性」一節。 |
trailer.description |
文字 | 預告片的說明。請參閱預告片範例。 |
trailer.inLanguage |
文字 | 預告片的語言，採用 BCP 47 格式。 |
trailer.url |
網址 | 由各製片公司或授權來源公開代管及上傳的預告片網址。 |
trailer.regionsAllowed |
地點 | 允許播放媒體內容的區域。如果未指定，則系統會假設可以在任何國家/地區播放。請採用 ISO 3166 格式來指定國家/地區。 |
identifier |
PropertyValue | 強烈建議原因- 可明確識別這個實體的外部 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"
}
相關網頁
請參閱下列網頁，瞭解與這些房源相關的主題：