Halaman ini diterjemahkan oleh Cloud Translation API.

Properti gambar

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

Tabel spesifikasi

Properti image dapat diberikan untuk jenis entity 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 penggunaannya yang dimaksudkan.

Properti	Jenis yang Diharapkan	Deskripsi
`@context`	Teks	Wajib - Selalu ditetapkan ke `"http://schema.org"`.
`@type`	Teks	Wajib - Selalu ditetapkan ke `ImageObject`.
`contentUrl`	URL	Wajib - URL gambar.
`additionalProperty`	PropertyValue	Wajib - Menentukan properti `contentAttributes`, yang menjelaskan jenis gambar dan penggunaannya yang dimaksudkan. Untuk detail selengkapnya, baca `contentAttributes`.
`character`	Orang	Wajib jika ada - Karakter fiksi yang terkait dengan gambar. Hal ini diperlukan jika `contentAttribute` menyertakan `castInCharacter`. Catatan: Anda dapat menggunakan jenis `Person` di sini meskipun karakternya bukan manusia.
`inLanguage`	Teks	Wajib jika berlaku - Bahasa teks yang digunakan dalam gambar. Gunakan salah satu kode bahasa dari standar IETF BCP 47. Jika gambar menyertakan `contentAttribute` dari `hasTitle`, properti ini diperlukan.
`regionsAllowed`	Tempat	Direkomendasikan - Wilayah tempat gambar diizinkan. Jika tidak ditentukan, gambar dianggap diizinkan di mana saja. Tentukan negara dalam format ISO 3166.
`datePublished`	Date	Wajib jika berlaku - Tanggal batas tersedianya gambar, dalam format ISO 8601 (termasuk zona waktu). Tanggal dapat ditetapkan di masa mendatang. Jika ada batasan berbasis waktu pada penggunaan gambar, properti ini diperlukan jika gambar tidak boleh ditampilkan sebelum tanggal yang ditentukan. Jika tidak ada pembatasan tersebut, batasan dapat dihilangkan. Gambar yang sesuai harus diberikan dalam feed setidaknya 7 hari sebelum tanggalPublikasinya. Hal ini akan meningkatkan peluang konten muncul di platform Google tepat waktu.
`expires`	Date	Wajib jika berlaku - Tanggal batas tersedianya gambar, 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. Tindakan ini akan meningkatkan peluang konten berhenti muncul di platform Google pada tanggal habis masa berlaku.
`audience`	Penonton	Direkomendasikan - Audiens yang diinginkan atau disukai untuk gambar ini.
`audience.geographicArea`	AdministrativeArea	Direkomendasikan - Wilayah yang diinginkan atau disukai untuk gambar ini. Sebaliknya, gunakan `regionsAllowed` untuk menentukan pembatasan ketat. Jika `audience.geographicArea` tidak ditentukan, maka `audience.geographicArea` diasumsikan dimaksudkan untuk digunakan di mana saja. Tentukan negara dalam format ISO 3166.
`copyrightHolder`	Organization atau Person	Direkomendasikan - Pihak yang memegang hak cipta atas gambar.
`keywords`	Teks	Direkomendasikan - Kata kunci atau tag yang digunakan untuk mendeskripsikan gambar ini. Beberapa `keywords` dapat diberikan 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 oleh penyedia dengan setiap ImageObject.

Jenis

iconic: Gambar ilustrasi yang menunjukkan acara. Sering kali merupakan rendering artistik.
sceneStill: Cuplikan gambar dari acara.
castInCharacter: Foto anggota pemeran saat mereka tampil sebagai karakter. Jika Anda menggunakan nilai ini, sertakan juga properti character untuk mengidentifikasi karakter tertentu dalam gambar. Jika ada beberapa karakter, seperti dalam ensembel pemeran, sertakan beberapa properti character sebagai array.
logo: Gambar hanya berisi logo. Ini dapat berupa logo grafis atau logo judul. Sertakan overlay yang sesuai untuk menentukannya.

Agar valid, gunakan satu dan hanya satu jenis ini.

Penggunaan yang direkomendasikan

poster: Gambar poster untuk acara. Di UI komputer, ini dapat digunakan di carousel. Judul ini mungkin berisi atau tidak berisi judul acara.
background: Gambar yang cocok untuk 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 seluler. Teks atau logo apa pun dalam gambar dapat dibaca di layar kecil.
largeFormat: Gambar yang cocok untuk layar yang lebih besar atau poster cetak.

Catatan: Umumnya, sebagian besar gambar cocok untuk format besar. Pengecualian adalah gambar dengan resolusi rendah, yang akan terlihat pixelated jika diskalakan ke ukuran yang lebih besar.

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 menyertakan judul.
hasLogo: Gambar menyertakan 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 umumnya tidak dapat menggunakan gambar tersebut tanpa modifikasi.
hasMatte: Gambar memiliki matte. Orientasi ini dapat berupa horizontal (letterbox), vertikal (pillarbox), atau keduanya (windowbox). Terkadang gambar dibingkai agar sesuai dengan rasio aspek. Google umumnya tidak dapat menggunakan gambar tersebut tanpa perubahan.
noMatte: Gambar tidak memiliki matte.
transparentBackground: Latar belakang gambar transparan. Hal ini biasanya digunakan untuk gambar yang hanya berupa judul atau logo dan tidak ada yang lain.

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

Posisi figur utama

centered: Gambar yang dominan diposisikan di tengah gambar.
rightCentered: Gambar utama diposisikan ke sisi kanan gambar, sehingga sisi kiri relatif kosong untuk overlay teks dan UI.
leftCentered: Gambar utama 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 penggunaan yang dimaksudkan

UI TV yang menampilkan gambar latar belakang 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-nya

`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 aspek yang berbeda. Untuk memastikan konten ditampilkan dengan benar di semua produk Google, kami meminta penyedia untuk menyediakan semua jenis gambar dari tabel berikut.

Rasio aspek dan contentAttributes	Resolusi minimum (piksel)	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 saluran (`logo`)	800x600
1:1, Logo saluran (`logo`)	600x600
16:9, Logo saluran (`logo`)	3840x2160
9:5, `hasTitle` `logo` (dengan `transparentBackground` dan `forLightBackground` serta `forDarkBackground`)	1800 x 1000

Panduan berikut berlaku saat Anda mengirimkan gambar:

Gambar harus dalam format JPEG, PNG, atau WebP.
Sertakan gambar beresolusi tertinggi yang Anda miliki.
Ukuran file tidak boleh melebihi 20 MB.
Gambar centered lebih disukai. Gambar latar rightCentered dan leftCentered juga dapat digunakan oleh beberapa produk, sehingga Anda dapat menyertakannya jika memilikinya.
Sebaiknya gunakan gambar yang berfungsi untuk smallFormat dan largeFormat.
Anda dapat menyertakan ukuran gambar selain yang tercantum dalam tabel sebelumnya.
Pastikan rasio aspek setiap 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 untuk 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 berformat 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 region

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

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