本節將說明 Movie 實體類型的內容標記屬性詳細資料。
規格表
| 屬性 | 預期類型 | 說明 |
|---|---|---|
@context |
Text | 必要 - 一律設為 ["http:/
|
@type |
Text | 必填：一律設為 Movie (電影)。 |
@id |
網址 | 必填：內容的 ID，格式為 URI，例如 https://example.com/1234abc。@id 必須符合下列規定：
url 符合 ID 的所有必要條件，建議您將實體的 url 做為 @id。詳情請參閱「識別碼」一節。 |
url |
網址 | 必填：內容的標準網址，Google 會使用這項資訊，將動態饋給中的內容與 Google 資料庫中的內容進行比對。url 必須符合下列規定：
urlTemplate 屬性。 |
name |
Text | 必填：電影名稱。
|
titleEIDR |
Text | 強烈建議- EIDR (Entertainment Identifier Registry) 識別碼，用於表示最一般/抽象層級的電影或電視作品。 舉例來說，「Ghostbusters」這部電影的 titleEIDR 為「10.5240/7EC7-228A-510A-053E-CBB8-J」。 |
editEIDR |
Text | 強烈建議- EIDR (Entertainment Identifier Registry) 識別碼，代表電影或電視作品的特定編輯 / 版本。 舉例來說，「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」。提供 editEIDR 時，必須使用 titleEIDR 屬性。 |
potentialAction |
WatchAction | 如適用則為必要屬性：提供動作詳細資料的動作標記物件。
|
sameAs |
網址 | 強烈建議可識別電影的參考網頁網址，例如電影的維基百科網頁。這必須與 url 屬性不同。 |
inLanguage |
Text | 電影的原始語言，格式為 BCP 47。 |
genre |
Text | 所有相關類型的排序清單。例如：["Action"、"Fashion"、"Environment"、"Football"] |
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 所需和選用的屬性，請參閱「圖片屬性」。 |
trailer.description |
Text | 預告片的說明。請參閱預告片示例。 |
trailer.inLanguage |
Text | 預告片的語言，格式為 BCP 47。 |
trailer.url |
網址 | 預告片的網址，由相關製作公司或授權來源公開代管及上傳。 |
trailer.regionsAllowed |
Place | 允許觀看這部媒體的區域。如果未指定，系統會假設任何地方的使用者都可以瀏覽這部影片。請採用 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 = 對話、FV = 奇幻暴力、L = 語言、S = 性內容、V = 暴力。 |
popularityScore |
PopularityScoreSpecification | 強烈建議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 變數，這個屬性會提供 Movie 實體的 @id，而該實體是變數的變化版本。 |
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"
}
相關網頁
如要瞭解與這些屬性相關的主題，請參閱下列頁面：