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 mọi yêu cầu về 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. 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 target. |
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? – Mã 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/trừu tượng nhất. Ví dụ: titleEIDR cho bộ 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 (Entertainment Identifier Registry) đạ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ụ: bộ phim điện ảnh có tên "Ghostbusters" (Biệt đội bắt ma) có mã nhận dạng EIDR là "10.5240/7EC7-228A-510A-053E-CBB8-J", có một số bản chỉnh sửa, chẳng hạn như "10.5240/1F2A-E1C5-680A-14C6-E76B-I" và "10.5240/8A35-3BEE-6497-5D12-9E4F-3". Bạn bắt buộc phải có thuộc tính titleEIDR khi cung cấp editEIDR. |
potentialAction |
WatchAction | Bắt buộc nếu có – Một đố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 phim; ví dụ: trang Wikipedia của phim. Giá trị này phải khác với thuộc tính url. |
inLanguage |
Văn bản | Rất nên dùng Ngôn ngữ gốc của phim ở định dạng BCP 47. |
genre |
Văn bản | Danh sách có 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ể 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 được dùng để chỉ định lần phát hành nội dung ban đầu (trên toàn cầu hoặc tại địa phương) của một nhà xuất bản, chẳng hạn như ngày phát hành ban đầu của một bộ phim tại rạp.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 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ó độc quyền phân phối nội dung này, đồng thời cho biết địa điểm và thời gian.Hãy 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 – Nhớ luôn đặt thuộc tính này thành một trong các giá trị sau:
|
releasedEvent.location |
Quốc gia | Bắt buộ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 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. Để cho biết 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ờ) | Đượ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, ngày 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 một bộ phim được phát hành lần đầu tại rạp chiếu phim.Đối với ExclusiveEvent và FeaturedEvent, ngày này biểu thị ngày bắt đầu khi thực thể được độ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ờ) | Nên dùng – Bắt buộc đối với ExclusiveEvent – 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 quyền đối với nội dung.Đối với FeaturedEvent, thuộc tính này thể hiện ngày cuối cùng mà nhà cung cấp giới thiệu thực thể.Nếu nội dung độc quyền hoặc đượ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 |
Organization (Tổ chức) hoặc Person (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 phim. Bạn nên sử dụng bản tóm tắt cốt truyện thay vì bản 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 |
Organization (Tổ chức) hoặc Person (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 thêm vào image, hãy xem 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 | Rất nên dùng 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 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. Hãy 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 giá trị nhận dạng khác giúp 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. Hãy xem phần Thuộc tính của giá trị nhận dạng để biết thông tin chi tiết. |
review |
Bài đánh giá | Điểm đánh giá cho Phim |
review.reviewRating |
Mức phân loại | 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 (Mức phân loại) | Bắt buộc đối với nội dung người lớn, nên dùng cho các nội dung khác Vì 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ì bạn có thể dùng 2 biến thể:
|
contentRating.author |
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 mức phân loại. |
contentRating.advisoryCode |
Văn bản | Mã cảnh báo cho nội dung. Các giá trị được chấp nhận bao gồm D, FV, L, S và V. D = Dialogue (Lời thoại), FV = Fantasy Violence (Bạo lực trong bối cảnh giả tưởng), L = Language (Ngôn từ), S = Sexual Content (Nội dung tình dục), V = Violence (Bạo lực). |
popularityScore |
PopularityScoreSpecification | Rất nên dùng Lý do? Một đ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 nào 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ủa điểm số này cần phải nhất quán trên các nguồn cấp dữ liệu của bạn, 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ị bằng 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 mà điểm mức độ phổ biến này áp dụng. 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 ngôn ngữ và khu vực sẽ được ưu tiên hơn mức độ phổ biến trên toàn cầu (TRÁI ĐẤT) |
category |
Văn bản | Bắt buộc nếu có – Điền sẵ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 phiên bản của bộ phim. Đư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à một biến 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 các danh mục sau:
|
Ví dụ:
Phim chính
Một bộ phim có phiên bản 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 mở rộng
Phiên bản mở rộng của bộ 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 những thuộc tính này: