Trang này được dịch bởi Cloud Translation API.

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 và chương trình truyền hình. 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ư liệu đó có phải là tiêu đề, hình nền hay hình ảnh biểu tượng và cách sử dụng được đề xuất hay không.

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 tuỳ chỉnh có tên là contentAttributes. Thuộc tính này chứa một mảng 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	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 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. Điều này là bắt buộc nếu `contentAttribute` bao gồm `castInCharacter`. Lưu ý: Bạn có thể sử dụng loại `Person` ở đâ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 bao gồm `contentAttribute` của `hasTitle`, thì bạn phải sử dụng thuộc tính này.
`regionsAllowed`	Địa điểm	Đề xuất – 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 sẽ được cho phép xuất hiện ở mọi nơi. 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à 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ó các quy định hạn chế về thời gian sử dụng hình ảnh, thì thuộc tính này là bắt buộc nếu hình ảnh không được hiển thị 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 phát hành. Việc này sẽ tăng khả năng nội dung xuất hiện đúng hạn 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 sẽ không còn được cung cấp, ở đị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 là 7 ngày trước ngày hết hạn. Việc này sẽ làm 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	Đề xuất – Đối tượng mục tiêu hoặc đối tượng ưu tiên cho hình ảnh này.
`audience.geographicArea`	AdministrativeArea	Đề xuất – Các 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 hạn chế cứng. Nếu bạn không chỉ định `audience.geographicArea`, thì thuộc tính này sẽ được giả định là dùng được ở mọi nơi. Chỉ định các quốc gia ở định dạng ISO 3166.
`copyrightHolder`	Tổ chức hoặc Người	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	Đề xuất – Tên của hình ảnh.

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 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 thuộc tính character để xác định ký tự cụ thể trong hình ảnh. Nếu có nhiều nhân vật, chẳng hạn như trong một nhóm diễn viên, hãy đưa nhiều thuộc tính character vào 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 lớp phủ nào.

Để 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 được đề xuất

poster: Hình ảnh áp phích của chương trình. Trong giao diện người dùng trên máy tính, bạn có thể sử dụng các thành phần này trong băng chuyền. Các thẻ này có thể chứa hoặc không chứa tên chương trình.
background: Hình ảnh phù hợp để sử dụng làm nền có văn bản hoặc lớp phủ 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ệ, bạn chỉ được đưa vào tối đa một trong những 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 đọc đượ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. Trường hợp 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 theo tỷ lệ 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ị mức độ phù hợp của nền.

Lớp phủ

hasTitle: Tên chương trình hoặc tên nhân vật hoặc diễn viên đi kèm với 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: Ả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 mà không sửa đổi.
hasMatte: Hình ảnh có hiệu ứng mờ. Đây có thể là dạng ngang (hộp thư), dọc (hộp trụ) hoặc cả hai (hộp cửa sổ). Đôi khi, hình ảnh được phủ mờ để vừa với tỷ lệ khung hình. Nhìn chung, Google không thể sử dụng những hình ảnh như vậy mà không sửa đổi.
noMatte: Hình ảnh không có hiệu ứng mờ.
transparentBackground: Nền của hình ảnh là 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 mà không có gì khác.

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

Vị trí của hình ảnh chính

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

Để hợp lệ, bạn chỉ được thêm tối đa một trong những vị trí này.

Ví dụ về hình ảnh có mục đích sử dụng

Giao diện người dùng TV hiển thị 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 trên TV hiển thị 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 ảnh `iconic` 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 ả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

Các sản phẩm và nền tảng của Google có yêu cầu khác nhau về loại hình ảnh và tỷ lệ khung hình. Để đảm bảo nội dung hiển thị chính xác trên tất cả cá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 thị 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.
Đưa vào nhữ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 dùng hình ảnh centered. 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ể đưa các hình nền này vào nếu có.
Chúng tôi ưu tiên những hình ảnh hoạt động được cho cả smallFormat và largeFormat.
Bạn có thể thêm các kích thước hình ảnh 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, 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 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"]
      }
    ]
  }
}

Biểu thị nhiều hình ảnh cho 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 bị 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"]
        }
      ]
    }]
}