Phần này mô tả chi tiết các thuộc tính đánh dấu nội dung của image
cho phim và chương trình truyền hình. Thẻ đánh dấu này cho phép nhà cung cấp mô tả loại hình ảnh, chẳng hạn như tiêu đề, nền hay hình ảnh mang tính biểu tượng và cách sử dụng đề xuất.
Bảng thông số kỹ thuật
Bạn có thể cung cấp thuộc tính image
cho các loại thực thể Movie
, TVSeries
, TVSeason
hoặc TVEpisode
. Bảng sau đây mô tả các thuộc tính có sẵn cho thuộc tính image
. Lưu ý rằng thuộc tính additionalProperty
bao gồm
tên thuộc tính tùy chỉnh có tên là contentAttributes
. Thuộc tính này chứa một loạt các giá trị mô tả loại hình ảnh và mục đích sử dụng của hình ảnh đó.
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" . |
@type |
Văn bản | Bắt buộc – Luôn đặt thành ImageObject . |
contentUrl |
URL | Bắt buộc – URL của hình ảnh. |
additionalProperty |
PropertyValue | Bắt buộc – Xác định thuộc tính contentAttributes , thuộc tính này mô tả loại hình ảnh và mục đích sử dụng của hình ảnh. Để biết thêm thông tin,
hãy đọc
contentAttributes . |
character |
Person (Người) |
Bắt buộc nếu có – Một nhân vật hư cấu liên kết với hình ảnh. Đây là thuộc tính bắt buộc nếu |
inLanguage |
Văn bản | Bắt buộc nếu có – Ngôn ngữ của văn bản dùng trong hình ảnh. Sử dụng một trong các mã ngôn ngữ theo tiêu chuẩn IETF BCP 47.
Nếu hình ảnh bao gồm contentAttribute thuộc tính hasTitle , thuộc tính này là bắt buộc. |
regionsAllowed |
Địa điểm | Nên dùng – Những khu vực được phép chụp ảnh. Nếu không được chỉ định, hệ thống sẽ giả định rằng hình ảnh đó được cho phép ở mọi nơi. Hãy chỉ định quốc gia ở định dạng ISO 3166. |
datePublished |
Ngày | Bắt buộc nếu có – Ngày mà sau đó hình ảnh có sẵn, ở định dạng ISO 8601 (bao gồm cả múi giờ).
Nếu có hạn chế theo thời gian đối với việc sử dụng hình ảnh, bạn phải cung cấp thuộc tính này nếu hình ảnh không được hiển thị trước ngày cụ thể. Nếu không có quy định hạn chế như vậy, bạn có thể bỏ qua. Bạn phải cung cấp hình ảnh tương ứng trong nguồn cấp dữ liệu ít nhất 7 ngày trước ngày ngày xuất bản. Điều này sẽ làm tăng cơ hội nội dung xuất hiện đúng lúc trên các nền tảng của Google. |
expires |
Ngày | Bắt buộc nếu có – Ngày mà sau đó hình ảnh không còn hiển thị nữa, ở định dạng ISO 8601 (bao gồm cả múi giờ).
Mọi nguồn cấp dữ liệu phải cập nhật ngày hết hạn trong nguồn cấp dữ liệu ít nhất 7 ngày trước ngày hết hạn. Điều này sẽ làm tăng nguy cơ ngừng nội dung xuất hiện trên các nền tảng của Google vào ngày hết hạn. |
audience |
Đối tượng người xem | Nên – Đối tượng dự định hoặc đối tượng ưu tiên cho hình ảnh này. |
audience.geographicArea |
Khu vực hành chính | Nên dùng – Khu vực dự kiến hoặc ưu tiên cho hình ảnh này.
Ngược lại, hãy sử dụng regionsAllowed để chỉ định các giới hạn cố định. Nếu bạn không chỉ định audience.geographicArea , thuộc tính này sẽ được giả định là có thể sử dụng ở mọi nơi. Hãy chỉ định quốc gia ở định dạng ISO 3166. |
copyrightHolder |
Organization (Tổ chức) hoặc Person (Người) | Nên – Bên nắm giữ bản quyền đối với hình ảnh đó. |
keywords |
Văn bản | Nên dùng – Từ khóa hoặc thẻ dùng để mô tả hình ảnh này.
Bạn có thể cung cấp nhiều keywords bằng một mảng. Ví dụ: ["tính năng, tiểu sử"] |
name |
Văn bản | Nên làm – Tên hình ảnh. |
Thuộc tính nội dung
Thuộc tính contentAttributes
của image
mô tả loại hình ảnh và xác định các cách sử dụng đề xuất. Các danh mục trong danh sách sau đây bao gồm
các giá trị contentAttributes
mà nhà cung cấp phải đưa vào trong mỗi ImageObject
.
Loại
iconic
: Hình minh hoạ minh hoạ chương trình. Thường là kết xuất nghệ thuật.sceneStill
: Một phần trích dẫn từ chương trình.castInCharacter
: Ảnh của một thành viên tham gia diễn viên khi họ xuất hiện trong nhân vật. Nếu bạn sử dụng giá trị này, hãy thêm cả thuộc tínhcharacter
để xác định ký tự cụ thể trong hình ảnh. Nếu có nhiều ký tự, chẳng hạn như trong một nhóm truyền, hãy thêm nhiều thuộc tínhcharacter
dưới dạng một mảng.logo
: Hình ảnh chỉ chứa biểu trưng. Đó có thể là biểu trưng đồ hoạ hoặc biểu trưng tiêu đề. Bao gồm lớp phủ tương ứng để chỉ định lớp phủ đó.
Để hợp lệ, hãy sử dụng một và chỉ một trong hai loại sau.
Đề xuất sử dụng
poster
: Hình ảnh áp phích của chương trình. Trong giao diện người dùng của máy tính, các thẻ này có thể được sử dụng trong băng chuyền. Các chương trình này có thể chứa hoặc không chứa tiêu đề chương trình.background
: Hình ảnh thích hợp dùng làm nền với lớp phủ văn bản hoặc giao diện người dùng. Những hình ảnh này không chứa văn bản.
Để hợp lệ, hãy đưa vào tối đa một trong số các cách sử dụng đề xuất sau.
Mức độ phù hợp với kích thước
smallFormat
: Hình ảnh phù hợp với các màn hình nhỏ như điện thoại di động. Mọi văn bản hoặc biểu trưng trong hình ảnh đều dễ đọc trên màn hình nhỏ.largeFormat
: Hình ảnh phù hợp với màn hình lớn hoặc áp phích được in.
Một hình ảnh có thể sử dụng cả hai giá trị này.
Nền phù hợp
forDarkBackground
: Hình ảnh thường là một biểu trưng trong suốt và phù hợp để sử dụng trên nền tối.forLightBackground
: Hình ảnh thường là một biểu trưng trong suốt và phù hợp để sử dụng trên nền sáng.
Để hợp lệ, hãy sử dụng tối đa một giá trị mức độ phù hợp ở chế độ nền.
Lớp phủ
hasTitle
: Tiêu đề của chương trình hoặc tên nhân vật hoặc diễn viên có trong hình ảnh. Hãy nhớ thêm thuộc tínhinLanguage
cho hình ảnh.noTitle
: Hình ảnh không bao gồm tiêu đề.hasLogo
: Hình ảnh bao gồm biểu trưng của một bộ phim hoặc chương trình, chủ sở hữu nội dung hoặc nhà phân phối.noLogo
: Hình ảnh không bao gồm biểu trưng.hasCopyright
: Hình ảnh bao gồm thông báo bản quyền hiển thị.noCopyright
: Hình ảnh không bao gồm thông báo bản quyền hiển thị. Google thường không thể sử dụng những hình ảnh như vậy nếu không sửa đổi.hasMatte
: Hình ảnh có độ mờ. Đó có thể là hộp ngang (hộp chạy chữ), dọc (thanh cột) hoặc cả hai (hộp cửa sổ). Đôi khi, hình ảnh bị mờ có thể vừa với tỷ lệ khung hình. Thường thì Google không thể sử dụng những hình ảnh như vậy nếu không sửa đổi.noMatte
: Hình ảnh không có độ mờ.transparentBackground
: Nền của hình ảnh trong suốt. Tính năng này thường dùng cho những hình ảnh chỉ là tiêu đề hoặc biểu tượng và không có tính chất nào khác.
Để hợp lệ, chỉ tiêu đề, một biểu trưng, một bản quyền và một thuộc tính mờ mới được phép.
Vị trí của nhân vật nổi trội
centered
: Nhân vật nổi bật nằm ở chính giữa hình ảnh.rightCentered
: Hình chủ yếu được đặt về phía bên phải của hình ảnh, khiến bên trái tương đối trống đối với các lớp phủ văn bản và giao diện người dùng.leftCentered
: Hình chủ yếu được đặt về phía bên trái của hình ảnh, khiến bên phải tương đối trống đối với các lớp phủ văn bản và giao diện người dùng.
Để hợp lệ, hãy bao gồm tối đa một trong các vị trí sau.
Hình ảnh ví dụ với mục đích sử dụng
Ví dụ về hình ảnh và contentAttributes của chúng
Loại hình ảnh mong muốn cho các sản phẩm của Google
Các sản phẩm và giao diện của Google yêu cầu loại hình ảnh và tỷ lệ khung hình khác nhau. Để đảm bảo nội dung hiển thị đúng trên tất cả sản phẩm của Google, chúng tôi yêu cầu nhà cung cấp cung cấp tất cả các loại hình ảnh từ bảng sau.
Tỷ lệ khung hình và contentAttributes | Độ phân giải tối thiểu (pixel) | Movie | Phim truyền hình dài tập | Phần phim truyền hình | Tập phim truyền hình | Dịch vụ phát sóng |
---|---|---|---|---|---|---|
16:9, iconic poster |
3840x2160 | |||||
2:3, iconic poster |
1000x1500 | |||||
4:3, iconic poster |
800x600 | |||||
1:1, iconic poster |
600x600 | |||||
3:4, |
600x800 | |||||
16:9, |
3840x2160 | |||||
2:3, |
1000x1500 | |||||
3:4, |
600x800 | |||||
1:1, Hiển thị biểu trưng (hasLogo ) |
600x600 | |||||
4:3, Biểu trưng kênh (logo ) |
800x600 | |||||
Biểu trưng kênh 1:1 (logo ) |
600x600 | |||||
16:9, Biểu trưng kênh (logo ) |
3840x2160 | |||||
9:5, |
1800x1000 |
Các nguyên tắc sau được áp dụng khi bạn gửi hình ảnh:
- Hình ảnh phải ở định dạng JPEG, PNG hoặc WebP.
- Bao gồm các hình ảnh có độ phân giải cao nhất.
- Kích thước tệp không được vượt quá 20 MB.
- Bạn nên chọn
centered
hình ảnh. Hình nềnrightCentered
vàleftCentered
cũng có thể được một số sản phẩm sử dụng, vì vậy bạn có thể bao gồm hình nền đó nếu có. - Chúng tôi muốn các hình ảnh phù hợp với cả
smallFormat
vàlargeFormat
. - Bạn có thể bao gồm các kích thước hình ảnh ngoài các kích thước được liệt kê trong bảng trước đó.
- Xác minh rằng tỷ lệ khung hình của mỗi hình ảnh là một trong những giá trị chung được liệt kê trong bảng trước. Nếu không, hệ thống sẽ đưa ra cảnh báo.
Hình ảnh mẫu có giản đồ
Các ví dụ sau đây cho biết cách định dạng giản đồ cho hình ảnh liên kết với phim hoặc chương trình truyền hình.
Hình nền phim với hai ký tự
{
"@context": [ "http://schema.org", { "@language": "en" } ],
"@type": "Movie",
"@id": "http://www.example.com/mountain_view",
"url": "http://www.example.com/my_favorite_movie",
...,
"image": {
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Mountain View: A Movie poster",
"Keywords": ["Mauren, Lord Wingflap the Destroyer"],
"contentUrl": "http://example.com/images/mountain-view.jpg",
"character": [
{ "@type": "Person", "name": "Mauren" },
{ "@type": "Person", "name": "Lord Wingflap the Destoyer" },
],
"copyrightHolder": {
"@type": "Organization",
"name": " ExampleOrganization Studios, Inc."
},
"inLanguage": "en-US",
"audience": {
"@type": "Audience",
"geographicArea": [{"@type": "Country", "name": "US"},
{"@type": "Country", "name": "GB"},
{"@type": "Country", "name": "CA"},
{"@type": "Country", "name": "AU"}]
},
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": [ "iconic", "background", "rightCentered", "noTitle", "noLogo",
"noCopyright", "noMatte", "smallFormat", "largeFormat"]
}
]
}
}
Hình nền TVSeries bị giới hạn ở hai khu vực
{
"@context": [ "http://schema.org", { "@language": "en" } ],
"@type": "TVSeries",
"@id": "http://www.example.com/mountain_view",
"url": "http://www.example.com/mountain_view",
...,
"image": {
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Mountain View: A TV Show",
"contentUrl": "http://example.com/images/mountain-view.jpg",
"copyrightHolder": {
"@type": "Organization",
"name": "ExampleOrganization Studios, Inc."
},
"inLanguage": "en-US",
"regionsAllowed": [{ "@type": "Country", "name": "US" },
{ "@type": "Country", "name": "GB" }],
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": ["iconic", "background", "rightCentered", "smallFormat",
"largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]
}
]
}
}
Hình ảnh áp phích của phim dành cho hai khu vực
{
"@context": [ "http://schema.org", { "@language": "en" } ],
"@type": "Movie",
"@id": "http://www.example.com/pulsar_quest",
"url": "http://www.example.com/pulsar_quest",
...,
"image": {
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Pulsar Quest: A New Frontier",
"contentUrl": "http://example.com/images/pulsar-quest.jpg",
"copyrightHolder": {
"@type": "Organization",
"name": "ExampleOrganization Studios, Inc."
},
"inLanguage": "en-US",
"audience": [{ "@type": "Country", "name": "US" },
{ "@type": "Country", "name": "GB" }],
"character": [
{
"@type": "Person",
"name": "Captain Pulsar"
}
],
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": ["iconic", "poster", "smallFormat", "largeFormat", "hasTitle",
"hasLogo", "noCopyright", "noMatte", "centered"]
}
]
}
}
Áp phích phim khổ lớn có cả tiếng Hàn và tiếng Anh
{
"@context": [ "http://schema.org", { "@language": "en" } ],
"@type": "Movie",
"@id": "http://www.example.com/pulsar_quest",
"url": "http://www.example.com/pulsar_quest",
...,
"image": {
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Pulsar Quest: A New Frontier poster",
"contentUrl": "http://example.com/images/pulsar-quest.jpg",
"copyrightHolder": {
"@type": "Organization",
"name": "ExampleOrganization Studios, Inc."
},
"inLanguage": ["kr", "en"],
"audience": { "@type": "Country", "name": "KR" },
"character": [
{ "@type": "Person", "name": "Captain Pulsar" },
{ "@type": "Person", "name": "Space Cadet Shaniah" },
{ "@type": "Person", "name": "Rove the Rover" },
],
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
"noCopyright", "noMatte", "centered"]
}
]
}
}
Biểu thị nhiều hình ảnh trong mỗi khu vực
{
"@context": [ "http://schema.org", { "@language": "en" } ],
"@type": "Movie",
"@id": "http://www.example.com/pulsar_quest",
"url": "http://www.example.com/pulsar_quest",
...,
"image": [{
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Pulsar Quest: A New Frontier poster",
"contentUrl": "http://example.com/images/pulsar-quest-us.jpg",
"copyrightHolder": {
"@type": "Organization",
"name": "ExampleOrganization Studios, Inc."
},
"inLanguage": ["en"],
"audience": { "@type": "Country", "name": "US" },
"character": [
{ "@type": "Person", "name": "Captain Pulsar" },
{ "@type": "Person", "name": "Space Cadet Shaniah" },
{ "@type": "Person", "name": "Rove the Rover" }
],
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
"noCopyright", "noMatte", "centered"]
}
]
},{
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Pulsar Quest: A New Frontier poster",
"contentUrl": "http://example.com/images/pulsar-quest-kr.jpg",
"copyrightHolder": {
"@type": "Organization",
"name": "ExampleOrganization Studios, Inc."
},
"inLanguage": ["kr"],
"audience": { "@type": "Country", "name": "KR" },
"character": [
{ "@type": "Person", "name": "Captain Pulsar" },
{ "@type": "Person", "name": "Space Cadet Shaniah" },
{ "@type": "Person", "name": "Rove the Rover" }
],
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
"noCopyright", "noMatte", "centered"]
}
]
}]
}
Biểu thị hình ảnh có giới hạn thời gian
{
"@context": [ "http://schema.org", { "@language": "en" } ],
"@type": "Movie",
"@id": "http://www.example.com/pulsar_quest",
"url": "http://www.example.com/pulsar_quest",
...,
"image": [{
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Pulsar Quest: A New Frontier poster",
"contentUrl": "http://example.com/images/pulsar-quest-jp.jpg",
"copyrightHolder": {
"@type": "Organization",
"name": "ExampleOrganization Studios, Inc."
},
"datePublished": "2022-10-31T17:00:00Z",
"expires": "2025-10-31T16:59:59Z",
"inLanguage": ["ja"],
"audience": { "@type": "Country", "name": "JP" },
"character": [
{ "@type": "Person", "name": "Captain Pulsar" },
{ "@type": "Person", "name": "Space Cadet Shaniah" },
{ "@type": "Person", "name": "Rove the Rover" }
],
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
"noCopyright", "noMatte", "centered"]
}
]
},{
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Pulsar Quest: A New Frontier poster",
"contentUrl": "http://example.com/images/pulsar-quest-kr.jpg",
"copyrightHolder": {
"@type": "Organization",
"name": "ExampleOrganization Studios, Inc."
},
"datePublished": "2021-10-31T17:00:00Z",
"expires": "2023-10-31T16:59:59Z",
"inLanguage": ["kr"],
"audience": { "@type": "Country", "name": "KR" },
"character": [
{ "@type": "Person", "name": "Captain Pulsar" },
{ "@type": "Person", "name": "Space Cadet Shaniah" },
{ "@type": "Person", "name": "Rove the Rover" }
],
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
"noCopyright", "noMatte", "centered"]
}
]
}]
}