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 các chương trì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ư tiêu đề, nền hoặc hình ảnh biểu tượng và đề xuất sử dụng.

Bảng thông số kỹ thuật

Bạn có thể cung cấp thuộc tính image cho Movie, TVSeries! TVSeason, hoặc TVEpisode các loại thực thể. Bảng sau đây mô tả các thuộc tính hiện có 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. chứa một mảng 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, đọc contentAttributes.
character Person (Người)

Bắt buộc nếu có – Một nhân vật hư cấu liên quan đến hình ảnh. Đây là yêu cầu 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 được dùng trong hình ảnh. Sử dụng một trong các mã ngôn ngữ từ Tiêu chuẩn BCP 47 của IETF. Nếu hình ảnh bao gồm contentAttribute của hasTitle, thuộc tính này là bắt buộc.
regionsAllowed Địa điểm Đề xuất – Các khu vực cho phép hình ảnh xuất hiện. Nếu không được chỉ định, thì giả định rằng hình ảnh được phép ở mọi nơi. Nêu rõ các quốc gia tại Đị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, theo ISO Định dạng 8601 (bao gồm cả múi giờ).

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

Nếu có giới hạn về việc sử dụng hình ảnh theo thời gian, 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ó có thể bỏ qua hạn chế. Bắt buộc phải có hình ảnh tương ứng được cung cấp trong nguồn cấp dữ liệu ít nhất 7 ngày trước ngày Phát hành. Thao tác này sẽ nâng cao cơ hội nội dung xuất hiện đúng thời điểm 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 truy cập được nữa, trong ISO Định dạng 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 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ẽ giúp tăng khả năng nội dung bị ngừng cung cấp để 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 Được đề xuất – Đối tượng mục tiêu hoặc ưu tiên của nội dung này hình ảnh.
audience.geographicArea AdministrativeArea Đề xuất – Khu vực mong muố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ứng hạn chế. Nếu bạn không chỉ định audience.geographicArea, thì nó được giả định là dùng ở mọi nơi. Chỉ định các quốc gia ở Định dạng ISO 3166.
copyrightHolder Tổ chức hoặc Person Được đề xuất – Bên giữ bản quyền đối với hình ảnh.
keywords Văn bản Đề xuất - Từ khóa hoặc thẻ được sử dụng để mô tả hình ảnh này. Bạn có thể cung cấp nhiều keywords bằng cách dùng một mảng. Ví dụ: ["đặc điểm, tiểu sử"]
name Văn bản Nên dùng – 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ác trường hợp sử dụng đề xuất. Các danh mục trong danh sách sau bao gồm Giá trị contentAttributes mà nhà cung cấp phải đưa vào trong mỗi ImageObject.

Loại

  • iconic: Hình ảnh minh hoạ minh hoạ chương trình. Thường là tác phẩm nghệ thuật kết xuất hình ảnh.
  • sceneStill: Một hình ảnh được trích từ chương trình.
  • castInCharacter: Hình ảnh của một 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, cũng như bao gồ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 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 một biểu trưng. Đây có thể là biểu trưng dạng đồ hoạ hoặc một biểu trưng tiêu đề. Thê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 này.

  • 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, bạn có thể sử dụng các tham số này trong băng chuyền. Các tiêu đề 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ó văn bản hoặc giao diện người dùng lớp phủ. 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 trường hợp 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 các màn hình nhỏ hơn như thiết bị di động điện thoại. Mọi văn bản hoặc biểu trưng trong hình ảnh đều có thể đọ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.

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

Mức độ phù hợp với nền tảng

  • 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 khi ở nền sau.

Lớp phủ

  • hasTitle: Tên chương trình hoặc tên của nhân vật hoặc diễn viên có kèm theo hình ảnh. Hãy nhớ cung cấp thuộc tính inLanguage cho thuộc tính 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 có biểu trưng.
  • hasCopyright: Hình ảnh có chứa 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. Điều khoản 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à định dạng ngang (hộp thư), dọc (cột hòm thư) hoặc cả hai (hộp cửa sổ). Đôi khi hình ảnh được làm mờ để vừa thành một tỷ lệ khung hình. Google thường không thể sử dụng những hình ảnh như vậy nếu không có nội dung sửa đổi.
  • noMatte: Hình ảnh không có hiệu ứng nhám.
  • transparentBackground: Nền của hình ảnh trong suốt. Đây là thường được sử dụng cho hình ảnh chỉ là tiêu đề hoặc biểu trưng và không có gì khác.

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

Vị trí của người chiếm ưu thế

  • centered: Hình nổi bật được đặt ở giữa hình ảnh.
  • rightCentered: Con số chiếm ưu thế được đặt về phía bên phải của hình ảnh, phần này để phần bên trái tương đối trống cho văn bản và giao diện người dùng lớp phủ.
  • leftCentered: Con số chiếm ưu thế được đặt về phía bên trái của hình ảnh để phần bên phải tương đối trống cho văn bản và giao diện người dùng lớp phủ.

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

Hình ảnh ví dụ về 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 TV hiển thị băng chuyền cùng hình ảnh áp phích trên nền hình ảnh.
Giao diện người dùng trên thiết bị di động có hình ảnh áp phích và nền iconic hình ảnh.
Giao diện người dùng trên thiết bị di động có hình ảnh áp phích và nền sceneStill hình ảnh.

Hình ảnh ví dụ 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à nền tảng khác nhau của Google yêu cầu các chỉ số khác nhau loại hình ảnh và tỷ lệ khung hình. Để đảm bảo rằng 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 phải cung cấp tất 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 của kênh (logo) 800x600
1:1, Biểu trưng của kênh (logo) 600x600
16:9, Biểu trưng của kênh (logo) 3840x2160

9:5, hasTitle logo (với transparentBackground và cả hai forLightBackground và forDarkBackground)

 1800x1000

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

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

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

Các ví dụ sau đây minh hoạ cách định dạng giản đồ cho hình ảnh được 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 TV Series 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"]
      }
    ]
  }
}

Thể hiện nhiều hình ảnh ở 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"]
        }
      ]
    }]
}

Trình bày hình ảnh trong 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"]
        }
      ]
    }]
}