Skema XML

Bagian ini menguraikan skema XML yang digunakan untuk feed data ulasan penjual.

Elemen tingkat atas: <feed>

Deskripsi

Elemen penampung paling atas yang menampung semua elemen lainnya dalam feed.

Atribut

Name Format Kejadian Deskripsi
xmlns xs:string Wajib (1) Lakukan hardcode pada nilai berikut:
http://schemas.google.com/merchant_reviews/5.0
xmlns:xsi xs:string Wajib (1) Lakukan hardcode pada nilai berikut:
http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation xs:string Wajib (1) Lakukan hardcode pada nilai berikut, dengan mengosongkan satu spasi kosong di antara URL:
http://schemas.google.com/merchant_reviews/5.0 http://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd

Contoh

<feed xmlns="http://schemas.google.com/merchant_reviews/5.0"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://schemas.google.com/merchant_reviews/5.0 https://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd">

Berisi

Name Format Kejadian Deskripsi
merchants -- Opsional (0‐1) Elemen penampung untuk elemen <merchant>.
deleted_merchants -- Opsional (0‐1) Elemen penampung untuk elemen <deleted_merchant>.
reviews -- Opsional (0‐1) Elemen penampung untuk elemen <review>.
deleted_reviews -- Opsional (0‐1) Elemen penampung untuk elemen <deleted_review>.

<merchants>

Deskripsi

Container untuk elemen <merchant>.

Berisi

Name Format Kejadian Deskripsi
merchant -- Wajib (1‐n) Elemen diulang untuk setiap penjual.

<merchant>

Deskripsi

Setiap elemen <merchant> berisi informasi dan ulasan untuk satu penjual.

Atribut

Name Format Kejadian Deskripsi
id ID Wajib (1) Harus unik dan stabil di seluruh feed. Dengan kata lain, jika feed hari ini dan feed 90 hari yang lalu merujuk ke penjual yang sama, keduanya harus memiliki ID yang sama.

Contoh

<merchant id="2739">

Berisi

Harap sertakan elemen berikut dalam elemen penjual.

Name Format Kejadian Deskripsi
name NonEmptyString Wajib (1) Nama tampilan yang dapat dibaca manusia untuk penjual.
merchant_url xs:URI Wajib (1) URL ke situs utama penjual.
Jangan gunakan URL alihan untuk nilai ini. Dengan kata lain, nilai harus mengarah langsung ke situs penjual.

Contoh: 

<merchant_url>
  http://store.google.com
</merchant_url>
rating_url xs:URI Wajib (1) URL ke halaman landing yang menghosting ulasan untuk penjual ini.
Jangan gunakan URL pengalihan.

Contoh: 

<rating_url>
  http://merchant_url.com/reviews/
</rating_url>
create_timestamp DateTimeWithTimeZone Wajib (1) Waktu/tanggal penjual dibuat. Ini seharusnya tidak pernah berubah.
last_update_timestamp DateTimeWithTimeZone Wajib (1) Waktu/tanggal penjual terakhir kali diperbarui. Jika salah satu kolom di elemen <merchant> diperbarui untuk ID penjual tertentu, nilai ini juga harus berubah.

<deleted_merchants>

Deskripsi

Penampung untuk penjual yang dihapus.

Berisi

Name Format Kejadian Deskripsi
deleted_merchant -- Wajib (1‐n) Berisi elemen yang terkait dengan satu penjual yang dihapus.

<deleted_merchant>

Deskripsi

Penjual yang dihapus.

Atribut

Name Format Kejadian Deskripsi
id ID Wajib (1) Menentukan ID penjual yang harus dihapus dari feed. ID harus cocok dengan atribut id elemen <merchant> dalam file feed sebelumnya.

Berisi

Name Format Kejadian Deskripsi
last_update_timestamp DateTimeWithTimeZone Wajib (1) Waktu/tanggal saat penjual dihapus dari sistem.

Contoh: 

<last_update_timestamp>
  2016-04-03T18:37:32Z
</last_update_timestamp>

Contoh

<deleted_merchant id="10">
  <last_update_timestamp>2014-07-12T07:55:06Z</last_update_timestamp>
</deleted_merchant>

<reviews>

Deskripsi

Container untuk elemen <review>.

Berisi

Name Format Kejadian Deskripsi
review -- Wajib (1‐n) Elemen diulang untuk setiap ulasan.

<review>

Deskripsi

Penampung untuk detail yang terkait dengan ulasan.

Atribut

Name Format Kejadian Deskripsi
id ID Wajib (1) ID untuk ulasan dalam sistem Anda. Harus unik dan stabil di seluruh feed.

Contoh: 

<review id=132739 mid=1234>
mid ID Wajib (1) ID penjual yang untuknya ulasan ini.

Berisi

Harap sertakan elemen berikut dalam elemen ulasan.

Name Format Kejadian Deskripsi
reviewer_name NonEmptyString Opsional (0‐1) Tampilkan nama penulis ulasan, asalkan ulasan tersebut memiliki penulis bernama. Ulasan anonim tidak boleh menyertakan kolom ini.

Contoh: 

<reviewer_name>
  Joel
</reviewer_name>
create_timestamp DateTimeWithTimeZone Wajib (1) Waktu/tanggal peninjauan dikirim oleh pengguna. Ini seharusnya tidak pernah berubah.

Contoh: 

<create_timestamp>
  2016-04-03T18:37:32Z
</create_timestamp>
last_update_timestamp DateTimeWithTimeZone Wajib (1) Waktu/tanggal informasi dalam elemen <review> terakhir kali diubah. Jika salah satu kolom di elemen <review> diperbarui untuk ID ulasan tertentu, nilai ini juga harus berubah.

Contoh: 

<last_update_timestamp>
  2016-04-03T18:37:32Z
</last_update_timestamp>
country_code CountryCode Wajib (1) Negara pengulas. Jika tersedia, ini adalah negara tujuan pengiriman produk atau tempat layanan dirender. Jika tidak, gunakan negara tempat pengulas berada saat membuat ulasan. Kode negara harus dalam format ISO 3166-1 alpha-2.

Contoh: 

  <country_code>
    US
  </country_code>
title xs:string Opsional (0‐1) Judul ulasan. Judul harus berupa teks biasa tanpa tag HTML di dalamnya.

Contoh: 

  <title>
    Great prices
  </title>
content xs:string Wajib (1) Konten ulasan. Ini harus berupa teks bentuk bebas yang disediakan oleh pengguna dan tidak boleh dipotong. Konten harus berupa teks biasa tanpa tag HTML di dalamnya. Misalnya, jeda baris harus diwakili oleh karakter feed baris, bukan tag <br>. Jika beberapa respons untuk pertanyaan yang berbeda diberikan, semua respons harus disertakan, dengan konteks minimal untuk respons yang masuk akal. Konteks tidak boleh diberikan jika pertanyaan tidak dijawab.

Contoh: 

  <content>
    I like this store!
    My order arrived on time and I got
    a great price.
  </content>

Contoh: 

  <content>
    Positives: Great prices.
    Suggestions: Selection could be better.
  </content>
ratings -- Wajib (1) Elemen penampung untuk rating pengulas di penjual. Jika tidak ada rating yang tersedia untuk elemen <overall>, seluruh ulasan terkait harus dikecualikan dari feed karena elemen <overall> diperlukan dan ulasan tidak akan diterima tanpa elemen tersebut.
collection_method CollectionMethodType Wajib (1) Metode yang digunakan untuk mengumpulkan ulasan. Nilai ini harus berupa salah satu dari berikut:
  • tidak diminta: Pengguna tidak merespons permintaan tertentu saat mengirimkan ulasan.
  • point_of_sale: Pengguna mengirimkan ulasan sebagai tanggapan atas permintaan saat melakukan pemesanan.
  • after_fulfillment: Pengguna mengirimkan ulasan sebagai tanggapan atas permintaan setelah pemenuhan pesanan pengguna.

Contoh: 

  <collection_method>
    after_fulfillment
  </collection_method>

<ratings>

Deskripsi

Berisi rating penjual untuk pengulas. Jika tidak ada rating yang tersedia untuk elemen <overall>, seluruh ulasan terkait harus dikecualikan dari feed karena elemen <overall> diperlukan dan ulasan tidak akan diterima tanpa elemen tersebut.

Berisi

Harap sertakan elemen berikut dalam elemen rating.

Name Format Kejadian Deskripsi
overall RatingRentang Wajib (1) Rating keseluruhan pengulas untuk penjual.

Contoh: 

  <overall min="1" max="10">9</overall>
customer_service RatingRentang Opsional (0‐1) Rating dari peninjau kualitas layanan pelanggan untuk penjual ini.

Contoh: 

  <customer_service min="1" max="5">3</customer_service>

<deleted_reviews>

Deskripsi

Penampung untuk ulasan yang telah dihapus.

Berisi

Name Format Kejadian Deskripsi
deleted_review -- Wajib (1‐n) Berisi elemen yang terkait dengan satu ulasan yang dihapus.

<deleted_review>

Deskripsi

Ulasan yang telah dihapus.

Atribut

Name Format Kejadian Deskripsi
id ID Wajib (1) Menentukan ID ulasan yang harus dihapus dari feed. ID harus cocok dengan atribut id elemen <review> dalam file feed apa pun.

Berisi

Name Format Kejadian Deskripsi
last_update_timestamp DateTimeWithTimeZone Wajib (1) Waktu saat ulasan dihapus dari sistem.

Contoh: 

  <last_update_timestamp>
    2016-04-03T18:37:32Z
  </last_update_timestamp>

Contoh

<deleted_review id="10">
  <last_update_timestamp>2014-07-12T07:55:06Z<last_update_timestamp>
</deleted_review>