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 | Nội dung 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 mọi yêu cầu dưới dạng giá trị nhận dạng, nên bạn cần sử dụng url của một thực thể làm @id. Hãy xem mục 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 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:
urlTemplate của đối tượng target. |
name |
Văn bản | Bắt buộc – Tên phim.
|
titleEIDR |
Văn bản | Rất nên dùng Tại sao? - Số nhận dạng EIDR (Registry Identifier Registry) đại diện cho cấp độ khái quát/chung nhất của một tác phẩm điện ảnh hoặc truyền hình. Ví dụ: EIDR cho phim chuyển động được gọi là "Ghostbusters" là "10.5240/7EC7-228A-510A-053E-CBB8-J". |
editEIDR |
Văn bản | Rất nên dùng Tại sao? - Số nhận dạng EIDR (Đăng ký nhận dạng giải trí) thể hiện bản chỉnh sửa / ấn bản cụ thể của một tác phẩm phim hoặc chương trình truyền hình. Ví dụ: ảnh chuyển động được gọi là "Ghostbusters" có tiêu đề TCF là "10.5240/7EC7-228A-510A-053E-CBB8-J", có một số chỉnh sửa, chẳng hạn như "10.5240/1F2A-E1C5-680A-14C6-E76B-I-5-4"45455"6 tháng 11-2019"4444445 linh châu 4450999999 ha DoD460 Không gian riêng tư" titleEIDRThuộc tính là 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.
|
sameAs |
URL | Rất nên dùng Tại sao? URL tới một trang web tham khảo có thể nhận dạng phim; ví dụ: trang Wikipedia của phim. Thuộc tính này phải khác biệt 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ự tất cả thể loại liên quan. Ví dụ : ["Hành động", "Thời trang", "Môi trường", "Bóng đá"] |
keywords |
Văn bản | Từ khóa hoặc thẻ được sử dụng để mô tả nội dung này. Hệ thống cũng cho phép một mảng từ khóa. Ví dụ: ["tính năng, tiểu sử"] có thể là một mảng từ khóa để 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 nội dung gốc (toàn cầu hoặc địa phương) của nhà xuất bản, chẳng hạn như ngày phát hành tại rạp ban đầu.Ngoài ra, hãy dùng FeaturedEvent để cho biết dịch vụ của bạn tiếp thị nội dung này dưới dạng một tác phẩm gốc, nổi bật, đặc biệt, v.v.ExclusiveEvent cho biết rằng dịch vụ của bạn có quyền phân phối độc quyền và bao gồm thông tin chi tiết về địa điểm và thời gian. |
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 các tùy chọn sau:
|
releasedEvent.location |
Quốc gia | Bắt buộc – Các khu vực liên quan đến 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 có nội dung nổi bật hoặc độc quyền.Hãy sử dụng mã ISO 3166 cho các quốc gia. Để chỉ báo ở mọi nơi trên thế giới, hãy đặt thành EARTH. |
releasedEvent.startDate |
Ngày hoặc Ngày giờ | Được đề xuất - 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, đây là 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 bộ phim lần đầu tiên.Đối với ExclusiveEvent và FeaturedEvent, đây là ngày bắt đầu khi thực thể độc quyền hoặc được giới thiệu. |
releasedEvent.endDate |
Ngày hoặc Ngày giờ | Nên dùng – Bắt buộc đối với ExclusiveEvent – Chỉ áp dụng cho loại ExclusiveEvent và FeaturedEvent.Đối với ExclusiveEvent, đây là ngày mà các quyền đối với nội dung hết hạn.Đối với FeaturedEvent, đây là ngày gần nhất mà nhà cung cấp giới thiệu về thực thể.Nếu nội dung đó thuộc về độc quyền hoặc nội dung vĩnh viễn, 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) | Tùy chọn - Tổ chức hoặc người đã xuất bản đối tượng này. |
description |
Văn bản | Rất nên dùng Tại sao? Bản tóm tắt phim. Bản tóm tắt cốt truyện được ưu tiên so với các bản tóm tắt thực tế. Giới hạn 300 ký tự.
|
duration |
Thời lượng | Thời gian chạy 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? (Các) Đạo diễn của phim. |
actor |
Person (Người) | Rất nên dùng Tại sao? (Các) thành viên của 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 | 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 trong image, hãy xem phần Thuộc tính hình ảnh. |
trailer.description |
Văn bản | Mô tả đ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 đoạn giới thiệu được lưu trữ công khai và do các studio sản xuất tương ứng tải lên hoặc được ủy quyền. |
trailer.regionsAllowed |
Địa điểm | Vùng được phép sử dụng nội dung nghe nhìn. Nếu bạn không chỉ định thì mã này sẽ được cho phép ở mọi nơi. Chỉ định quốc gia ở định dạng ISO 3166. |
identifier |
PropertyValue | Rất nên dùng Tại sao? - ID bên ngoài hoặc ID khác xác định rõ ràng thực thể này. Cho phép có nhiều số nhận dạng. Xem mục Thuộc tính số nhận dạng để biết chi tiết. |
review |
Bài đánh giá | Đánh giá xếp hạng cho Phim |
review.reviewRating |
Điểm xếp hạng | Bắt buộc nếu đánh giá được cung cấp. Điểm này được sử dụng để xác định xếp hạng có trong bài đánh giá. |
contentRating |
Text (Văn bản) hoặc Rating (Xếp hạng) | Bắt buộc đối với nội dung người lớn, rất nên dùng Vì sao? - Xếp hạng nội dung tổng thể. Nếu xếp hạng nội dung được cung cấp dưới dạng chuỗi văn bản, hai biến thể được chấp nhận:
|
contentRating.author |
Văn bản hoặc 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 khiêu dâm, V = Bạo lực. |
popularityScore |
Thông số điểm phổ biến | 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ên phát nội dung nghe nhìn nào 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ủa các điểm trên danh sách của bạn phải nhất quá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 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 đối tượng; điểm cao hơn có nghĩa là mức độ phổ biến cao hơn. |
popularityScore.eligibleRegion |
Quốc gia | (Các) vùng có điểm phổ biến này. Nếu điểm phổ biến á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 từng ngôn ngữ được ưu tiên hơn mức độ phổ biế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:
|
workExample |
Phim | Chỉ định các biến thể của phim. Hãy đưa thuộc tính này vào thực thể Movie chính chứ không phải 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à 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 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 bất kỳ danh mục nào sau đây:
|
Ví dụ:
Phim chính
Một bộ phim có phiên bản cắt dài.
{
"@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ể cắt mở rộng
Phiên bản cắt dài 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 để biết các chủ đề liên quan đến các thuộc tính này: