Thuộc tính đánh dấu nội dung của phim

Phần này cung cấp thông tin chi tiết về các thuộc tính đánh dấu nội dung cho loại thực thể Movie.

Bảng thông số kỹ thuật

Thuộc tính Loại dự kiến Mô tả
@context Văn bản Bắt buộc – Luôn đặt thành ["http://schema.org", {"@language": "xx"}]
  • Địa điểm" xx inch thể hiện ngôn ngữ của các chuỗi trong nguồn cấp dữ liệu. Mỗi ngữ cảnh của thực thể gốc phải được đặt @language thành mã ngôn ngữ thích hợp ở định dạng định dạng BCP 47. Ví dụ: Nếu bạn đặt ngôn ngữ thành tiếng Tây Ban Nha, thì tên đó được giả định là bằng tiếng Tây Ban Nha ngay cả khi ngôn ngữ phụ đề/lồng tiếng là tiếng Anh.
@type Văn bản Bắt buộc – Luôn đặt thành Movie cho phim.
@id URL Bắt buộc – Giá trị nhận dạng của nội dung ở định dạng URI; ví dụ: https://example.com/1234abc.
@id phải đáp ứng các yêu cầu sau:
  • Độc đáo trên toàn cầu trong danh mục của bạn
  • Tĩnh; Mã này phải cố định và không thay đổi theo thời gian (ngay cả khi thuộc tính url của chương trình thay đổi). URL này sẽ được coi là một chuỗi mờ và không cần phải là một đường liên kết hoạt động.
  • Ở dạng Giá trị nhận dạng tài nguyên hợp nhất (URI)
  • Miền mà bạn dùng cho giá trị @id phải thuộc sở hữu của tổ chức của bạn.
Vì url của một thực thể đáp ứng tất cả yêu cầu để có giá trị nhận dạng, nên bạn nên sử dụng url của một thực thể làm @id. Xem phần Identifier để biết thêm chi tiết.
url URL Bắt buộc – URL chính tắc của nội dung mà Google sử dụng để so khớp nội dung trong nguồn cấp dữ liệu của bạn với nội dung trong cơ sở dữ liệu của Google.
url phải đáp ứng các yêu cầu sau:
  • url phải là duy nhất trên toàn hệ thống
  • url phải chứa một URL chính tắc đang hoạt động mà Google có thể thu thập dữ liệu.
Để biết đường liên kết sâu của chế độ phát, hãy xem thuộc tính urlTemplate của đối tượng target.
name Văn bản Bắt buộc – Tên phim.
  • Sử dụng một mảng để liệt kê tên bằng nhiều ngôn ngữ. Xem ví dụ về Nhiều khu vực và ngôn ngữ.
  • Xin lưu ý rằng hệ thống chỉ hỗ trợ một tên cho mỗi ngôn ngữ (cặp ngôn ngữ-quốc gia).
titleEIDR Văn bản Rất nên dùng Tại sao? – Mã nhận dạng EIDR (Sổ đăng ký mã nhận dạng nội dung giải trí) thể hiện ở cấp độ chung/trừu tượng nhất, một tác phẩm phim hoặc chương trình truyền hình.

Ví dụ: tiêu đề EIDR cho phim điện ảnh có tên là "Ghosthost" là "10.5240/7EC7-228A-510A-053E-CBB8-J".
editEIDR Văn bản Rất nên dùng Tại sao? – Mã nhận dạng EIDR (Sổ đăng ký mã nhận dạng nội dung giải trí) đại diện cho bản chỉnh sửa / ấn bản cụ thể cho tác phẩm phim hoặc chương trình truyền hình.

Ví dụ: phim điện ảnh có tên "Phim ma" có tiêu đềEIDR là "10.5240/7EC7-228A-510A-053E-CBB8-J", có một số nội dung chỉnh sửa, ví dụ: "10.5240/1F2A-E1C5-680A-14C6-E76B-I" và "10.5240/8A35-3BEE-6497-5D12-9E4F-3".

titleEIDR Thuộc tính bắt buộc khi chỉnh sửa EIDR được cung cấp.
potentialAction WatchAction Bắt buộc nếu có – Đối tượng đánh dấu Hành động cung cấp thông tin chi tiết về hành động đó.
  • Nếu nội dung đó có trên Video theo yêu cầu (VoD), thì bạn phải cung cấp thuộc tính này; đối tượng đánh dấu Hành động cần cung cấp đường liên kết sâu của nội dung.
  • Nếu nội dung đó có trên một kênh Truyền hình trực tuyến, thì thuộc tính này là không bắt buộc; thực thể BroadcastService được liên kết sẽ cung cấp đường liên kết sâu của kênh.
  • Movie có thể hoạt động trên cả VoD và LiveTV.
Sử dụng một mảng để chỉ định nhiều đường liên kết sâu ở nhiều khu vực. Xem ví dụ về Nhiều khu vực và ngôn ngữ.
sameAs URL Rất nên dùng Tại sao? URL tới trang web tham khảo có thể xác định bộ phim; ví dụ: trang Wikipedia của bộ phim. Thuộc tính này phải khác với thuộc tính url.
inLanguage Văn bản Ngôn ngữ gốc của phim ở định dạng BCP 47.
genre Văn bản Danh sách theo thứ tự gồm tất cả thể loại có liên quan. Ví dụ : ["Hành động", "Thời trang", "Môi trường", "Bóng đá"]
keywords Văn bản Từ khoá hoặc thẻ dùng để mô tả nội dung này. Một loạt từ khoá cũng được cho phép. Ví dụ: ["đặc điểm, tiểu sử"] có thể là một mảng từ khoá để mô tả nội dung.
releasedEvent PublicationEvent, FeaturedEvent hoặc ExclusiveEvent Rất nên dùng Tại sao? – PublicationEvent dùng để chỉ định nhà xuất bản phát hành nội dung gốc (toàn cầu hoặc địa phương), chẳng hạn như ngày phát hành phim ở rạp chiếu gốc.

Ngoài ra, hãy sử dụng FeaturedEvent để cho biết dịch vụ của bạn sẽ tiếp thị nội dung này dưới dạng bản gốc, nội dung nổi bật, đặc biệt, v.v.

ExclusiveEvent xác định rằng dịch vụ của bạn có quyền phân phối độc quyền và bao gồm cả vị trí và thời điểm phát hành.

Hãy xem phần ví dụ để biết chi tiết và ví dụ.
releasedEvent.@type Văn bản Bắt buộc – Đảm bảo luôn đặt thuộc tính này thành một trong các giá trị sau:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Quốc gia Bắt buộc – Các khu vực liên kết với sự kiện này.

Đối với PublicationEvent, đây là khu vực xuất bản nội dung.

Đối với FeaturedEvent và ExclusiveEvent, đây là khu vực nơi nội dung được xuất hiện nổi bật hoặc độc quyền.

Sử dụng mã ISO 3166 cho các quốc gia. Để biểu thị ở mọi nơi trên thế giới, hãy đặt thành EARTH.
releasedEvent.startDate Date (Ngày tháng) hoặc DateTime (Ngày giờ) Đề xuất – Bắt buộc đối với ExclusiveEvent – Ngày bắt đầu ấn bản của thực thể.

Đối với PublicationEvent, đây là ngày phát hành đầu tiên của thực thể này, chẳng hạn như ngày phát hành phim lần đầu tại rạp.

Đối với ExclusiveEvent và FeaturedEvent, đây là ngày bắt đầu mà thực thể độc quyền hoặc xuất hiện nổi bật.
releasedEvent.endDate Date (Ngày tháng) hoặc DateTime (Ngày giờ) Đề xuất – Bắt buộc đối với ExclusiveEvent – Trường này chỉ áp dụng cho loại ExclusiveEvent và FeaturedEvent.

Đối với ExclusiveEvent, giá trị này thể hiện ngày các quyền đối với nội dung hết hạn.

Đối với FeaturedEvent, đây là ngày cuối cùng nhà cung cấp giới thiệu thực thể đó.

Nếu nội dung vĩnh viễn độc quyền hoặc nổi bật, hãy đặt endDate thành 20 năm kể từ ngày hiện tại.
releasedEvent.publishedBy Organization (Tổ chức) hoặc Person (Người) Không bắt buộc – Tổ chức hoặc cá nhân đã xuất bản thực thể này.
description Văn bản Rất nên dùng Tại sao? Bản tóm tắt về bộ phim. Nên ưu tiên bản tóm tắt cốt truyện so với bản tóm tắt dữ kiện. Giới hạn 300 ký tự.
duration Thời lượng Thời lượng của phim ở định dạng ISO 8601. Vui lòng sử dụng định dạng: "PT00H00M".
director Person (Người) Rất nên dùng Tại sao? Đạo diễn của bộ phim.
actor Person (Người) Rất nên dùng Tại sao? (Các) diễn viên của bộ phim.
producer Organization (Tổ chức) hoặc Person (Người) Rất nên dùng Tại sao? (Các) nhà sản xuất của bộ phim.
image ImageObject (Đối tượng hình ảnh) Bắt buộc đối với Google TV – Hình ảnh liên quan đến Phim. Để biết thêm thông tin chi tiết về các thuộc tính bắt buộc và không bắt buộc phải bao gồm với image, hãy xem bài viết Thuộc tính hình ảnh.
trailer.description Văn bản Nội dung mô tả về đoạn giới thiệu. Xem ví dụ về Đoạn giới thiệu.
trailer.inLanguage Văn bản Ngôn ngữ của đoạn giới thiệu ở định dạng BCP 47.
trailer.url URL URL của một đoạn giới thiệu được lưu trữ công khai và do các hãng sản xuất hoặc nguồn được uỷ quyền tương ứng lưu trữ.
trailer.regionsAllowed Địa điểm Các khu vực cho phép nội dung nghe nhìn này. Nếu bạn không chỉ định, thì thuộc tính này được coi là được cho phép ở mọi nơi. Hãy chỉ định các quốc gia theo định dạng ISO 3166.
identifier PropertyValue Rất nên dùng Tại sao? - Mã nhận dạng bên ngoài hoặc mã nhận dạng khác xác định rõ ràng thực thể này. Bạn được phép sử dụng nhiều giá trị nhận dạng. Xem phần Thuộc tính giá trị nhận dạng để biết thông tin chi tiết.
review Bài đánh giá Xem lại mức phân loại cho phim
review.reviewRating Điểm xếp hạng Bắt buộc nếu bạn gửi yêu cầu xem xét. Tham số này dùng để xác định điểm xếp hạng được đưa ra trong bài đánh giá.
contentRating Văn bản hoặc Xếp hạng Bắt buộc đối với nội dung người lớn, đặc biệt nên dùng Tại sao? – Mức phân loại nội dung tổng thể. Nếu mức phân loại nội dung được cung cấp ở dạng chuỗi văn bản, thì chúng tôi chấp nhận hai biến thể:
  • Tổ chức phân loại đã thêm một khoảng trắng ở giữa vào trước mức phân loại đó. Ví dụ: "PG-13" mức phân loại của cơ quan "MPAA" ở Hoa Kỳ phải được mô tả là "MPAA PG-13". Xem danh sách đại lý.
  • Giá trị "Xếp hạng KHÔNG BIẾT" (không phân biệt chữ hoa chữ thường) để cho biết bạn không biết mức phân loại của Bộ phim.
contentRating.author Text (Văn bản) hoặc Organization (Tổ chức) Bắt buộc nếu contentRating sử dụng Rating – Tên của cơ quan phân loại.
contentRating.ratingValue Văn bản Bắt buộc nếu contentRating sử dụng Rating – Giá trị của điểm xếp hạng.
contentRating.advisoryCode Văn bản Mã tư vấn cho nội dung. Các giá trị được chấp nhận bao gồm D, FV, L, S và V. D = Đối thoại, FV = Bạo lực ảo, L = Ngôn ngữ, S = Nội dung tình dục, V = Bạo lực.
popularityScore PopularityScoreSpecification Rất nên dùng Tại sao? Điểm số mà Google sử dụng cùng với các tín hiệu khác để xác định nội dung nghe nhìn sẽ phát cho người dùng. Điểm số này thể hiện mức độ phổ biến của nội dung so với những nội dung khác trong danh mục của bạn; do đó, thang điểm cần nhất quán trên các nguồn cấp dữ liệu của bạn, giữa tất cả các thực thể trong danh mục của bạn. Theo mặc định, điểm mức độ phổ biến của một thực thể được đặt là 0.
popularityScore.@type Văn bản Luôn đặt thành PopularityScoreSpecification.
popularityScore.value Number Một giá trị số không âm cho biết mức độ phổ biến của thực thể; điểm số càng cao thì mức độ phổ biến càng cao.
popularityScore.eligibleRegion Quốc gia (Các) khu vực có áp dụng điểm số phổ biến này. Nếu điểm phổ biến có thể áp dụng trên toàn cầu, hãy đặt thành EARTH. Theo mặc định, thuộc tính này được đặt thành EARTH.
Note: Mức độ phổ biến theo ngôn ngữ được ưu tiên hơn mức độ phổ biến trên toàn cầu (earth)
category Văn bản Bắt buộc nếu có – Điền thuộc tính này nếu thực thể là một biến thể Movie. Đặt category thành bất kỳ giá trị nào sau đây:
  • Home Release: Phiên bản được bán hoặc thuê để xem tại nhà.
  • Theatrical Release: Một phiên bản được phát hành ở rạp chiếu.
  • International Release: Một phiên bản được chỉnh sửa để phát hành trên toàn thế giới.
  • Remastered: Phiên bản có hình ảnh, âm thanh hoặc cả hai được cải tiến lên tiêu chuẩn mới hơn.
  • Unrated: Một phiên bản chưa được MPAA hoặc một cơ quan tương tự kiểm tra.
  • Director Cut: Một phiên bản thể hiện nội dung chỉnh sửa đã được đạo diễn phê duyệt.
  • Extended Cut: Một phiên bản dài hơn bản phát hành ở rạp chiếu.
workExample Phim Chỉ định các biến thể của phim. Hãy đưa thuộc tính này vào trong thực thể Movie chính, chứ không phải trong thực thể Movie cho các phiên bản biến thể.
workExample.@id URL Đối với các biến thể Movie, thuộc tính này cung cấp @id của thực thể Movie mà đây là một biến thể.
workExample.@type Văn bản Bắt buộc – Luôn đặt thành Movie. Giá trị này có thể được biểu thị dưới dạng một mảng cho Movie với nhiều biến thể.
workExample.@id URL Bắt buộc – @id của biến thể Movie.
workExample.name Văn bản Bắt buộc – Tên của biến thể Movie.
workExample.category Văn bản Bắt buộc – Loại phim biến thể của một phiên bản cụ thể. Đặt danh mục thành bất kỳ giá trị nào sau đây:
  • Home Release: Phiên bản được bán hoặc thuê để xem tại nhà.
  • Theatrical Release: Một phiên bản được phát hành ở rạp chiếu.
  • International Release: Một phiên bản được chỉnh sửa để phát hành trên toàn thế giới.
  • Remastered: Phiên bản có hình ảnh, âm thanh hoặc cả hai được cải tiến lên tiêu chuẩn mới hơn.
  • Unrated: Một phiên bản chưa được MPAA hoặc một cơ quan tương tự kiểm tra.
  • Director Cut: Một phiên bản thể hiện nội dung chỉnh sửa đã được đạo diễn phê duyệt.
  • Extended Cut: Một phiên bản dài hơn bản phát hành ở rạp chiếu.

Ví dụ:

Phim chính

Một bộ phim có phiên bản cắt mở rộng.

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

Phiên bản cắt mở rộng

Bản cắt ghép mở rộng của phim chính.

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

Hãy xem các trang sau để biết những chủ đề liên quan đến những tài sản này: