สคีมา XML

ส่วนนี้จะอธิบายสคีมา XML ที่ใช้สําหรับฟีดข้อมูลรีวิวของผู้ขาย

องค์ประกอบระดับบนสุด: <feed>

คำอธิบาย

องค์ประกอบคอนเทนเนอร์ด้านบนสุดที่มีองค์ประกอบอื่นๆ ทั้งหมดในฟีด

แอตทริบิวต์

ชื่อ รูปแบบ จำนวนข้อผิดพลาด คำอธิบาย
xmlns xs:สตริง ต้องระบุ (1) โปรดฮาร์ดโค้ดค่าต่อไปนี้
http://schemas.google.com/merchant_reviews/5.0
xmlns:xsi xs:สตริง ต้องระบุ (1) โปรดฮาร์ดโค้ดค่าต่อไปนี้
http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation xs:สตริง ต้องระบุ (1) โปรดฮาร์ดโค้ดค่าต่อไปนี้โดยเว้นช่องว่างเดียวระหว่าง URL
http://schemas.google.com/merchant_reviews/5.0 http://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd

ตัวอย่าง

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

ประกอบด้วย

ชื่อ รูปแบบ จำนวนข้อผิดพลาด คำอธิบาย
merchants -- ไม่บังคับ (0‐1) องค์ประกอบคอนเทนเนอร์สําหรับองค์ประกอบ <merchant>
deleted_merchants -- ไม่บังคับ (0‐1) องค์ประกอบคอนเทนเนอร์สําหรับองค์ประกอบ <deleted_merchant>
reviews -- ไม่บังคับ (0‐1) องค์ประกอบคอนเทนเนอร์สําหรับองค์ประกอบ <review>
deleted_reviews -- ไม่บังคับ (0‐1) องค์ประกอบคอนเทนเนอร์สําหรับองค์ประกอบ <deleted_review>

<merchants>

คำอธิบาย

คอนเทนเนอร์สําหรับองค์ประกอบ <merchant>

ประกอบด้วย

ชื่อ รูปแบบ จำนวนข้อผิดพลาด คำอธิบาย
merchant -- ต้องระบุ (1‐n) ผู้ขายแต่ละรายใช้องค์ประกอบซ้ํา

<merchant>

คำอธิบาย

เอลิเมนต์ <merchant> แต่ละรายการมีข้อมูลและรีวิวสําหรับผู้ขาย 1 ราย

แอตทริบิวต์

ชื่อ รูปแบบ จำนวนข้อผิดพลาด คำอธิบาย
id รหัส ต้องระบุ (1) ต้องไม่ซ้ํากันและเสถียรในทุกฟีด กล่าวคือ หากฟีดวันนี้และฟีดเมื่อ 90 วันที่ผ่านมาอ้างอิงถึงผู้ขายรายเดียวกัน ผู้ขายจะต้องมีรหัสเดียวกัน

ตัวอย่าง

<merchant id="2739">

ประกอบด้วย

โปรดใส่องค์ประกอบต่อไปนี้ภายในองค์ประกอบของผู้ขาย

ชื่อ รูปแบบ จำนวนข้อผิดพลาด คำอธิบาย
name NonEmptyString ต้องระบุ (1) ชื่อที่แสดงซึ่งมนุษย์อ่านได้สําหรับผู้ขาย
merchant_url xs:anyURI ต้องระบุ (1) URL ไปยังเว็บไซต์หลักของผู้ขาย
อย่าใช้ URL เปลี่ยนเส้นทางสําหรับค่านี้ กล่าวคือ ค่านี้ควรชี้ไปยังไซต์ของผู้ขายโดยตรง

ตัวอย่าง: 

<merchant_url>
  http://store.google.com
</merchant_url>
rating_url xs:anyURI ต้องระบุ (1) URL ไปยังหน้า Landing Page ที่โฮสต์รีวิวของผู้ขายรายนี้
อย่าใช้ URL เปลี่ยนเส้นทาง

ตัวอย่าง: 

<rating_url>
  http://merchant_url.com/reviews/
</rating_url>
create_timestamp วันที่และเวลาที่มีเขตเวลา ต้องระบุ (1) เวลา/วันที่สร้างผู้ขาย ข้อมูลนี้จะไม่เปลี่ยนแปลง
last_update_timestamp วันที่และเวลาที่มีเขตเวลา ต้องระบุ (1) เวลา/วันที่ที่ผู้ขายอัปเดตล่าสุด หากมีการอัปเดตช่องในองค์ประกอบ <merchant> สําหรับรหัสผู้ขายที่กําหนด ค่านี้จะต้องเปลี่ยนแปลงด้วย

<deleted_merchants>

คำอธิบาย

คอนเทนเนอร์สําหรับผู้ขายที่ถูกลบไปแล้ว

ประกอบด้วย

ชื่อ รูปแบบ จำนวนข้อผิดพลาด คำอธิบาย
deleted_merchant -- ต้องระบุ (1‐n) มีองค์ประกอบที่เกี่ยวข้องกับผู้ขายเพียงรายเดียวที่ลบออก

<deleted_merchant>

คำอธิบาย

ผู้ขายที่ลบไปแล้ว

แอตทริบิวต์

ชื่อ รูปแบบ จำนวนข้อผิดพลาด คำอธิบาย
id รหัส ต้องระบุ (1) ระบุรหัสของผู้ขายที่ควรลบออกจากฟีด รหัสต้องตรงกับแอตทริบิวต์ id ขององค์ประกอบ <merchant> ในไฟล์ฟีดก่อนหน้า

ประกอบด้วย

ชื่อ รูปแบบ จำนวนข้อผิดพลาด คำอธิบาย
last_update_timestamp วันที่และเวลาที่มีเขตเวลา ต้องระบุ (1) เวลา/วันที่ที่ผู้ขายถูกนําออกจากระบบ

ตัวอย่าง: 

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

ตัวอย่าง

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

<reviews>

คำอธิบาย

คอนเทนเนอร์สําหรับองค์ประกอบ <review>

ประกอบด้วย

ชื่อ รูปแบบ จำนวนข้อผิดพลาด คำอธิบาย
review -- ต้องระบุ (1‐n) เอลิเมนต์ทําซ้ํารีวิวแต่ละรายการ

<review>

คำอธิบาย

คอนเทนเนอร์สําหรับรายละเอียดที่เกี่ยวข้องกับรีวิว

แอตทริบิวต์

ชื่อ รูปแบบ จำนวนข้อผิดพลาด คำอธิบาย
id รหัส ต้องระบุ (1) ตัวระบุสําหรับรีวิวในระบบ ต้องไม่ซ้ํากันและเสถียรในทุกฟีด

ตัวอย่าง: 

<review id=132739 mid=1234>
mid รหัส ต้องระบุ (1) ตัวระบุของผู้ขายที่รีวิวนี้ใช้

ประกอบด้วย

โปรดรวมองค์ประกอบต่อไปนี้ภายในองค์ประกอบการตรวจสอบ

ชื่อ รูปแบบ จำนวนข้อผิดพลาด คำอธิบาย
reviewer_name NonEmptyString ไม่บังคับ (0‐1) ชื่อที่แสดงของผู้เขียนรีวิว หากรีวิวควรมีผู้เขียนที่มีชื่อ รีวิวแบบไม่ระบุตัวตนไม่ควรมีช่องนี้

ตัวอย่าง: 

<reviewer_name>
  Joel
</reviewer_name>
create_timestamp วันที่และเวลาที่มีเขตเวลา ต้องระบุ (1) เวลา/วันที่ที่ผู้ใช้ส่งรีวิว ข้อมูลนี้จะไม่เปลี่ยนแปลง

ตัวอย่าง: 

<create_timestamp>
  2016-04-03T18:37:32Z
</create_timestamp>
last_update_timestamp วันที่และเวลาที่มีเขตเวลา ต้องระบุ (1) เวลา/วันที่ข้อมูลในองค์ประกอบ <review> มีการเปลี่ยนแปลงครั้งล่าสุด หากมีการอัปเดตช่องในองค์ประกอบ <review> สําหรับรหัสรีวิวที่ระบุ ค่านี้จะต้องเปลี่ยนแปลงด้วย

ตัวอย่าง: 

<last_update_timestamp>
  2016-04-03T18:37:32Z
</last_update_timestamp>
country_code รหัสประเทศ ต้องระบุ (1) ประเทศของผู้รีวิว นี่คือประเทศที่นําส่งผลิตภัณฑ์ไปหรือประเทศที่รับบริการ (หากมี) มิเช่นนั้น ให้ใช้ประเทศที่ผู้รีวิวอยู่ในจุดที่สร้างรีวิว รหัสประเทศต้องอยู่ในรูปแบบ ISO 3166-1 alpha-2

ตัวอย่าง: 

  <country_code>
    US
  </country_code>
title xs:สตริง ไม่บังคับ (0‐1) ชื่อรีวิว ชื่อควรเป็นข้อความธรรมดาโดยไม่มีแท็ก HTML

ตัวอย่าง: 

  <title>
    Great prices
  </title>
content xs:สตริง ต้องระบุ (1) เนื้อหาของรีวิว ซึ่งควรเป็นข้อความรูปแบบอิสระที่ผู้ใช้ให้ไว้ และไม่ควรถูกตัดออก เนื้อหาควรเป็นข้อความธรรมดาโดยไม่มีแท็ก HTML อยู่ภายใน เช่น ตัวแบ่งบรรทัดควรแสดงด้วยอักขระฟีดบรรทัด ไม่ใช่แท็ก <br> หากระบุหลายคําตอบสําหรับคําถามที่แตกต่างกัน คําตอบทั้งหมดควรจะรวมไว้โดยมีบริบทเพียงเล็กน้อยเพื่อให้คําตอบสมเหตุสมผล ไม่ควรระบุบริบทหากไม่มีคําตอบสําหรับคําถาม

ตัวอย่าง: 

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

ตัวอย่าง: 

  <content>
    Positives: Great prices.
    Suggestions: Selection could be better.
  </content>
ratings -- ต้องระบุ (1) องค์ประกอบคอนเทนเนอร์สําหรับคะแนนผู้ขายของผู้รีวิว หากไม่มีการให้คะแนนสําหรับองค์ประกอบ <overall> ก็ควรยกเว้นรีวิวที่เกี่ยวข้องทั้งหมดจากฟีด เนื่องจากต้องมีองค์ประกอบ <overall> และระบบจะไม่ยอมรับรีวิวหากไม่มีรีวิวดังกล่าว
collection_method ประเภทวิธีการเก็บรวบรวม ต้องระบุ (1) วิธีการที่ใช้ในการรวบรวมรีวิว ค่าต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
  • ไม่พึงประสงค์: ผู้ใช้ไม่ได้ตอบสนองต่อการร้องขอที่เฉพาะเจาะจงเมื่อส่งรีวิว
  • Point_of_sale: ผู้ใช้ส่งรีวิวเพื่อตอบสนองต่อการเชิญเมื่อผู้ใช้สั่งซื้อ
  • After_fulfillment: ผู้ใช้ส่งรีวิวในการตอบกลับการชักชวนหลังจากดําเนินการตามคําสั่งซื้อของผู้ใช้

ตัวอย่าง: 

  <collection_method>
    after_fulfillment
  </collection_method>

<ratings>

คำอธิบาย

มีคะแนนผู้ขายของผู้รีวิว หากไม่มีคะแนนสําหรับองค์ประกอบ <overall> ก็ควรยกเว้นรีวิวที่เกี่ยวข้องทั้งหมดจากฟีด เนื่องจากจําเป็นต้องมีองค์ประกอบ <overall> และระบบจะไม่ยอมรับรีวิวหากไม่มีรีวิวดังกล่าว

ประกอบด้วย

โปรดรวมองค์ประกอบต่อไปนี้ภายในองค์ประกอบการให้คะแนน

ชื่อ รูปแบบ จำนวนข้อผิดพลาด คำอธิบาย
overall ช่วงการให้คะแนน ต้องระบุ (1) คะแนนโดยรวมของผู้รีวิวสําหรับผู้ขาย

ตัวอย่าง: 

  <overall min="1" max="10">9</overall>
customer_service ช่วงการให้คะแนน ไม่บังคับ (0‐1) คะแนนคุณภาพการบริการลูกค้าของผู้ขายรายนี้

ตัวอย่าง: 

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

<deleted_reviews>

คำอธิบาย

คอนเทนเนอร์สําหรับรีวิวที่ลบไปแล้ว

ประกอบด้วย

ชื่อ รูปแบบ จำนวนข้อผิดพลาด คำอธิบาย
deleted_review -- ต้องระบุ (1‐n) มีองค์ประกอบที่เกี่ยวข้องกับรีวิวเดียวที่ถูกลบ

<deleted_review>

คำอธิบาย

ตรวจสอบรายการที่ลบไปแล้ว

แอตทริบิวต์

ชื่อ รูปแบบ จำนวนข้อผิดพลาด คำอธิบาย
id รหัส ต้องระบุ (1) ระบุรหัสของรีวิวที่ควรลบออกจากฟีด รหัสต้องตรงกับแอตทริบิวต์รหัสขององค์ประกอบ <review> ในไฟล์ฟีดใดก็ได้

ประกอบด้วย

ชื่อ รูปแบบ จำนวนข้อผิดพลาด คำอธิบาย
last_update_timestamp วันที่และเวลาที่มีเขตเวลา ต้องระบุ (1) เวลาที่มีการนํารีวิวออกจากระบบ

ตัวอย่าง: 

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

ตัวอย่าง

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