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 |
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).
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).
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 properticharacter
untuk mengidentifikasi karakter tertentu dalam gambar. Jika ada beberapa karakter, seperti dalam ansambel transmisi, sertakan beberapa properticharacter
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.
Penggunaan yang direkomendasikan
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 propertiinLanguage
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
Contoh gambar dan contentAttributes
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, |
600x800 | |||||
16:9, |
3840x2160 | |||||
2:3, |
1000x1500 | |||||
3:4, |
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, |
1800 x 1000 |
Panduan berikut berlaku saat Anda mengirim gambar:
- Gambar harus dalam format JPEG, PNG, atau WebP.
- Sertakan gambar beresolusi tertinggi yang Anda miliki.
- Ukuran file tidak boleh lebih dari 20 MB.
centered
gambar lebih disarankan. Gambar latarrightCentered
danleftCentered
juga dapat digunakan oleh beberapa produk, sehingga Anda dapat menyertakannya jika memilikinya.- Kami lebih menyukai gambar yang berfungsi untuk
smallFormat
danlargeFormat
. - Anda dapat menyertakan ukuran gambar selain yang tercantum dalam tabel sebelumnya.
- 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"]
}
]
}]
}