Thuộc tính hình ảnh

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 contentAttribute bao gồm castInCharacter.

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ờ).

  • Bạn có thể đặt ngày trong tương lai.

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ờ).

  • Nếu nội dung đó luôn xuất hiện sau khi xuất bản, bạn có thể bỏ qua thuộc tính này.

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ính character để 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ính character 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.

  • 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ính inLanguage 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

Giao diện người dùng trên TV hiển thị hình nền với lớp phủ văn bản và 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 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 trên 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 trên nền.

Ví dụ về hình ảnh và contentAttributes của chúng

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"]

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, 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
Biểu trưng kênh 1:1 (logo) 600x600
16:9, Biểu trưng kênh (logo) 3840x2160

9:5, hasTitle logo (với transparentBackground và cả forLightBackgroundforDarkBackground)

1800x1000

Các nguyên tắc sau được áp dụng khi bạn gửi hình ảnh:

  1. Hình ảnh phải ở định dạng JPEG, PNG hoặc WebP.
  2. Bao gồm các hình ảnh có độ phân giải cao nhất.
  3. Kích thước tệp không được vượt quá 20 MB.
  4. Bạn nên chọn centered hình ảnh. Hình nền rightCenteredleftCentered 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ó.
  5. Chúng tôi muốn các hình ảnh phù hợp với cả smallFormatlargeFormat.
  6. 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 đó.
  7. 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"]
        }
      ]
    }]
}