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"}]
|
@type |
Văn bản | Bắt buộc – Luôn đặt thành Movie đối với 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:
url của một thực thể đáp ứng tất cả các yêu cầu đối với giá trị nhận dạng, nên bạn nên sử dụng url của thực thể làm @id. Hãy xem phần Giá trị nhận dạng để biết thêm thông tin chi tiết. |
url |
URL | Bắt buộc – URL chính tắc của nội dung. Google sử dụng URL này để 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:
urlTemplate của đối tượng mục tiêu. |
name |
Văn bản | Bắt buộc – Tên phim.
|
titleEIDR |
Văn bản | Rất nên dùng Lý do? – Giá trị nhận dạng EIDR (Entertainment Identifier Registry) đại diện cho một tác phẩm điện ảnh hoặc truyền hình ở cấp độ chung nhất/trừu tượng. Ví dụ: titleEIDR cho phim điện ảnh có tên "Ghostbusters" là "10.5240/7EC7-228A-510A-053E-CBB8-J". |
editEIDR |
Văn bản | Rất nên dùng Lý do? – Giá trị nhận dạng EIDR (Mã đăng ký nhận dạng nội dung giải trí) đại diện cho một bản chỉnh sửa / ấn bản cụ thể của một tác phẩm điện ảnh hoặc truyền hình. Ví dụ: phim điện ảnh có tên "Ghostbusters" có mã EIDR là "10.5240/7EC7-228A-510A-053E-CBB8-J", có một số bản chỉnh sửa, ví dụ: "10.5240/1F2A-E1C5-680A-14C6-E76B-I" và "10.5240/8A35-3BEE-6497-5D12-9E4F-3". Thuộc tính titleEIDR là bắt buộc khi bạn cung cấp editEIDR. |
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.
|
sameAs |
URL | Rất nên dùng Lý do? URL của một trang web tham khảo có thể xác định được phim; ví dụ: trang Wikipedia về 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ự của tất cả cá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. Bạn cũng có thể sử dụng một mảng từ khoá. Ví dụ: ["feature, biography"] 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 Lý do? – PublicationEvent dùng để chỉ định bản phát hành nội dung ban đầu (toàn cầu hoặc cục bộ) của nhà xuất bản, chẳng hạn như ngày phát hành ban đầu tại rạp của một bộ phim.Ngoài ra, hãy sử dụng FeaturedEvent để cho biết dịch vụ của bạn tiếp thị nội dung này là nội dung gốc, nội dung nổi bật, nội dung đặc biệt, v.v.ExclusiveEvent chỉ định rằng dịch vụ của bạn có quyền phân phối độc quyền, bao gồm cả nơi và thời điểm.Xem phần ví dụ để biết thông tin chi tiết và ví dụ. |
releasedEvent.@type |
Văn bản | Bắt buộc – Hãy nhớ luôn đặt thuộc tính này thành một trong những giá trị sau:
|
releasedEvent.location |
Quốc gia | Bắt buộc – Các khu vực được liên kết với sự kiện này. Đối với PublicationEvent, đây là khu vực nơi nội dung được xuất bản.Đối với FeaturedEvent và ExclusiveEvent, đây là khu vực nơi nội dung được giới thiệu hoặc độc quyền.Sử dụng mã ISO 3166 cho quốc gia. Để cho biết ở mọi nơi trên thế giới, hãy đặt thành EARTH. |
releasedEvent.startDate |
Date hoặc DateTime | Nên dùng – Bắt buộc đối với ExclusiveEvent – Ngày bắt đầu xuất bản của thực thể.Đối với PublicationEvent, trường này biểu thị ngày phát hành ban đầu của thực thể này, chẳng hạn như ngày phát hành phim đầu tiên tại rạp.Đối với ExclusiveEvent và FeaturedEvent, trường này biểu thị ngày bắt đầu khi thực thể là độc quyền hoặc được làm nổi bật. |
releasedEvent.endDate |
Date hoặc DateTime | Nên dùng – Bắt buộc đối với ExclusiveEvent – Thuộc tính này chỉ áp dụng cho các loại ExclusiveEvent và FeaturedEvent.Đối với ExclusiveEvent, thuộc tính này thể hiện ngày hết hạn của quyền đối với nội dung.Đối với FeaturedEvent, thuộc tính này thể hiện ngày gần nhất mà nhà cung cấp giới thiệu thực thể.Nếu nội dung là nội dung độc quyền hoặc nội dung được giới thiệu vĩnh viễn, hãy đặt endDate thành 20 năm kể từ ngày hiện tại. |
releasedEvent.publishedBy |
Tổ chức hoặc Người | Không bắt buộc – Tổ chức hoặc người đã xuất bản thực thể này. |
description |
Văn bản | Rất nên dùng Lý do? Tóm tắt nội dung của bộ phim. Bạn nên ưu tiên tóm tắt cốt truyện thay vì tóm tắt thông tin thực tế. 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 Lý do? (Các) đạo diễn của bộ phim. |
actor |
Person (Người) | Rất nên dùng Lý do? (Các) diễn viên của bộ phim. |
producer |
Tổ chức hoặc Người | Rất nên dùng Lý do? (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 cần đưa vào image, hãy xem phần 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ề Trailer. |
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 phim hoặc nguồn được uỷ quyền tương ứng tải lên. |
trailer.regionsAllowed |
Địa điểm | Các khu vực mà nội dung nghe nhìn được phép xuất hiện. Nếu bạn không chỉ định, thì video này được giả định là được phép xuất hiện ở mọi nơi. Chỉ định các quốc gia ở định dạng ISO 3166. |
identifier |
PropertyValue | Rất nên dùng Lý do? – Giá trị nhận dạng bên ngoài hoặc mã khác giúp nhận dạng rõ ràng thực thể này. Bạn có thể sử dụng nhiều giá trị nhận dạng. Hãy 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á | Điểm xếp hạng bài đánh giá về Phim |
review.reviewRating |
Điểm xếp hạng | Bắt buộc nếu bạn cung cấp bài đánh giá. Thuộc tính này dùng để chỉ định điểm xếp hạng được đưa ra trong bài đánh giá. |
contentRating |
Text (Văn bản) hoặc Rating (Điểm xếp hạng) | Bắt buộc đối với nội dung người lớn, bạn nên làm như vậy đối với nội dung khác 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ưới dạng chuỗi văn bản, thì hệ thống sẽ chấp nhận hai biến thể:
|
contentRating.author |
Tổ chức | Bắt buộc nếu contentRating sử dụng Rating – Tên của công ty xếp hạng. |
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ã cảnh báo về nội dung. Các giá trị được chấp nhận bao gồm D, FV, L, S và V. D = Nội dung hội thoại, FV = Nội dung bạo lực giả tưởng, L = Ngôn từ, S = Nội dung tình dục, V = Nội dung bạo lực. |
popularityScore |
PopularityScoreSpecification | Rất nên dùng Lý do? Đ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 nội dung khác trong danh mục của bạn; do đó, thang điểm cần phải nhất quán trên các nguồn cấp dữ liệu, trong số tất cả các thực thể trong danh mục của bạn. Theo mặc định, điểm phổ biến của một thực thể được đặt thành 0. |
popularityScore.@type |
Văn bản | Luôn đặt thành PopularityScoreSpecification. |
popularityScore.value |
Number | 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 áp dụng điểm số về mức độ 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 một trong các giá trị sau:
|
workExample |
Phim | Chỉ định các biến thể của phim. Đưa thuộc tính này vào thực thể Movie chính, chứ không phải các 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à biến thể này là một biến thể của thực thể đó. |
workExample.@type |
Văn bản | Bắt buộc – Luôn đặt thành Movie. Bạn có thể biểu thị thuộc tính này dưới dạng một mảng cho Movie có 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 biến thể phim của một phiên bản cụ thể. Đặt danh mục thành một trong những danh mục sau:
|
Ví dụ:
Phim chính
Một bộ phim có biến thể 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"
}
}
Biến thể bản cắt dài
Phiên bản 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"
}
Các trang liên quan
Hãy xem các trang sau đây để biết các chủ đề liên quan đến những tài sản này: