Buku: /product-review-feeds/_book.yaml
Title: Referensi Skema XML
Skema XML untuk Feed Ulasan Produk Google menentukan struktur feed XML yang dapat diterima. Skema XML menggunakan ekstensi file .xsd
. Seperti file DTD, skema XML menentukan elemen dan atribut yang dapat muncul dalam dokumen XML.
Anda dapat mempelajari lebih lanjut skema XML dari Skema Utama XML ini.
Skema XML untuk feed ulasan produk dipublikasikan di sini: http://www.google.com/shopping/reviews/schema/product/2.3/product_reviews.xsd
Deskripsi struktur feed yang ditentukan oleh skema ini mengikuti. Dalam
deskripsi ini, nama jenis dengan awalan xs:
merujuk pada jenis skema XML bawaan
yang berada di namespace XML http://www.w3.org/2001/XMLSchema
.
Sistem kami selalu mengharapkan feed lengkap. Setiap ulasan yang dikirimkan sebelumnya, tetapi tidak disertakan dalam feed lengkap berikutnya akan dihapus. Oleh karena itu, sebaiknya selalu kirimkan semua ulasan saat mengirimkan feed Anda.
Elemen <feed>
level teratas
Elemen <feed>
berisi elemen ini dalam urutan yang tercantum.
Elemen | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
<version>
|
Wajib (1) | xs:string
|
Menunjukkan versi skema feed ulasan produk yang digunakan. Saat ini hanya
<version>2.3</version>
yang didukung. |
<aggregator>
|
Opsional (1) | aggregatorType
|
Penayang dapat menggunakan aggregator ulasan untuk mengelola ulasan dan menyediakan feed. Elemen ini menunjukkan penggunaan agregator dan berisi informasi tentang agregator. |
<publisher>
|
Wajib (1) | publisherType
|
Informasi tentang penayang, yang mungkin merupakan retailer, produsen, perusahaan layanan ulasan, atau entitas apa pun yang memublikasikan ulasan produk. |
<reviews>
|
Opsional (1) | xs:sequence
|
Berisi ulasan produk. |
<feed>
menentukan batasan keunikan pada elemen yang digunakan dalam feed.
Elemen Turunan
<aggregator>
Penayang dapat menggunakan aggregator ulasan untuk mengelola ulasan dan menyediakan feed. Elemen ini menunjukkan penggunaan agregator dan berisi informasi
tentang agregator. Elemen <aggregator>
berisi elemen-elemen ini dalam
urutan yang tercantum.
Elemen | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
<name> |
Wajib (1) | nonEmptyStringType |
Nama agregator ulasan produk. |
<publisher>
Informasi tentang penayang, yang mungkin merupakan retailer, produsen,
perusahaan layanan ulasan, atau entitas apa pun yang memublikasikan ulasan produk.Elemen
<publisher>
berisi elemen ini dalam urutan yang tercantum.
Elemen | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
<name> |
Wajib (1) | nonEmptyStringType |
Nama penerbit ulasan produk. |
<favicon> |
Opsional (1) | httpUrlType |
Link ke favicon perusahaan penerbit. Dimensi gambar harus berupa ukuran favicon: 16x16 piksel. Format gambar harus GIF, JPG, atau PNG. |
<reviews>
Berisi ulasan produk. Elemen <reviews>
berisi elemen-elemen ini dalam
urutan yang tercantum.
Elemen | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
<review> |
Wajib (1-tidak terbatas) | reviewType |
Ulasan unik untuk masing-masing produk. Jika ulasan berkaitan dengan beberapa produk di inventaris penayang, tentukan ulasan sekali, dan sertakan beberapa elemen <product> di elemen <products> . |
<review>
Ulasan unik untuk masing-masing produk. Jika ulasan berkaitan dengan beberapa produk
di inventaris penayang, tentukan ulasan sekali, dan sertakan beberapa
elemen <product>
di elemen <products>
.Elemen <review>
berisi
elemen ini dalam urutan yang tercantum.
Elemen | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
<review_id> |
Opsional (1) | nonEmptyStringType |
ID permanen yang unik untuk ulasan produk di sistem penayang. |
<reviewer>
|
Wajib (1) | reviewerType |
Penulis ulasan produk. |
<review_timestamp> |
Wajib (1) | xs:dateTime |
Stempel waktu yang menunjukkan kapan ulasan ditulis. Contoh: 2014-04-21T11:07:07-06:00 2014-04-21T18:00:00+01:00 2014-04-21T00:00:00Z |
<title> |
Opsional (1) | nonEmptyStringType |
Judul ulasan. |
<content> |
Wajib (1) | nonEmptyStringType |
Konten ulasan. |
<pros>
|
Opsional (1) | xs:sequence |
Berisi profesional berdasarkan pendapat pengulas. Hapus teks boilerplate seperti "pro:" kecuali jika ditulis oleh peninjau. |
<cons>
|
Opsional (1) | xs:sequence |
Berisi kekurangan berdasarkan pendapat pengulas. Hapus teks boilerplate seperti "con:" kecuali jika ditulis oleh peninjau. |
<reviewer_images>
|
Opsional (1) | xs:sequence |
Berisi link ke gambar produk yang disediakan oleh pengulas. |
<review_url>
|
Wajib (1) | reviewUrlType |
URL halaman landing ulasan. |
<ratings>
|
Wajib (1) | xs:sequence |
Berisi rating yang terkait dengan ulasan. |
<products>
|
Wajib (1) | xs:sequence |
Berisi produk yang terkait dengan ulasan. |
<is_spam> |
Opsional (1) | xs:boolean |
Menunjukkan apakah ulasan ditandai sebagai spam dalam sistem penayang. |
<collection_method> |
Opsional (1) | collectionMethodType |
Metode yang digunakan untuk mengumpulkan ulasan. Nilai ini harus berupa salah satu dari berikut ini:
|
<transaction_id> |
Opsional (1) | nonEmptyStringType |
ID unik permanen untuk transaksi yang terkait dengan ulasan dalam sistem penayang. ID ini dapat digunakan untuk menunjukkan bahwa beberapa ulasan dikaitkan dengan transaksi yang sama. |
<reviewer>
Penulis ulasan produk. Elemen <reviewer>
berisi elemen-elemen ini dalam urutan yang tercantum.
Elemen | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
<name>
|
Wajib (1) | reviewerNameType |
Nama penulis ulasan. Contoh: <name>Jane</name> |
<reviewer_id> |
Opsional (1) | nonEmptyStringType |
ID unik permanen untuk penulis ulasan dalam sistem penayang. Contoh: <reviewer_id>14295</reviewer_id> |
<name>
Nama penulis ulasan. Elemen <name>
adalah ekstensi dari
nonEmptyStringType
dan berisi nama atau alias pengulas. Elemen
<name>
berisi atribut ini.
Atribut | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
is_anonymous |
Opsional | xs:boolean |
Menunjukkan apakah pengulas adalah anonim. Contoh: <name is_anonymous="true">Anonymous</name> |
<pros>
Berisi profesional berdasarkan pendapat pengulas. Elemen <pros>
berisi elemen ini dalam urutan yang tercantum.
Elemen | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
<pro> |
Wajib (1-tidak terbatas) | nonEmptyStringType |
Profesional individual berdasarkan pendapat pengulas. Pro harus dicantumkan dalam urutan yang sama seperti yang ditampilkan. Hapus teks boilerplate seperti "pro:" kecuali jika ditulis oleh pengulas. Contoh: <pros> <pro>Sleek design</pro> </pros> |
<cons>
Berisi kekurangan berdasarkan pendapat pengulas. Elemen <cons>
berisi elemen ini dalam urutan yang tercantum.
Elemen | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
<con> |
Wajib (1-tidak terbatas) | nonEmptyStringType |
Kontra individual berdasarkan pendapat pengulas. Kontra harus dicantumkan dalam urutan yang sama seperti yang ditampilkan. Hapus teks boilerplate seperti "con:" kecuali jika ditulis oleh pengulas. Contoh: <cons> <con>Pricey</con> </cons> |
<review_url>
URL halaman landing ulasan. Elemen <review_url>
adalah perluasan dari httpUrlType
dan berisi link ke halaman landing ulasan.
Elemen <review_url>
berisi atribut ini.
Atribut | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
type |
Wajib | xs:string |
Jenisnya harus berupa salah satu dari berikut ini:
Contoh: <review_url type="singleton">http://www.example.com/review_5.html</review_url> |
<reviewer_images>
Berisi gambar produk yang disediakan oleh peninjau. Tag <reviewer_images>
berisi banyak elemen <reviewer_image>
.
Elemen | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
<reviewer_image>
|
Wajib (1-tidak terbatas) | reviewImageType |
Gambar produk yang diulas yang dibuat oleh penulis ulasan. |
<reviewer_image>
Satu elemen gambar ulasan.
Elemen | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
<url> |
Wajib (1) | httpUrlType |
URL ke gambar produk yang diulas yang dibuat oleh penulis ulasan. URL tidak harus berakhir dengan ekstensi file gambar. Contoh: <reviewer_images> <reviewer_image> <url>https://example.com/test.jpg</url> </reviewer_image> <reviewer_image> <url>https://example.com/test.gif</url> </reviewer_image> </reviewer_images> |
<ratings>
Berisi rating yang terkait dengan ulasan. Elemen <ratings>
berisi elemen ini dalam urutan yang tercantum.
Elemen | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
<overall> |
Wajib (1) | ratingType |
Rating keseluruhan dari peninjau produk. |
<overall>
Rating keseluruhan dari peninjau produk. Elemen <overall>
memperluas
xs:decimal simpleType
dan menangkap rating yang ditetapkan oleh pengulas. Nilai harus berada dalam rentang inklusif yang ditentukan oleh atribut min
dan max
. Elemen <overall>
berisi atribut ini.
Atribut | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
min
|
Wajib | xs:integer
|
Angka minimum yang memungkinkan untuk rating. Rating ini mungkin rating terendah dan tidak boleh berupa nilai tanpa rating. |
max
|
Wajib | xs:integer
|
Jumlah kemungkinan maksimum untuk
rating. Nilai atribut max
harus lebih besar dari
nilai atribut min . |
<products>
Berisi produk yang terkait dengan ulasan. Elemen <products>
berisi elemen ini dalam urutan yang tercantum.
Elemen | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
<product> |
Wajib (1-tidak terbatas) | productType |
Produk yang terkait dengan ulasan. |
<product>
Produk yang terkait dengan ulasan. Elemen <product>
berisi elemen-elemen ini dalam urutan yang tercantum.
Elemen | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
<product_ids> |
Opsional (1) | productIdsType |
ID yang terkait dengan produk. |
<product_name> |
Opsional (1) | nonEmptyStringType |
Nama deskriptif suatu produk. |
<product_url> |
Wajib (1) | httpUrlType |
URL produk. URL ini dapat memiliki nilai yang sama dengan elemen <review_url> , jika URL ulasan dan URL produk sama. |
<product_ids>
ID yang terkait dengan produk. Elemen <product_ids>
berisi
elemen ini dalam urutan yang tercantum.
Elemen | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
<gtins> |
Wajib (Untuk semua ulasan yang terkait dengan produk dengan GTIN yang diketahui guna mengaktifkan pencocokan ulasan lengkap) Opsional (sangat direkomendasikan) untuk semua ulasan lainnya (1) |
gtinsType |
Berisi GTIN (nomor barang perdagangan global) yang terkait dengan produk. |
<mpns> |
Wajib (MPN harus disertakan untuk memfasilitasi pencocokan ulasan jika produk yang terkait dengan ulasan tidak memiliki GTIN yang ditetapkan. Harus dikirimkan dengan Merek) Opsional untuk semua ulasan lainnya (1) |
mpnsType |
Berisi MPN (nomor suku cadang produsen) yang terkait dengan produk. |
<skus> |
Wajib (SKU harus disertakan untuk memfasilitasi pencocokan ulasan, jika produk yang terkait dengan ulasan tidak memiliki GTIN atau MPN yang ditetapkan. Harus dikirim dengan Merek) Opsional untuk semua ulasan lainnya (1) |
skusType |
Berisi SKU (unit pemeliharaan stok) yang terkait dengan produk. Biasanya ini cocok dengan ID Penawaran produk di feed produk. |
<brands> |
Wajib (Merek harus disertakan untuk memfasilitasi pencocokan ulasan jika produk yang terkait dengan ulasan tidak memiliki GTIN yang ditetapkan. Harus dikirimkan dengan MPN) Opsional untuk semua ulasan lainnya (1) |
brandsType |
Berisi nama merek yang terkait dengan produk. |
<asins> |
Opsional (1) | asinsType |
Berisi ASIN (Amazon Standard Identification Number) yang terkait dengan produk. |
<gtins>
Berisi GTIN (nomor barang perdagangan global) yang terkait dengan produk. Elemen
<gtins>
berisi elemen ini dalam urutan yang tercantum.
Elemen | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
<gtin> |
Wajib (1-tidak terbatas) | nonEmptyStringType |
Nomor barang perdagangan global produk. |
<mpns>
Berisi MPN (nomor suku cadang produsen) yang terkait dengan produk. Elemen
<mpns>
berisi elemen ini dalam urutan yang tercantum.
Elemen | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
<mpn> |
Wajib (1-tidak terbatas) | nonEmptyStringType |
Nomor suku cadang produsen produk. |
<skus>
Berisi SKU (unit pemeliharaan stok) yang terkait dengan produk. Elemen <skus>
berisi elemen ini dalam urutan yang tercantum.
Elemen | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
<sku> |
Wajib (1-tidak terbatas) | nonEmptyStringType |
Unit penyimpanan stok produk dalam inventaris penayang. |
<brands>
Berisi nama merek yang terkait dengan produk. Elemen <brands>
berisi
elemen ini dalam urutan yang tercantum.
Elemen | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
<brand> |
Wajib (1-tidak terbatas) | nonEmptyStringType |
Nama merek produk. |
<asins>
Berisi ASIN (Amazon Standard Identification Number) yang terkait dengan
produk. Elemen
Elemen | Kekerapan | Jenis | Deskripsi |
---|---|---|---|
<asin> |
Wajib (1-tidak terbatas) | nonEmptyStringType |
Nomor Identifikasi Standar Amazon produk. Setiap ASIN terdiri dari 10 karakter panjang dan alfanumerik. |