สคีมา XML

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

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

คำอธิบาย

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

Attributes

ชื่อ รูปแบบ จำนวนข้อผิดพลาด คำอธิบาย
xmlns xs:string ต้องระบุ (1) โปรดฮาร์ดโค้ดค่าต่อไปนี้
http://schemas.google.com/merchant_reviews/5.0
xmlns:xsi xs:string ต้องระบุ (1) โปรดฮาร์ดโค้ดค่าต่อไปนี้
http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation xs:string ต้องระบุ (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 ราย

Attributes

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

ตัวอย่าง

<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 DateTimeWithTimeZone ต้องระบุ (1) เวลา/วันที่สร้างผู้ขาย ซึ่งไม่ควรมีการเปลี่ยนแปลง
last_update_timestamp DateTimeWithTimeZone ต้องระบุ (1) เวลา/วันที่อัปเดตผู้ขายครั้งล่าสุด หากมีการอัปเดตช่องใดช่องหนึ่งในองค์ประกอบ <merchant> สำหรับรหัสผู้ขายที่ระบุ ค่านี้จะต้องเปลี่ยนแปลงด้วย

<deleted_merchants>

คำอธิบาย

คอนเทนเนอร์สำหรับผู้ขายที่ถูกลบ

มี

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

<deleted_merchant>

คำอธิบาย

ผู้ขายที่ถูกลบ

Attributes

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

มี

ชื่อ รูปแบบ จำนวนข้อผิดพลาด คำอธิบาย
last_update_timestamp DateTimeWithTimeZone ต้องระบุ (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>

คำอธิบาย

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

Attributes

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

ตัวอย่าง 

<review id=132739 mid=1234>

mid รหัส ต้องระบุ (1) ตัวระบุของผู้ขายที่รีวิวนี้มีไว้ให้

มี

โปรดรวมองค์ประกอบต่อไปนี้ไว้ในองค์ประกอบรีวิว

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

ตัวอย่าง 

<reviewer_name>
  Joel
</reviewer_name>

create_timestamp DateTimeWithTimeZone ต้องระบุ (1) เวลา/วันที่ที่ผู้ใช้ส่งรีวิว ซึ่งไม่ควรมีการเปลี่ยนแปลง

ตัวอย่าง 

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

last_update_timestamp DateTimeWithTimeZone ต้องระบุ (1) เวลา/วันที่ที่มีการเปลี่ยนแปลงข้อมูลในองค์ประกอบ <review> ครั้งล่าสุด หากมีการอัปเดตช่องใดช่องหนึ่ง ในองค์ประกอบ <review> สำหรับรหัสรีวิวที่ระบุ ค่านี้จะต้องเปลี่ยนแปลงด้วย

ตัวอย่าง 

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

country_code CountryCode ต้องระบุ (1) ประเทศของผู้รีวิว หากมี ค่านี้คือประเทศที่มีการจัดส่งผลิตภัณฑ์หรือประเทศที่มีการให้บริการ หรือใช้ประเทศที่ผู้รีวิวอยู่ ณ เวลาที่เขียนรีวิว รหัสประเทศต้องอยู่ในรูปแบบ ISO 3166-1 alpha-2

ตัวอย่าง 

  <country_code>
    US
  </country_code>

title xs:string ไม่บังคับ (0-1) ชื่อของรีวิว ชื่อควรเป็นข้อความธรรมดาที่ไม่มีแท็ก HTML

ตัวอย่าง 

  <title>
    Great prices
  </title>

content xs:string ต้องระบุ (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 CollectionMethodType ต้องระบุ (1) วิธีการที่ใช้ในการรวบรวมรีวิว ค่าต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
  • ไม่ได้ร้องขอ: ผู้ใช้ไม่ได้ตอบสนองต่อการร้องขอที่เฉพาะเจาะจงเมื่อส่งรีวิว
  • point_of_sale: ผู้ใช้ส่งรีวิวเพื่อตอบสนองต่อการร้องขอเมื่อผู้ใช้ทำการสั่งซื้อ
  • after_fulfillment: ผู้ใช้ส่งรีวิวเพื่อตอบสนองต่อการร้องขอหลังจาก การดำเนินการตามคำสั่งซื้อของผู้ใช้

ตัวอย่าง 

  <collection_method>
    after_fulfillment
  </collection_method>

<ratings>

คำอธิบาย

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

มี

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

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

ตัวอย่าง 

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

customer_service RatingRange ไม่บังคับ (0-1) คะแนนที่ผู้รีวิวให้แก่คุณภาพการบริการลูกค้าของผู้ขายรายนี้

ตัวอย่าง 

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

<deleted_reviews>

คำอธิบาย

คอนเทนเนอร์สำหรับรีวิวที่ถูกลบ

มี

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

<deleted_review>

คำอธิบาย

รีวิวที่ถูกลบ

Attributes

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

มี

ชื่อ รูปแบบ จำนวนข้อผิดพลาด คำอธิบาย
last_update_timestamp DateTimeWithTimeZone ต้องระบุ (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>