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 XML Schema Primer ini.

Skema XML untuk feed ulasan produk dipublikasikan di sini: http://www.google.com/shopping/reviews/schema/product/2.4/product_reviews.xsd

Deskripsi struktur feed yang ditentukan oleh skema ini akan dijelaskan di bawah. Dalam deskripsi ini, nama jenis dengan awalan xs: merujuk ke jenis skema XML bawaan yang ada di namespace XML http://www.w3.org/2001/XMLSchema.

Sistem kami selalu mengharapkan feed lengkap. Ulasan yang dikirimkan sebelumnya, tetapi tidak disertakan dalam feed lengkap berikutnya akan dihapus. Oleh karena itu, Anda harus selalu mengirimkan semua ulasan saat mengirimkan feed.

Elemen <feed> tingkat teratas

Elemen <feed> berisi elemen ini dalam urutan yang tercantum.

Elemen Kemunculan Jenis Deskripsi
<version> Wajib (1) xs:string Menunjukkan versi skema feed ulasan produk yang digunakan. Saat ini hanya <version>2.4</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 penerbit, yang mungkin berupa 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 Kemunculan Jenis Deskripsi
<name> Wajib diisi (1) nonEmptyStringType Nama agregator ulasan produk.

<publisher>

Informasi tentang penayang, yang dapat berupa retailer, produsen, perusahaan layanan ulasan, atau entitas apa pun yang memublikasikan ulasan produk.Elemen <publisher> berisi elemen ini dalam urutan yang tercantum.

Elemen Kemunculan Jenis Deskripsi
<name> Wajib diisi (1) nonEmptyStringType Nama penerbit ulasan produk.
<favicon> Opsional (1) httpUrlType Link ke favicon perusahaan milik penayang. Dimensi gambar harus berukuran favicon: 16x16 piksel. Format gambar harus GIF, JPG, atau PNG.

<reviews>

Berisi ulasan produk. Elemen <reviews> berisi elemen ini dalam urutan yang tercantum.

Elemen Kemunculan Jenis Deskripsi
<review> Wajib (1-tanpa batas) reviewType Ulasan produk unik perorangan. Jika ulasan berkaitan dengan beberapa produk dalam inventaris penayang, tentukan ulasan satu kali, dan sertakan beberapa elemen <product> dalam elemen <products>.

<review>

Ulasan produk unik perorangan. Jika ulasan berkaitan dengan beberapa produk dalam inventaris penayang, tentukan ulasan satu kali, dan sertakan beberapa elemen <product> dalam elemen <products>.Elemen <review> berisi elemen ini dalam urutan yang tercantum.

Elemen Kemunculan Jenis Deskripsi
<review_id> Wajib diisi (1) nonEmptyStringType ID unik permanen untuk ulasan produk dalam sistem penayang.
<reviewer> Wajib diisi (1) reviewerType Penulis ulasan produk.
<is_verified_purchase> Opsional (1) xs:boolean Menunjukkan apakah telah diverifikasi bahwa pengulas membeli produk tersebut.
<is_incentivized_review> Opsional (1) xs:boolean Menunjukkan apakah pengulas diberi insentif untuk mengulas produk atau tidak.
<review_timestamp> Wajib diisi (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 diisi (1) nonEmptyStringType Konten ulasan.
<review_language> Opsional (1) xs:string Bahasa ulasan (BCP 47).
<review_country> Opsional (1) xs:string Kode negara (ISO 3166-1) peninjau.
<pros> Opsional (1) xs:sequence Berisi kelebihan berdasarkan pendapat pengulas. Jangan sertakan teks boilerplate seperti "pro:" kecuali jika ditulis oleh pengulas.
<cons> Opsional (1) xs:sequence Berisi kekurangan berdasarkan pendapat pengulas. Jangan sertakan teks standar seperti "con:" kecuali jika ditulis oleh pengulas.
<reviewer_images> Opsional (1) xs:sequence Berisi link ke gambar produk yang disediakan oleh pengulas.
<review_url> Wajib diisi (1) reviewUrlType URL halaman landing ulasan.
<ratings> Wajib diisi (1) xs:sequence Berisi rating yang terkait dengan ulasan.
<products> Wajib diisi (1) xs:sequence Berisi produk yang terkait dengan ulasan.
<is_spam> Opsional (1) xs:boolean Menunjukkan apakah ulasan ditandai sebagai spam di sistem penayang.
<collection_method> Opsional (1) collectionMethodType

Metode yang digunakan untuk mengumpulkan ulasan. Nilainya harus berupa salah satu dari berikut:

unsolicited
Pengguna tidak merespons permintaan tertentu saat mereka mengirimkan ulasan.
post_fulfillment
Pengguna mengirimkan ulasan sebagai respons atas permintaan setelah pemenuhan pesanan pengguna.
<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 Kemunculan Jenis Deskripsi
<name> Wajib diisi (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 nonEmptyStringType dan berisi nama atau alias pengulas. Elemen <name> berisi atribut ini.

Atribut Kemunculan Jenis Deskripsi
is_anonymous Opsional xs:boolean

Menunjukkan apakah pengulas anonim.

Contoh:

<name is_anonymous="true">Anonymous</name>

<pros>

Berisi kelebihan berdasarkan pendapat pengulas. Elemen <pros> berisi elemen ini dalam urutan yang tercantum.

Elemen Kemunculan Jenis Deskripsi
<pro> Wajib (1-tanpa batas) nonEmptyStringType

Kelebihan individu berdasarkan pendapat pengulas. Kelebihan harus dicantumkan dalam urutan yang sama seperti yang ditampilkan. Jangan sertakan 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 Kemunculan Jenis Deskripsi
<con> Wajib (1-tanpa batas) nonEmptyStringType

Kekurangan individu berdasarkan pendapat pengulas. Kekurangan harus dicantumkan dalam urutan yang sama dengan yang ditampilkan. Jangan sertakan 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 ekstensi dari httpUrlType dan berisi link ke halaman landing ulasan. Elemen <review_url> berisi atribut ini.

Atribut Kemunculan Jenis Deskripsi
type Wajib xs:string

Jenisnya harus berupa salah satu dari berikut ini:

singleton
Halaman ulasan hanya berisi satu ulasan ini.
group
Halaman ulasan berisi sekelompok ulasan termasuk ulasan ini.

Contoh:

<review_url type="singleton">http://www.example.com/review_5.html</review_url>

<reviewer_images>

Berisi gambar produk yang disediakan oleh pengulas. Tag <reviewer_images> berisi banyak elemen <reviewer_image>.

Elemen Kemunculan Jenis Deskripsi
<reviewer_image> Wajib (1-tanpa batas) reviewImageType

Gambar produk yang diulas yang dibuat oleh penulis ulasan.

<reviewer_image>

Elemen gambar ulasan tunggal.

Elemen Kemunculan Jenis Deskripsi
<url> Wajib diisi (1) httpUrlType

URL ke gambar produk yang diulas yang dibuat oleh penulis ulasan. URL tidak harus diakhiri 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 Kemunculan Jenis Deskripsi
<overall> Wajib diisi (1) ratingType Rating keseluruhan produk dari pengulas.

<overall>

Rating keseluruhan produk dari pengulas. Elemen <overall> memperluas xs:decimal simpleType dan merekam rating yang ditetapkan oleh pengulas. Nilai harus berada dalam rentang inklusif yang ditentukan oleh atribut min dan max. Elemen <overall> berisi atribut ini.

Atribut Kemunculan Jenis Deskripsi
min Wajib xs:integer Kemungkinan angka minimum untuk rating. Nilai ini harus menjadi rating terburuk yang mungkin dan tidak boleh menjadi nilai untuk tidak ada rating.
max Wajib xs:integer Jumlah maksimum yang mungkin untuk rating. Nilai atribut max harus lebih besar daripada nilai atribut min.

<products>

Berisi produk yang terkait dengan ulasan. Elemen <products> berisi elemen ini dalam urutan yang tercantum.

Elemen Kemunculan Jenis Deskripsi
<product> Wajib (1-tanpa batas) productType Produk yang terkait dengan ulasan.

<product>

Produk yang terkait dengan ulasan. Elemen <product> berisi elemen-elemen ini dalam urutan yang tercantum.

Elemen Kemunculan Jenis Deskripsi
<product_ids> Opsional (1) productIdsType ID yang terkait dengan produk.
<product_name> Opsional (1) nonEmptyStringType Nama deskriptif produk.
<product_url> Wajib diisi (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 Kemunculan Jenis Deskripsi
<gtins> Wajib (Untuk semua ulasan yang terkait dengan produk yang GTIN-nya diketahui)

Opsional untuk semua ulasan lainnya (1)		 gtinsType Berisi GTIN (nomor barang perdagangan global) yang terkait dengan produk. Sub-jenis GTIN (misalnya, UPC, EAN, ISBN, JAN) didukung.
<mpns> Wajib (Untuk semua ulasan yang terkait dengan produk dengan MPN yang diketahui)

Opsional untuk semua ulasan lainnya (1)		 mpnsType Berisi MPN (nomor suku cadang produsen) yang terkait dengan produk.
<skus> Wajib (Untuk semua ulasan yang terkait dengan produk dengan SKU yang diketahui)

Opsional untuk semua ulasan lainnya (1)		 skusType Berisi SKU (unit penyimpanan persediaan) yang terkait dengan produk. Biasanya ini cocok dengan ID Penawaran produk di feed produk.
<brands> Wajib (Untuk semua ulasan yang terkait dengan produk dengan Merek yang diketahui)

Opsional untuk semua ulasan lainnya (1)		 brandsType Berisi nama merek yang terkait dengan produk.
<asins> Opsional (1) asinsType Berisi ASIN (Amazon Standard Identification Numbers) 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 Kemunculan Jenis Deskripsi
<gtin> Wajib (1-tanpa batas) nonEmptyStringType Nomor barang perdagangan global produk. Sub-jenis GTIN (misalnya, UPC, EAN, ISBN, JAN) didukung.

<mpns>

Berisi MPN (nomor suku cadang produsen) yang terkait dengan produk. Elemen <mpns> berisi elemen ini dalam urutan yang tercantum.

Elemen Kemunculan Jenis Deskripsi
<mpn> Wajib (1-tanpa batas) nonEmptyStringType Nomor suku cadang produsen produk.

<skus>

Berisi SKU (unit penyimpanan persediaan) yang terkait dengan produk. Elemen <skus> berisi elemen ini dalam urutan yang tercantum.

Elemen Kemunculan Jenis Deskripsi
<sku> Wajib (1-tanpa batas) nonEmptyStringType Unit penyimpanan persediaan produk dalam inventaris penayang.

<brands>

Berisi nama merek yang terkait dengan produk. Elemen <brands> berisi elemen ini dalam urutan yang tercantum.

Elemen Kemunculan Jenis Deskripsi
<brand> Wajib (1-tanpa batas) nonEmptyStringType Nama merek produk.

<asins>

Berisi ASIN (Amazon Standard Identification Numbers) yang terkait dengan produk. Elemen <asins> berisi elemen ini dalam urutan yang tercantum.

Elemen Kemunculan Jenis Deskripsi
<asin> Wajib (1-tanpa batas) nonEmptyStringType Nomor Identifikasi Standar Amazon produk. Setiap ASIN memiliki panjang 10 karakter dan alfanumerik.