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 |
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).
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).
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 jugacharacter
untuk mengidentifikasi karakter tertentu dalam gambar. Jika ada beberapa karakter, misalnya dalam pemeran film, sertakan beberapa properticharacter
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.
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 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
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-1.png?authuser=0000&hl=id)
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-2.png?authuser=0000&hl=id)
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-3.png?authuser=0000&hl=id)
iconic
gambar.![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-4.png?authuser=0000&hl=id)
sceneStill
gambar.Contoh gambar dan contentAttributes-nya
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-5.png?authuser=0000&hl=id)
contentAttributes: ["iconic", "poster", "centered",
"hasTitle", "hasLogo", "noCopyright", "noMatte", "smallFormat",
"largeFormat"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-6.png?authuser=0000&hl=id)
contentAttributes: ["iconic", "background", "centered",
"smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright",
"noMatte"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-7.png?authuser=0000&hl=id)
contentAttributes: ["sceneStill", "background",
"centered", "smallFormat", "largeFormat", "noTitle", "noLogo",
"noCopyright", "noMatte"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-8.png?authuser=0000&hl=id)
contentAttributes: ["iconic", "background",
"rightCentered", "smallFormat", "largeFormat", "noTitle", "noLogo",
"noCopyright", "noMatte"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-9.png?authuser=0000&hl=id)
contentAttributes: ["iconic", "poster", "smallFormat",
"largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte",
"centered"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-10.png?authuser=0000&hl=id)
contentAttributes: ["iconic", "poster", "largeFormat",
"hasTitle", "hasLogo", "noCopyright", "noMatte",
"centered"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-11.png?authuser=0000&hl=id)
contentAttributes: ["castInCharacter", "hasTitle",
"hasLogo", "noCopyright", "noMatte", "centered", "largeFormat"] character:
{name: "Captain Pulsar"}
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-12.png?authuser=0000&hl=id)
contentAttributes: ["logo", "hasTitle", "hasLogo",
"noCopyright", "noMatte", "centered", "smallFormat",
"largeFormat"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-13.png?authuser=0000&hl=id)
contentAttributes: ["logo", "hasTitle", "hasLogo"
"noCopyright", "noMatte", "centered", "transparentBackground",
"forLightBackground", "forDarkBackground", "smallFormat",
"largeFormat"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-14.png?authuser=0000&hl=id)
contentAttributes: ["sceneStill", "background",
"centered", "smallFormat", "largeFormat", "noTitle", "noLogo",
"hasCopyright", "noMatte"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-15.png?authuser=0000&hl=id)
contentAttributes: ["iconic", "poster", "centered",
"noTitle", "noLogo", "hasCopyright", "hasMatte", "smallFormat",
"largeFormat"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-16.png?authuser=0000&hl=id)
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, |
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 | |||||
09.5, |
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
danleftCentered
gambar latar juga dapat digunakan oleh beberapa produk, jadi Anda dapat menyertakannya jika Anda memilikinya.- Kami lebih memilih gambar yang berfungsi untuk
smallFormat
danlargeFormat
. - 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
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-8.png?authuser=0000&hl=id)
{
"@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
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-8.png?authuser=0000&hl=id)
{
"@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
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-9.png?authuser=0000&hl=id)
{
"@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
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-17.png?authuser=0000&hl=id)
{
"@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"]
}
]
}]
}