電影的內容標記屬性

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

規格表

屬性 預期類型 說明
@context 文字 必要 - 一律設為 ["http://schema.org", {"@language": "xx"}]
  • 地點」xx 英寸會呈現動態饋給中字串的語言。每個根實體內容都應將其 @language 設為適當的語言代碼,並採用 BCP 47 格式。舉例來說,如果將語言設為西班牙文,即使字幕/配音語言是英文,系統也會假設名稱是以西班牙文顯示。
@type 文字 必要 - 電影一律設為 Movie
@id 網址 必要 - 內容 ID,以 URI 格式表示;例如 https://example.com/1234abc
@id 必須符合下列規定:
  • 產品目錄全球不重複
  • 靜態;這個 ID 應固定,不會隨時間而改變 (即使節目的網址資源有所變更),系統會視為不透明字串,且不一定要是有效連結。
  • 採用統一資源識別碼 (URI) 格式
  • 用於 @id 值的網域必須由貴機構所擁有。
由於實體的 url 符合 ID 的所有規定,因此我們建議您使用實體的 url 做為 @id。詳情請參閱「ID」一節。
url 網址 必要 - Google 會使用內容的標準網址,將動態消息內容與 Google 資料庫中的內容進行比對。
url必須符合下列規定:
  • url 須為全域唯一值
  • url 必須包含可供 Google 檢索的有效標準網址。
如需播放的深層連結,請改為參閱目標物件的 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 如適用:提供動作詳細資料動作標記物件
  • 如果內容提供隨選即播影片 (VoD),就必須使用這項屬性;動作標記物件必須提供內容的深層連結
  • 如果影片可在 LiveTV 頻道上播放,這個屬性為選用項目;相關聯的 BroadcastService 實體會改為提供頻道的深層連結。
  • Movie 可以同時在 VoD 和 LiveTV 上使用。
使用陣列指定多個區域的不同深層連結。請參閱「多個區域和語言」範例。
sameAs 網址 強烈建議原因可識別電影的參考網頁網址例如電影的維基百科頁面這必須與 url 屬性不同。
inLanguage 文字 電影的原始語言,採用 BCP 47 格式。
genre 文字 所有相關類型的排序清單。例如:["Action", "Fashion", "Environment", "Football"]
keywords 文字 用來描述此內容的關鍵字或標記。也可以使用陣列。舉例來說,["feature, Bigraphy"] 可以是描述內容的關鍵字陣列。
releasedEvent PublicationEventFeaturedEventExclusiveEvent 強烈建議原因- PublicationEvent 可用來指定出版商製作內容的原始 (全球或當地) 發行日期,例如電影的原始上映日期。

此外,請使用 FeaturedEvent 指明服務市場包含原創、精選、特殊等格式的內容。

ExclusiveEvent 說明您的服務具有專屬發行權,並在適當時間加上地點和範例。請參閱範例章節,瞭解詳細資訊和範例。

releasedEvent.@type 文字 必要 - 請務必將這個屬性一律設為下列其中一個值:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location 國家/地區 必填 - 與這項活動相關聯的區域。

PublicationEvent 來說,這是指內容發布的區域。

FeaturedEventExclusiveEvent 來說,這是指內容精選或專屬地區。

國家/地區請使用 ISO 3166 代碼。如要表示世界上任何地方,請設為 EARTH
releasedEvent.startDate DateDateTime 建議 - 必要項目 - ExclusiveEvent 的必要項目 - 實體的發布日期。

如果是 PublicationEvent,表示實體的初次發行日期,例如電影首次上映的日期。

如果是 ExclusiveEventFeaturedEvent,這代表實體獨佔或精選內容的開始日期。
releasedEvent.endDate DateDateTime 建議 - 對於 ExclusiveEvent 的必填屬性 - 僅適用於 ExclusiveEventFeaturedEvent 類型。

如果是 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 TextRating 如果內容含有成人內容,此為必填屬性,極力建議採用;原因- 整體內容分級。如果內容分級以文字字串的形式表示,可接受兩種變化版本:
  • 評分機構在評分前面加上空格,例如「PG-13」「MPAA」代理商的評分應稱之為「MPAA PG-13」。詳情請參閱代理商名單
  • 「評分不認識」的值(不區分大小寫),表示您不知道電影的分級。
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 設為下列任一項目:
  • Home Release:出售或租借供家庭觀賞的版本。
  • Theatrical Release:已於電影院上發行的版本。
  • International Release:已編輯後要向全球發布的版本。
  • Remastered:將圖片、聲音或兩者皆可提升為較新標準的版本。
  • Unrated:未經過 MPAA 或類似代理商審查的版本。
  • Director Cut:代表董事已核准的編輯內容版本。
  • Extended Cut:比院線上版還長的版本。
workExample 電影 指定電影變化版本。在主要 Movie 實體中加入這個屬性,而不是變化版本版本的 Movie 實體。
workExample.@id 網址 如果是 Movie 變數,這個屬性會提供 Movie 實體的 @id,做為其變化版本的變化版本。
workExample.@type 文字 必要 - 一律設為 Movie。這可以表示含有多個變化版本的 Movie 陣列。
workExample.@id 網址 必要 - Movie 變數的 @id
workExample.name 文字 必要 - Movie 變數的名稱。
workExample.category 文字 必要 - 特定版本的電影子類類型。將類別設為下列任一項目:
  • Home Release:出售或租借供家庭觀賞的版本。
  • Theatrical Release:已於電影院上發行的版本。
  • International Release:已編輯後要向全球發布的版本。
  • Remastered:將圖片、聲音或兩者皆可提升為較新標準的版本。
  • Unrated:未經過 MPAA 或類似代理商審查的版本。
  • 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"
}

請參閱下列網頁,瞭解與這些房源相關的主題: