Referensi Skema XML

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:

unsolicited
Pengguna tidak merespons permintaan tertentu saat mengirimkan ulasan.
post_fulfillment
Pengguna mengirimkan ulasan sebagai tanggapan atas permintaan setelah pesanan pengguna dipenuhi.
<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:

singleton
Halaman ulasan hanya berisi ulasan tunggal ini.
group
Halaman ulasan berisi grup 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 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 berisi elemen ini dalam urutan yang tercantum.

Elemen Kekerapan Jenis Deskripsi
<asin> Wajib (1-tidak terbatas) nonEmptyStringType Nomor Identifikasi Standar Amazon produk. Setiap ASIN terdiri dari 10 karakter panjang dan alfanumerik.