Skema XML

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

Elemen tingkat teratas: <feed>

Deskripsi

Elemen penampung paling atas yang berisi semua elemen lain dalam feed.

Atribut

Nama Format Kejadian Deskripsi
xmlns xs:string Wajib (1) Hardcode nilai berikut:
http://schemas.google.com/merchant_reviews/5.0
xmlns:xsi xs:string Wajib (1) Hardcode nilai berikut:
http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation xs:string Wajib (1) Hardcode nilai berikut, dengan 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

Nama 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

Nama 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

Nama Format Kejadian Deskripsi
id Id Wajib (1) Harus unik dan stabil di semua 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

Sertakan elemen berikut dalam elemen penjual.

Nama Format Kejadian Deskripsi
name NonEmptyString Wajib (1) Nama tampilan yang dapat dibaca manusia untuk penjual.
merchant_url xs:anyURI Wajib (1) URL ke situs utama penjual.
Jangan gunakan URL pengalihan 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:anyURI 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. Hal ini tidak boleh berubah.
last_update_timestamp DateTimeWithTimeZone Wajib (1) Waktu/tanggal terakhir kali penjual diperbarui. Jika ada kolom di elemen <merchant> yang diperbarui untuk ID penjual tertentu, nilai ini juga harus berubah.

<deleted_merchants>

Deskripsi

Penampung untuk penjual yang dihapus.

Berisi

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

<deleted_merchant>

Deskripsi

Penjual yang dihapus.

Atribut

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

Berisi

Nama 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

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

<review>

Deskripsi

Penampung untuk detail terkait ulasan.

Atribut

Nama Format Kejadian Deskripsi
id Id Wajib (1) ID untuk ulasan di sistem Anda. Harus unik dan stabil di semua feed.

Contoh: 

<review id=132739 mid=1234>

mid Id Wajib (1) ID penjual yang ulasannya ini ditujukan untuknya.

Berisi

Sertakan elemen berikut dalam elemen ulasan.

Nama Format Kejadian Deskripsi
reviewer_name NonEmptyString Opsional (0‑1) Nama tampilan penulis ulasan, asalkan ulasan harus memiliki penulis bernama. Ulasan anonim tidak boleh menyertakan kolom ini.

Contoh: 

<reviewer_name>
  Joel
</reviewer_name>

create_timestamp DateTimeWithTimeZone Wajib (1) Waktu/tanggal ulasan dikirimkan oleh pengguna. Hal ini tidak boleh 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 dalam 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 diberikan. 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 apa pun di dalamnya.

Contoh: 

  <title>
    Great prices
  </title>

content xs:string Wajib (1) Konten ulasan. Ini harus berupa teks bentuk bebas yang diberikan oleh pengguna dan tidak boleh dipangkas. Konten harus berupa teks biasa tanpa tag HTML apa pun di dalamnya. Misalnya, baris baru harus ditampilkan dengan karakter feed baris, bukan tag <br>. Jika beberapa respons untuk pertanyaan yang berbeda diberikan, semua respons harus disertakan, dengan konteks minimal agar respons tersebut dapat dipahami. Konteks tidak boleh diberikan jika pertanyaan tidak terjawab.

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 penjual dari pengulas. Jika tidak ada rating yang tersedia untuk elemen <overall>, maka 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. Nilainya harus berupa salah satu dari berikut:
  • tidak diminta: Pengguna mengirimkan ulasan tanpa diminta.
  • point_of_sale: Pengguna mengirimkan ulasan sebagai respons atas permintaan saat pengguna melakukan pemesanan.
  • after_fulfillment: Pengguna mengirimkan ulasan sebagai respons atas permintaan setelah fulfillment pesanan pengguna.

Contoh: 

  <collection_method>
    after_fulfillment
  </collection_method>

<ratings>

Deskripsi

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

Berisi

Sertakan elemen berikut dalam elemen rating.

Nama Format Kejadian Deskripsi
overall RatingRange Wajib (1) Rating keseluruhan pemberi ulasan untuk penjual.

Contoh: 

  <overall min="1" max="10">9</overall>

customer_service RatingRange Opsional (0‑1) Rating pengulas tentang kualitas layanan pelanggan untuk penjual ini.

Contoh: 

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

<deleted_reviews>

Deskripsi

Penampung untuk ulasan yang dihapus.

Berisi

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

<deleted_review>

Deskripsi

Ulasan yang dihapus.

Atribut

Nama 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

Nama 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>