Halaman ini diterjemahkan oleh Cloud Translation API.

Properti gambar

Bagian ini menjelaskan properti markup konten image untuk film dan TV acara TV. Markup ini memungkinkan penyedia menjelaskan jenis gambar, misalnya jika judul, latar belakang, atau gambar ikonik, dan penggunaan yang disarankan.

Tabel spesifikasi

Properti image dapat diberikan untuk Movie, TVSeries, TVSeason, atau TVEpisode jenis entitas. Tabel berikut menjelaskan properti yang tersedia untuk image. Perhatikan bahwa properti additionalProperty berisi nama properti khusus yang disebut contentAttributes, yang berisi array nilai yang mendeskripsikan 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 detail selengkapnya, baca `contentAttributes`
`character`	Orang	Wajib jika ada - Karakter fiksi yang terkait dengan gambar tersebut. Wajib diisi jika `contentAttribute` mencakup `castInCharacter`. Catatan: Anda dapat menggunakan `Person` ketik 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` `hasTitle`, properti ini wajib diisi.
`regionsAllowed`	Tempat	Direkomendasikan - Wilayah tempat gambar diizinkan. Jika tidak ditetapkan, maka dianggap bahwa gambar diizinkan di mana saja. Tentukan negara di Format ISO 3166.
`datePublished`	Date	Wajib jika berlaku - Tanggal setelah gambar tersedia, dalam ISO Format 8601 (termasuk zona waktu). Tanggal dapat ditetapkan di masa mendatang. Jika ada pembatasan berdasarkan waktu pada penggunaan gambar, properti ini diperlukan jika gambar tidak boleh ditampilkan sebelum tanggal yang ditentukan. Jika tidak batasan tersebut dapat dihilangkan. Diperlukan gambar yang sesuai diberikan di feed setidaknya 7 hari sebelum tanggal publikasinya. Hal ini akan meningkatkan peluang konten muncul di platform Google tepat waktu.
`expires`	Date	Wajib jika berlaku - Tanggal setelah gambar tidak lagi tersedia, dalam ISO Format 8601 (termasuk zona waktu). Jika konten selalu tersedia setelah dipublikasikan, Anda dapat menghilangkannya saat ini. Setiap pembaruan terhadap tanggal habis masa berlaku harus dibuat di feed setidaknya 7 hari sebelum tanggal habis masa berlaku. Hal ini akan meningkatkan peluang berhentinya konten agar muncul di platform Google pada tanggal habis masa berlaku.
`audience`	Penonton	Direkomendasikan - Audiens yang diinginkan atau diinginkan untuk ini gambar.
`audience.geographicArea`	AdministrativeArea	Direkomendasikan - Wilayah yang diinginkan atau diinginkan untuk gambar ini. Sebaliknya, gunakan `regionsAllowed` untuk menentukan pembatasan. Jika `audience.geographicArea` tidak ditentukan, maka aplikasi tersebut dianggap dimaksudkan untuk digunakan di mana saja. Tentukan negara di Format ISO 3166.
`copyrightHolder`	Organisasi 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, ["fitur, biografi"]
`name`	Teks	Direkomendasikan - Nama gambar.

contentAttributes

Properti contentAttributes dari image mendeskripsikan jenis dan mendefinisikan penggunaan yang disarankan. Kategori dalam daftar berikut mencakup Nilai contentAttributes yang harus disertakan penyedia dengan setiap ImageObject.

Jenis

iconic: Gambar ilustratif yang merepresentasikan acara. Seringkali bersifat artistik proses rendering.
sceneStill: Cuplikan gambar dari acara.
castInCharacter: Foto anggota pemeran seperti yang muncul dalam karakter. Jika Anda menggunakan nilai ini, sertakan juga character untuk mengidentifikasi karakter tertentu dalam gambar. Jika ada beberapa karakter, misalnya dalam pemeran film, sertakan beberapa properti character sebagai array.
logo: Gambar hanya berisi satu logo. Dapat berupa logo grafis atau logo judul. Sertakan overlay yang sesuai untuk menentukan overlay yang sesuai.

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

Penggunaan yang direkomendasikan

poster: Gambar poster untuk acara. Di UI komputer, ini dapat digunakan di korsel. Kolom ini mungkin berisi atau tidak berisi judul acara.
background: Gambar yang sesuai untuk digunakan sebagai latar belakang dengan teks atau UI overlay. Gambar ini tidak berisi teks.

Agar valid, sertakan maksimal satu penggunaan yang direkomendasikan berikut.

Kesesuaian ukuran

smallFormat: Gambar yang cocok untuk layar yang lebih kecil seperti perangkat seluler ponsel. Teks atau logo apa pun dalam gambar dapat dibaca di layar kecil.
largeFormat: Gambar yang cocok untuk layar besar atau poster cetak.

Catatan: Umumnya, sebagian besar gambar cocok untuk format berukuran besar. Pengecualian 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 dengan gambar. Pastikan untuk menyertakan properti inLanguage untuk gambar.
noTitle: Gambar tidak menyertakan judul.
hasLogo: Gambar berisi 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. Kebijakan Privasi umumnya tidak dapat menggunakan gambar tersebut tanpa modifikasi.
hasMatte: Gambar memiliki matte. Bidang ini bisa horizontal (tampilan lebar), vertikal (tampilan tinggi), atau keduanya (windowbox). Terkadang gambar diwarnai agar pas menjadi rasio aspek. Google biasanya tidak dapat menggunakan gambar tersebut tanpa modifikasi.
noMatte: Gambar tidak memiliki matte.
transparentBackground: Latar belakang gambar transparan. Ini adalah biasanya digunakan untuk gambar yang hanya berupa judul atau logo dan bukan yang lainnya.

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

Posisi tokoh dominan

centered: Gambar utama diposisikan di bagian tengah gambar.
rightCentered: Gambar utama diposisikan ke arah kanan gambar, sehingga sisi kiri relatif kosong untuk teks dan UI overlay.
leftCentered: Gambar utama diposisikan ke arah kiri gambar, sehingga sisi kanan relatif kosong untuk teks dan UI overlay.

Agar valid, sertakan maksimal salah satu posisi ini.

Contoh gambar dan tujuan penggunaannya

UI TV yang menampilkan gambar latar dengan teks dan overlay UI.

UI TV yang menampilkan carousel dengan gambar poster di latar belakang gambar.

UI seluler dengan gambar poster dan latar belakang `iconic` gambar.

UI seluler dengan gambar poster dan latar belakang `sceneStill` gambar.

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. Untuk memastikan bahwa konten ditampilkan dengan benar di semua produk Google, kami meminta agar penyedia 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
09.5, `hasTitle` `logo` (dengan `transparentBackground` dan keduanya `forLightBackground` dan `forDarkBackground`)	1800 x 1000

Panduan berikut berlaku saat Anda mengirim gambar:

Gambar harus dalam format JPEG, PNG, atau WebP.
Sertakan gambar dengan resolusi tertinggi yang Anda miliki.
Ukuran file tidak boleh lebih dari 20 MB.
centered gambar lebih disarankan. rightCentered dan leftCentered gambar latar juga dapat digunakan oleh beberapa produk, jadi Anda dapat menyertakannya jika Anda memilikinya.
Kami lebih memilih gambar yang berfungsi untuk smallFormat dan largeFormat.
Anda dapat menyertakan ukuran gambar selain ukuran yang tercantum dalam tabel sementara.
Pastikan bahwa rasio aspek setiap gambar sesuai dengan salah satu nilai umum yang tercantum di 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 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"]
        }
      ]
    }]
}

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