Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Properti gambar

Bagian ini menjelaskan properti markup konten image untuk film, acara TV, siaran TV live, dan acara olahraga. Markup ini memungkinkan penyedia mendeskripsikan jenis gambar, seperti apakah gambar tersebut adalah judul, latar belakang, atau gambar ikonis, dan penggunaan yang disarankan.

Tabel spesifikasi

Properti image dapat disediakan untuk jenis entity Movie, TVSeries, TVSeason, TVEpisode, SportsEvent, atau BroadcastEvent. Tabel berikut menjelaskan properti yang tersedia untuk properti image. Perhatikan bahwa properti additionalProperty menyertakan nama properti kustom yang disebut contentAttributes, yang berisi array nilai yang menjelaskan jenis gambar dan tujuan penggunaannya.

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 tujuan penggunaannya. Untuk mengetahui detail selengkapnya, baca `contentAttributes`.
`character`	Orang	Wajib jika ada - Karakter fiktif yang terkait dengan gambar. Ini diperlukan jika `contentAttribute` menyertakan `castInCharacter`. Catatan: Anda dapat menggunakan jenis `Person` di sini meskipun karakternya bukan manusia.
`inLanguage`	Teks	Wajib jika ada - Bahasa teks yang digunakan dalam gambar. Gunakan salah satu kode bahasa dari standar IETF BCP 47. Jika gambar menyertakan `contentAttribute` dari `hasTitle`, properti ini wajib ada.
`regionsAllowed`	Tempat	Direkomendasikan - Wilayah tempat gambar diizinkan. Jika tidak ditentukan, gambar akan dianggap diizinkan di mana saja. Tentukan negara dalam format ISO 3166.
`datePublished`	Tanggal	Wajib jika ada - Tanggal setelah gambar tersedia, 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 batasan tersebut, batasan ini dapat dihilangkan. Gambar yang sesuai harus disediakan dalam feed setidaknya 7 hari sebelum datePublished. Tindakan ini akan meningkatkan peluang konten muncul di platform Google tepat waktu.
`expires`	Tanggal	Wajib jika berlaku - Tanggal setelah gambar tidak lagi tersedia, dalam format ISO 8601 (termasuk zona waktu). Jika konten selalu tersedia setelah dipublikasikan, Anda dapat menghilangkan properti ini. Setiap 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 - Target atau audiens yang diinginkan untuk gambar ini.
`audience.geographicArea`	AdministrativeArea	Direkomendasikan - Wilayah yang dimaksudkan atau diinginkan untuk gambar ini. Sebaliknya, gunakan `regionsAllowed` untuk menentukan batasan ketat. Jika `audience.geographicArea` tidak ditentukan, maka diasumsikan bahwa video tersebut dimaksudkan untuk digunakan di semua tempat. 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.
`width`	Bilangan Bulat	Opsional - Lebar bilangan bulat positif gambar dalam piksel (misalnya, `1920`). Jangan sertakan string unit seperti `"px"`.
`height`	Bilangan Bulat	Opsional - Tinggi bilangan bulat positif gambar dalam piksel (misalnya, `1080`). Jangan sertakan string unit seperti `"px"`.

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.

Jenis

iconic: Gambar ilustrasi yang menggambarkan acara. Sering kali berupa 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 ansambel pemeran, sertakan beberapa properti character sebagai array.
logo: Gambar hanya berisi logo. Logo ini dapat berupa logo grafis atau logo judul. Sertakan overlay yang sesuai untuk menentukan yang mana.

Agar valid, gunakan satu dan hanya satu dari jenis ini.

Penggunaan yang direkomendasikan

poster: Gambar poster untuk acara. Di UI komputer, elemen ini dapat digunakan dalam carousel. Gambar 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. 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. Pengecualiannya adalah gambar dengan resolusi rendah, yang akan terlihat pecah 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 dalam gambar. Pastikan Anda menyertakan properti inLanguage untuk gambar.
noTitle: Gambar tidak menyertakan judul.
hasLogo: Gambar menyertakan logo film atau acara, 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. Format ini dapat berupa horizontal (letterbox), vertikal (pillarbox), atau keduanya (windowbox). Terkadang gambar diberi bingkai agar sesuai dengan rasio aspek. Google umumnya tidak dapat menggunakan gambar tersebut tanpa modifikasi.
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 tokoh dominan

centered: Objek utama diposisikan di tengah gambar.
rightCentered: Tokoh utama diposisikan di sisi kanan gambar, sehingga sisi kiri relatif kosong untuk teks dan overlay UI.
leftCentered: Tokoh utama diposisikan di 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 overlay teks dan UI.

UI TV yang menampilkan carousel dengan gambar poster di 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 channel (`logo`)	800x600
1:1, Logo channel (`logo`)	600x600
16:9, Logo channel (`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 dengan resolusi tertinggi yang Anda miliki.
Ukuran file tidak boleh melebihi 20 MB.
Gambar centered lebih disukai. Gambar latar belakang rightCentered dan leftCentered juga dapat digunakan oleh beberapa produk, sehingga Anda dapat menyertakannya jika memilikinya.
Kami lebih menyukai gambar yang sesuai 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 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"]
      }
    ]
  }
}

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