Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Thuộc tính hình ảnh

Phần này trình bày chi tiết các thuộc tính đánh dấu nội dung của image cho phim, chương trình truyền hình, chương trình truyền hình trực tiếp và sự kiện thể thao. Mã đánh dấu này cho phép nhà cung cấp mô tả loại hình ảnh, chẳng hạn như hình ảnh đó là tiêu đề, nền hay hình ảnh biểu tượng và cách sử dụng được đề 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, TVEpisode, SportsEvent hoặc BroadcastEvent. 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 một tên thuộc tính tuỳ chỉnh có tên là contentAttributes, chứa một mảng các giá trị mô tả loại hình ảnh và mục đích sử dụng.

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"`.
`@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`, mô tả loại hình ảnh và mục đích sử dụng hình ảnh đó. Để biết thêm thông tin, hãy đọc bài viết `contentAttributes`.
`character`	Person (Người)	Bắt buộc nếu có – Nhân vật hư cấu liên kết với hình ảnh. Bạn bắt buộc phải cung cấp thông tin này nếu `contentAttribute` bao gồm `castInCharacter`. Lưu ý: Bạn có thể sử dụng loại `Person` tại đây ngay cả khi nhân vật không phải là con người.
`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 có `contentAttribute` là `hasTitle`, thì bạn bắt buộc phải chỉ định thuộc tính này.
`regionsAllowed`	Địa điểm	Nên dùng – Các khu vực mà hình ảnh được phép xuất hiện. Nếu bạn không chỉ định, thì hình ảnh đượ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.
`datePublished`	Ngày	Bắt buộc nếu có – Ngày mà sau đó hình ảnh sẽ xuất hiện, ở định dạng ISO 8601 (bao gồm cả múi giờ). Bạn có thể đặt ngày trong tương lai. Nếu có quy định hạn chế về thời gian sử dụng hình ảnh, thì bạn bắt buộc phải dùng thuộc tính này nếu không được hiển thị hình ảnh trước ngày đã cho. Nếu không có quy định hạn chế nào 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 xuất bản (datePublished). Việc này sẽ tăng cơ hội nội dung xuất hiện trên các nền tảng của Google đúng thời điểm.
`expires`	Ngày	Bắt buộc nếu có – Ngày mà sau đó hình ảnh sẽ không còn xuất hiện, ở định dạng ISO 8601 (bao gồm cả múi giờ). Nếu nội dung luôn có sẵn sau khi xuất bản, bạn có thể bỏ qua thuộc tính này. Bạn 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. Việc này sẽ tăng khả năng nội dung ngừng 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 dùng – Đối tượng dự kiến hoặc ưu tiên cho hình ảnh này.
`audience.geographicArea`	AdministrativeArea	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 quy định hạn chế nghiêm ngặt. Nếu bạn không chỉ định `audience.geographicArea`, thì hệ thống sẽ giả định rằng video này đượ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.
`copyrightHolder`	Organization hoặc Person	Nên dùng – 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ừ khoá hoặc thẻ dùng để mô tả hình ảnh này. Bạn có thể cung cấp nhiều `keywords` bằng cách sử dụng một mảng. Ví dụ: ["feature, biography"]
`name`	Văn bản	Nên dùng – Tên của hình ảnh.
`width`	Số nguyên	Không bắt buộc – Chiều rộng của hình ảnh dưới dạng số nguyên dương, tính bằng pixel (ví dụ: `1920`). Đừng thêm chuỗi đơn vị như `"px"`.
`height`	Số nguyên	Không bắt buộc – Chiều cao của hình ảnh dưới dạng số nguyên dương, tính bằng pixel (ví dụ: `1080`). Đừng thêm chuỗi đơn vị như `"px"`.

contentAttributes

Thuộc tính contentAttributes của image mô tả loại hình ảnh và xác định cách sử dụng được đề 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 mỗi ImageObject.

Loại

iconic: Hình ảnh minh hoạ cho chương trình. Thường là một bản kết xuất nghệ thuật.
sceneStill: Hình ảnh trích dẫn từ chương trình.
castInCharacter: Ảnh của một thành viên trong dàn diễn viên khi họ xuất hiện trong vai diễn. Nếu bạn sử dụng giá trị này, hãy thêm cả thuộc tính character để xác định nhân vật cụ thể trong hình ảnh. Nếu có nhiều nhân vật, chẳng hạn như trong một dàn diễn viên, hãy thêm nhiều thuộc tính character dưới dạng một mảng.
logo: Hình ảnh chỉ chứa biểu trưng. Đây có thể là biểu trưng đồ hoạ hoặc biểu trưng tiêu đề. Thêm lớp phủ tương ứng để chỉ định.

Để hợp lệ, hãy sử dụng một và chỉ một trong các loại này.

Cách sử dụng đề xuất

poster: Hình ảnh áp phích cho chương trình. Trong giao diện người dùng máy tính, bạn có thể sử dụng các nút này trong băng chuyền. Những hình ảnh này có thể chứa hoặc không chứa tiêu đề của chương trình.
background: Hình ảnh phù hợp để dùng làm nền có 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 thêm tối đa một trong những mục đích sử dụng được đề xuất này.

Mức độ phù hợp về kích thước

smallFormat: Hình ảnh phù hợp với màn hình nhỏ hơn 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 hơn hoặc áp phích in.

Lưu ý: Nhìn chung, hầu hết hình ảnh đều phù hợp với định dạng lớn. Ngoại lệ là những hình ảnh có độ phân giải thấp, sẽ bị vỡ ảnh nếu được điều chỉnh tỷ lệ thành kích thước lớn hơn.

Một hình ảnh có thể sử dụng cả hai giá trị này.

Mức độ phù hợp của nền

forDarkBackground: Hình ảnh, thường là biểu trưng trong suốt, phù hợp để sử dụng trên nền tối.
forLightBackground: Hình ảnh, thường là biểu trưng trong suốt, 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ị về mức độ phù hợp của nền.

Lớp phủ

hasTitle: Tên của chương trình, hoặc tên của nhân vật hoặc diễn viên có trong hình ảnh. Hãy nhớ thêm thuộc tính inLanguage cho hình ảnh.
noTitle: Hình ảnh không có tiêu đề.
hasLogo: Hình ảnh có 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 có biểu trưng.
hasCopyright: Hình ảnh có thông báo bản quyền rõ ràng.
noCopyright: Hình ảnh không có thông báo bản quyền rõ ràng. 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ó lớp phủ mờ. Đó có thể là thanh ngang (hộp thư), thanh dọc (cột hộp thư) hoặc cả hai (hộp cửa sổ). Đôi khi, hình ảnh được lồng khung để vừa với một tỷ lệ khung hình. Nhìn chung, 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ó lớp phủ mờ.
transparentBackground: Nền của hình ảnh trong suốt. Thuộc tính này thường được dùng cho những hình ảnh chỉ có tiêu đề hoặc biểu trưng và không có gì khác.

Để hợp lệ, bạn chỉ được phép sử dụng một thuộc tính tiêu đề, một thuộc tính biểu trưng, một thuộc tính bản quyền và một thuộc tính mờ.

Vị trí của hình ảnh nổi bật

centered: Hình ảnh nổi bật nhất được đặt ở giữa hình ảnh.
rightCentered: Nhân vật chính được đặt ở phía bên phải của hình ảnh, để lại phía bên trái tương đối trống cho văn bản và lớp phủ giao diện người dùng.
leftCentered: Nhân vật chính được đặt ở phía bên trái của hình ảnh, để lại phía bên phải tương đối trống cho văn bản và lớp phủ giao diện người dùng.

Để hợp lệ, hãy thêm tối đa một trong các vị trí này.

Hình ảnh ví dụ kèm theo mục đích sử dụng dự kiến

Giao diện người dùng TV cho thấy hình nền có văn bản và lớp phủ giao diện người dùng.

Giao diện người dùng TV cho thấy băng chuyền có hình ảnh áp phích trên hình nền.

Giao diện người dùng trên thiết bị di động có hình ảnh áp phích và hình nền.`iconic`

Giao diện người dùng trên thiết bị di động có hình ảnh áp phích và hình `sceneStill`nền.

Hình ảnh mẫu và contentAttributes của hình ảnh

`contentAttributes: ["iconic", "poster", "centered", "hasTitle", "hasLogo", "noCopyright", "noMatte", "smallFormat", "largeFormat"]`

`contentAttributes: ["iconic", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]`

`contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]`

`contentAttributes: ["iconic", "background", "rightCentered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]`

`contentAttributes: ["iconic", "poster", "smallFormat", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"]`

`contentAttributes: ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"]`

`contentAttributes: ["castInCharacter", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered", "largeFormat"] character: {name: "Captain Pulsar"}`

`contentAttributes: ["logo", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered", "smallFormat", "largeFormat"]`

`contentAttributes: ["logo", "hasTitle", "hasLogo" "noCopyright", "noMatte", "centered", "transparentBackground", "forLightBackground", "forDarkBackground", "smallFormat", "largeFormat"]`

`contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "hasCopyright", "noMatte"]`

`contentAttributes: ["iconic", "poster", "centered", "noTitle", "noLogo", "hasCopyright", "hasMatte", "smallFormat", "largeFormat"]`

`contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "hasCopyright", "hasMatte"]`

Các loại hình ảnh mong muốn cho các sản phẩm của Google

Mỗi sản phẩm và nền tảng của Google đều yêu cầu loại hình ảnh và tỷ lệ khung hình riêng. Để đảm bảo nội dung hiển thị chính xác 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 trong bảng sau.

Tỷ lệ khung hình và contentAttributes	Độ phân giải tối thiểu (pixel)	Phim	Phim truyền hình	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, `iconic` `poster`	600x800
16:9, `iconic` `background` [ưu tiên] hoặc `sceneStill`	3840x2160
2:3, `iconic` `background` [ưu tiên] hoặc `sceneStill`	1000x1500
3:4, `iconic` `background` [ưu tiên] hoặc `sceneStill`	600x800
1:1, Hiện biểu trưng (`hasLogo`)	600x600
4:3, Biểu trưng kênh (`logo`)	800x600
1:1, Biểu trưng kênh (`logo`)	600x600
16:9, Biểu trưng kênh (`logo`)	3840x2160
9:5, `hasTitle` `logo` (với `transparentBackground` và cả `forLightBackground` và `forDarkBackground`)	1800x1000

Bạn cần tuân thủ các nguyên tắc sau khi gửi hình ảnh:

Hình ảnh phải ở định dạng JPEG, PNG hoặc WebP.
Sử dụng hình ảnh có độ phân giải cao nhất mà bạn có.
Kích thước tệp không được vượt quá 20 MB.
Bạn nên sử dụng centered hình ảnh. Một số sản phẩm cũng có thể sử dụng hình nền rightCentered và leftCentered, vì vậy, bạn có thể thêm các hình nền này nếu có.
Chúng tôi ưu tiên những hình ảnh phù hợp với cả smallFormat và largeFormat.
Bạn có thể thêm các kích thước hình ảnh khác ngoài những 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 các giá trị phổ biến được liệt kê trong bảng trước. Nếu không, bạn sẽ nhận được một thông báo nhắc nhở.

Hình ảnh ví dụ có giản đồ

Các ví dụ sau đây cho thấy 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 có hai nhân vậ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 của TVSeries bị hạn chế ở 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 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"]
      }
    ]
  }
}

Đại diện cho nhiều hình ảnh theo 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"]
        }
      ]
    }]
}

Đại diện cho hình ảnh bị hạn chế về 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"]
        }
      ]
    }]
}