Properti gambar

Bagian ini menjelaskan properti markup konten image untuk film dan acara TV. Markup ini memungkinkan penyedia menjelaskan jenis gambar, seperti apakah itu judul, gambar latar, atau gambar ikonis, dan penggunaannya yang disarankan.

Tabel spesifikasi

Properti image dapat diberikan untuk jenis entitas Movie, TVSeries, TVSeason, atau TVEpisode. Tabel berikut menjelaskan properti yang tersedia untuk properti image. Perhatikan bahwa properti additionalProperty menyertakan nama properti kustom yang disebut contentAttributes, yang menyimpan array nilai yang mendeskripsikan jenis gambar dan tujuan penggunaannya.

Properti Jenis yang Diharapkan Deskripsi
@context Teks Wajib - Selalu tetapkan ke "http://schema.org".
@type Teks Wajib - Selalu tetapkan ke ImageObject.
contentUrl URL Wajib - URL gambar.
additionalProperty PropertyValue Wajib - Menentukan properti contentAttributes, yang menjelaskan jenis gambar dan tujuan penggunaannya. Untuk detail selengkapnya, baca contentAttributes.
character Person

Wajib jika berlaku - Karakter fiksi yang terkait dengan gambar. Ini diperlukan jika contentAttribute menyertakan castInCharacter.
inLanguage Teks Wajib jika berlaku - Bahasa teks yang digunakan dalam gambar. Gunakan salah satu kode bahasa dari standar IETF BCP 47. Jika gambar berisi contentAttribute dari hasTitle, properti ini bersifat wajib.
regionsAllowed Tempat Direkomendasikan - Wilayah tempat gambar diizinkan. Jika tidak ditentukan, maka diasumsikan bahwa gambar diizinkan di mana saja. Tentukan negara dalam format ISO 3166.
datePublished Date

Wajib jika berlaku - Tanggal setelah gambar tersedia, dalam format ISO 8601 (termasuk zona waktu).

  • Tanggal dapat disetel di masa mendatang.

Jika ada batasan berbasis waktu pada penggunaan gambar, properti ini diwajibkan jika gambar tidak boleh ditampilkan sebelum tanggal yang ditentukan. Jika tidak ada, batasan tersebut dapat dihilangkan. Gambar yang terkait harus diberikan dalam feed setidaknya 7 hari sebelum tanggal publikasi. Hal ini akan meningkatkan peluang kemunculan konten di platform Google tepat waktu.

expires Date

Wajib jika berlaku - Tanggal setelah gambar tidak tersedia lagi, dalam format ISO 8601 (termasuk zona waktu).

  • Jika konten selalu tersedia setelah dipublikasikan, Anda dapat menghilangkan properti ini.

Pembaruan pada tanggal habis masa berlaku harus dilakukan di feed setidaknya 7 hari sebelum tanggal habis masa berlaku. Hal ini akan meningkatkan peluang kemunculan konten berhenti di platform Google pada tanggal habis masa berlaku.

audience Audiens Direkomendasikan - Audiens yang diinginkan atau diinginkan untuk gambar ini.
audience.geographicArea Wilayah Administratif Direkomendasikan - Wilayah yang diinginkan atau diinginkan untuk gambar ini. Sebaliknya, gunakan regionsAllowed untuk menentukan pembatasan ketat. Jika audience.geographicArea tidak ditentukan, maka ekstensi ini diasumsikan ditujukan untuk digunakan di mana saja. Tentukan negara dalam format ISO 3166.
copyrightHolder Organisasi atau Orang Direkomendasikan - Pihak yang memegang hak cipta atas gambar tersebut.
keywords Teks Direkomendasikan - Kata kunci atau tag yang digunakan untuk mendeskripsikan gambar ini. Beberapa keywords dapat disediakan menggunakan array. Misalnya, ["feature, biography"]
name Teks Direkomendasikan - Nama gambar.

contentAttributes

Properti contentAttributes dari image menjelaskan jenis gambar dan menentukan penggunaan yang disarankan. Kategori dalam daftar berikut mencakup nilai contentAttributes yang harus disertakan penyedia dengan setiap ImageObject.

Type

  • iconic: Gambar ilustratif yang menggambarkan acara. Sering kali rendering yang artistik.
  • sceneStill: Nukilan gambar dari acara.
  • castInCharacter: Foto anggota pemeran saat mereka muncul dalam karakter. Jika Anda menggunakan nilai ini, sertakan juga properti character untuk mengidentifikasi karakter tertentu dalam gambar. Jika ada beberapa karakter, seperti dalam ansambel transmisi, sertakan beberapa properti character sebagai array.
  • logo: Gambar hanya berisi logo. Hal ini dapat berupa logo grafis atau logo judul. Sertakan overlay yang sesuai untuk menentukan mana.

Agar valid, gunakan salah satu dan hanya salah satu jenis tersebut.

  • poster: Gambar poster untuk acara. Di UI komputer, ini dapat digunakan di carousel. Judul ini dapat berisi judul acara atau mungkin tidak.
  • background: Gambar yang cocok digunakan sebagai latar belakang dengan overlay teks atau UI. Gambar ini tidak berisi teks.

Agar valid, sertakan maksimal satu dari penggunaan yang direkomendasikan ini.

Kesesuaian ukuran

  • smallFormat: Gambar yang cocok untuk layar yang lebih kecil seperti ponsel. Teks atau logo apa pun dalam gambar dapat dibaca di layar kecil.

  • largeFormat: Gambar yang cocok untuk layar yang lebih besar atau poster yang dicetak.

Gambar dapat menggunakan kedua nilai ini.

Kesesuaian latar belakang

  • forDarkBackground: Gambar, biasanya logo transparan, yang cocok untuk digunakan pada latar belakang gelap.
  • forLightBackground: Gambar, biasanya logo transparan, yang cocok untuk digunakan pada latar belakang terang.

Agar valid, gunakan maksimal satu nilai kesesuaian latar belakang.

Overlay

  • hasTitle: Judul acara, atau nama karakter atau aktor yang disertakan dengan gambar. Pastikan untuk menyertakan properti inLanguage untuk gambar.
  • noTitle: Gambar tidak berisi judul.
  • hasLogo: Gambar mencakup logo film atau acara TV, pemilik konten, atau distributor.
  • noLogo: Gambar tidak menyertakan logo.
  • hasCopyright: Gambar menyertakan pemberitahuan hak cipta yang terlihat.
  • noCopyright: Gambar tidak menyertakan pemberitahuan hak cipta yang terlihat. Google biasanya tidak dapat menggunakan gambar tersebut tanpa modifikasi.
  • hasMatte: Gambar memiliki warna matte. Hal ini dapat bersifat horizontal (tampilan lebar), vertikal (pilar), atau keduanya (kotak jendela). Terkadang gambar dimatang agar sesuai dengan rasio aspek. Google umumnya tidak dapat menggunakan gambar tersebut tanpa modifikasi.
  • noMatte: Gambar tidak memiliki warna matte.
  • transparentBackground: Latar belakang gambar transparan. Hal ini biasanya digunakan untuk gambar yang hanya merupakan judul atau logo, bukan yang lain.

Agar valid, hanya satu judul, satu logo, satu hak cipta, dan satu atribut matte yang diizinkan.

Posisi tokoh utama

  • centered: Angka dominan diposisikan di tengah gambar.
  • rightCentered: Gambar dominan diposisikan ke sisi kanan gambar, sehingga sisi kiri relatif kosong untuk overlay teks dan UI.
  • leftCentered: Gambar dominan diposisikan ke sisi kiri gambar, sehingga sisi kanan relatif kosong untuk overlay teks dan UI.

Agar valid, sertakan maksimal satu posisi ini.

Contoh gambar dengan tujuan penggunaannya

UI TV yang menampilkan gambar latar dengan teks dan overlay UI.
UI TV yang menampilkan carousel dengan gambar poster pada gambar latar belakang.
UI seluler dengan gambar poster dan gambar iconic latar belakang.
UI seluler dengan gambar poster dan gambar sceneStill latar belakang.

Contoh gambar dan contentAttributes

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

Jenis gambar yang diinginkan untuk produk Google

Produk dan platform Google yang berbeda memerlukan jenis gambar dan rasio lebar tinggi yang berbeda. Untuk memastikan bahwa konten ditampilkan dengan benar di semua produk Google, kami meminta penyedia untuk menyediakan semua jenis gambar dari tabel berikut.

Rasio lebar tinggi dan contentAttributes Resolusi minimum (piksel) Movie (Film) Serial Televisi Season TV Episode TV Layanan Siaran
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 [lebih disukai] atau sceneStill

 3840x2160

2:3, iconic background [lebih disukai] atau sceneStill

 1000x1500

3:4, iconic background [lebih disukai] atau sceneStill

 600x800
1:1, Tampilkan logo (hasLogo) 600x600
4:3, Logo channel (logo) 800x600
1:1, logo Channel (logo) 600x600
16:9, Logo channel (logo) 3840x2160

9.5, hasTitle logo (dengan transparentBackground serta forLightBackground dan forDarkBackground)

 1800 x 1000

Panduan berikut berlaku saat Anda mengirim gambar:

  1. Gambar harus dalam format JPEG, PNG, atau WebP.
  2. Sertakan gambar beresolusi tertinggi yang Anda miliki.
  3. Ukuran file tidak boleh lebih dari 20 MB.
  4. centered gambar lebih disarankan. Gambar latar rightCentered dan leftCentered juga dapat digunakan oleh beberapa produk, sehingga Anda dapat menyertakannya jika memilikinya.
  5. Kami lebih menyukai gambar yang berfungsi untuk smallFormat dan largeFormat.
  6. Anda dapat menyertakan ukuran gambar selain yang tercantum dalam tabel sebelumnya.
  7. Pastikan setiap rasio lebar tinggi gambar adalah salah satu nilai umum yang tercantum dalam tabel sebelumnya. Jika tidak, peringatan akan diberikan.

Contoh gambar dengan skema

Contoh berikut menunjukkan cara memformat skema untuk gambar yang terkait dengan film atau acara TV.

Gambar latar film dengan dua karakter

{
  "@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"]
      }
    ]
  }
}

Gambar latar TVSeries dibatasi di dua wilayah

{
  "@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"]
      }
    ]
  }
}

Gambar poster film yang ditujukan untuk dua wilayah

{
  "@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"]
      }
    ]
  }
}

Poster film format besar dengan bahasa Korea dan Inggris

{
  "@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"]
      }
    ]
  }
}

Mewakili beberapa gambar per wilayah

{
  "@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"]
        }
      ]
    }]
}

Menampilkan gambar yang dibatasi waktu

{
  "@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"]
        }
      ]
    }]
}