電影的內容標記屬性

本節提供 Movie 實體類型的內容標記屬性詳細資料。

規格表

屬性 預期類型 說明
@context Text 必要 - 一律設為 ["http://schema.org", {"@language": "xx"}]
  • 其中「xx」代表動態饋給中字串的語言。每個根實體內容的 @language 都應設為適當的語言代碼，並採用 BCP 47 格式。舉例來說，如果語言設為西班牙文，即使字幕/配音語言為英文，系統也會假設名稱為西班牙文。
@type Text 必填 - 電影一律設為 Movie。
@id 網址 必要 - 內容的 ID，格式為 URI，例如 https://example.com/1234abc。
@id 必須符合下列規定：
  • 目錄中全域專屬
  • 靜態：這個 ID 應固定，不會隨著時間而改變 (即使節目網址屬性變更)。系統會將這個值視為不透明字串，且不一定要是有效連結。
  • 格式為統一資源識別碼 (URI)
  • 用於 @id 值的網域必須由貴機構所擁有。
由於實體的 url 符合所有 ID 規定，因此建議您使用實體的 url 做為 @id。詳情請參閱「ID」一節。
url 網址 必要 - 內容的標準網址。Google 會使用這個網址，比對動態饋給中的內容與 Google 資料庫中的內容。
url必須符合下列規定：
  • url 須為全域唯一值
  • url 必須包含 Google 可檢索的有效標準網址。
如要取得播放的深層連結，請改為查看 target 物件的 urlTemplate 屬性。
name Text 必要 - 電影片名。
  • 使用陣列列出不同語言的名稱。請參閱多個地區和語言範例。
  • 請注意，每個語言代碼 (語言和國家/地區的組合) 只能有一個名稱。
titleEIDR Text 強烈建議 原因 代表電影或電視作品的EIDR (EIDR) 識別碼，層級最一般/抽象。

舉例來說，電影「魔鬼剋星」的 titleEIDR 為「10.5240/7EC7-228A-510A-053E-CBB8-J」。
editEIDR Text 強烈建議 原因 代表電影或電視作品特定編輯 / 版本的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 視情況而定 - 提供動作詳細資料的動作標記物件。
  • 如果內容可透過隨選影片 (VOD) 觀看，則必須提供這項屬性；動作標記物件必須提供內容的深層連結。
  • 如果內容可透過 LiveTV 頻道觀看，這項屬性為選填，因為相關聯的 BroadcastService 實體會提供頻道的深層連結。
  • Movie 可在隨選影片和 LiveTV 中使用。
使用陣列在多個區域中指定不同的深層連結。請參閱多個地區和語言範例。
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 必要 - 請務必將這項屬性設為下列其中一項：
  • 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 Organization 或 Person 選用 - 發布這個實體的機構或個人。
description Text 強烈建議 原因 電影簡介。劇情簡介比事實摘要更合適。最多 300 個半形字元。
duration 時間長度 電影的片長，採 ISO 8601 格式。請使用「PT00H00M」格式。
director Person 強烈建議 原因 電影導演。
actor Person 強烈建議 原因 電影演員。
producer Organization 或 Person 強烈建議 原因 電影製片人。
image ImageObject Google TV 必填 - 與電影相關的圖片。如要進一步瞭解 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 Text 或 Rating 成人內容必須提供，其他內容則強烈建議提供為什麼？ - 整體內容分級。如果內容分級是以文字字串的形式提供，系統接受兩種變體：
  • 評等機構名稱會加在評等前面，並以半形空格分隔。舉例來說，美國「MPAA」機構的「PG-13」分級應描述為「MPAA PG-13」。請參閱機構清單。
  • 值為「RATING NOT KNOWN」(不區分大小寫)，表示你不知道電影的分級。
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: 地區專屬熱門度會優先於全球 (地球) 熱門度
category Text 適用時為必填 - 如果實體是 Movie 子類，請填入這個屬性。將 category 設為下列任一值：
  • Home Release：供居家觀賞的銷售或租借版本。
  • Theatrical Release：在電影院上映的版本。
  • International Release：經過編輯，可於國際發行的版本。
  • Remastered：圖像、音效或兩者皆經過改良，達到較新的標準。
  • Unrated：未經美國電影協會或類似機構審查的版本。
  • Director Cut：代表導演核准的編輯版本。
  • Extended Cut：比院線上映版本更長的版本。
workExample 電影 指定電影的變體。請在主要 Movie 實體中加入這項屬性，而非變體版本的 Movie 實體。
workExample.@id 網址 如果是 Movie 變數，這個屬性會提供 Movie 實體的 @id，這是該實體的變數。
workExample.@type Text 必要 - 一律設為 Movie。如果 Movie 有多個變化版本，則可以陣列形式表示。
workExample.@id 網址 必要 - Movie 變體的 @id。
workExample.name Text 必要 - Movie 變數的名稱。
workExample.category Text 必要 - 特定版本的電影變體類型。將類別設為下列任一項：
  • Home Release：供居家觀賞的銷售或租借版本。
  • Theatrical Release：在電影院上映的版本。
  • International Release：經過編輯，可於國際發行的版本。
  • Remastered：圖像、音效或兩者皆經過改良，達到較新的標準。
  • Unrated：未經美國電影協會或類似機構審查的版本。
  • Director Cut：代表導演核准的編輯版本。
  • Extended Cut：比院線上映版本更長的版本。

範例

主要電影

電影的加長版。

{
  "@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"
}

如要瞭解與這些屬性相關的主題，請參閱下列頁面：