การอ้างอิงสคีมา XML

สคีมา XML สำหรับฟีดรีวิวผลิตภัณฑ์ของ Google จะกำหนดโครงสร้างที่ยอมรับได้ ของฟีด XML สคีมา XML ใช้นามสกุลไฟล์ .xsd สคีมา XML จะกำหนดองค์ประกอบและแอตทริบิวต์ที่ปรากฏในเอกสาร XML ได้เช่นเดียวกับไฟล์ DTD

ดูข้อมูลเพิ่มเติมเกี่ยวกับสคีมา XML ได้จากข้อมูลเบื้องต้นเกี่ยวกับสคีมา XML นี้

คุณดูสคีมา XML สำหรับฟีดรีวิวผลิตภัณฑ์ได้ที่นี่ http://www.google.com/shopping/reviews/schema/product/2.4/product_reviews.xsd

คำอธิบายโครงสร้างฟีดที่กำหนดโดยสคีมานี้มีดังนี้ ในคำอธิบายนี้ ชื่อประเภทที่มีคำนำหน้า xs: หมายถึงประเภทสคีมา XML ในตัว ซึ่งอยู่ใน XML Namespace http://www.w3.org/2001/XMLSchema

ระบบของเราต้องการฟีดแบบเต็มเสมอ ระบบจะลบรีวิวที่ส่งไปก่อนหน้านี้ซึ่งไม่ได้รวมอยู่ในฟีดแบบสมบูรณ์ครั้งถัดไป ดังนั้น คุณควรส่งรีวิวทั้งหมดเสมอเมื่อส่งฟีด

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

องค์ประกอบ <feed> มีองค์ประกอบต่อไปนี้ตามลำดับที่ระบุ

องค์ประกอบ รายการ ประเภท คำอธิบาย
<version> ต้องระบุ (1) xs:string ระบุว่าใช้ ฟีดสคีมารีวิวผลิตภัณฑ์ เวอร์ชันใด ปัจจุบันรองรับเฉพาะ <version>2.4</version>
<aggregator> ไม่บังคับ (1) aggregatorType ผู้เผยแพร่โฆษณาอาจใช้ ผู้รวบรวมข้อมูลรีวิวเพื่อ จัดการรีวิวและ ระบุฟีด องค์ประกอบนี้ระบุ การใช้ผู้รวบรวมข้อมูลและ มีข้อมูล เกี่ยวกับผู้รวบรวมข้อมูล
<publisher> ต้องระบุ (1) publisherType ข้อมูลเกี่ยวกับ ผู้เผยแพร่โฆษณา ซึ่งอาจ เป็นผู้ค้าปลีก ผู้ผลิต บริษัท บริการรีวิว หรือ นิติบุคคลใดก็ตามที่ เผยแพร่รีวิวผลิตภัณฑ์
<reviews> ไม่บังคับ (1) xs:sequence ประกอบด้วยรีวิวผลิตภัณฑ์

<feed> กำหนดข้อจำกัดความไม่ซ้ำกันในองค์ประกอบที่ใช้ในฟีด

องค์ประกอบย่อย

<aggregator>

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

องค์ประกอบ รายการ ประเภท คำอธิบาย
<name> ต้องระบุ (1) nonEmptyStringType ชื่อผู้รวบรวมรีวิวผลิตภัณฑ์

<publisher>

ข้อมูลเกี่ยวกับผู้เผยแพร่ ซึ่งอาจเป็นผู้ค้าปลีก ผู้ผลิต บริษัทให้บริการรีวิว หรือนิติบุคคลใดก็ตามที่เผยแพร่รีวิวผลิตภัณฑ์ องค์ประกอบ <publisher> มีองค์ประกอบเหล่านี้ตามลำดับที่ระบุไว้

องค์ประกอบ รายการ ประเภท คำอธิบาย
<name> ต้องระบุ (1) nonEmptyStringType ชื่อผู้เผยแพร่เนื้อหาของรีวิวผลิตภัณฑ์
<favicon> ไม่บังคับ (1) httpUrlType ลิงก์ไปยัง favicon ของบริษัทของผู้เผยแพร่ รูปภาพควรมีขนาดเท่ากับ favicon คือ 16x16 พิกเซล รูปแบบรูปภาพควรเป็น GIF, JPG หรือ PNG

<reviews>

มีรีวิวผลิตภัณฑ์ องค์ประกอบ <reviews> มีองค์ประกอบต่อไปนี้ตามลำดับที่ระบุไว้

องค์ประกอบ รายการ ประเภท คำอธิบาย
<review> ต้องระบุ (1-ไม่จำกัด) reviewType รีวิวผลิตภัณฑ์ที่ไม่ซ้ำกันแต่ละรายการ หากรีวิวเกี่ยวข้องกับผลิตภัณฑ์หลายรายการในพื้นที่โฆษณาของผู้เผยแพร่โฆษณา ให้ระบุรีวิว 1 ครั้ง และใส่องค์ประกอบ <product> หลายรายการในองค์ประกอบ <products>

<review>

รีวิวผลิตภัณฑ์ที่ไม่ซ้ำกันแต่ละรายการ หากรีวิวเกี่ยวข้องกับผลิตภัณฑ์หลายรายการในพื้นที่โฆษณาของผู้เผยแพร่โฆษณา ให้ระบุรีวิว 1 ครั้ง และใส่องค์ประกอบ <product> หลายรายการในองค์ประกอบ <products> องค์ประกอบ <review> มีองค์ประกอบเหล่านี้ตามลำดับที่ระบุ

องค์ประกอบ รายการ ประเภท คำอธิบาย
<review_id> ต้องระบุ (1) nonEmptyStringType ตัวระบุที่ไม่ซ้ำกันแบบถาวรของรีวิวผลิตภัณฑ์ในระบบของผู้เผยแพร่โฆษณา
<reviewer> ต้องระบุ (1) reviewerType ผู้เขียนรีวิวผลิตภัณฑ์
<is_verified_purchase> ไม่บังคับ (1) xs:boolean ระบุว่ามีการยืนยันหรือไม่ว่าผู้รีวิวซื้อผลิตภัณฑ์ หรือไม่
<is_incentivized_review> ไม่บังคับ (1) xs:boolean ระบุว่าผู้รีวิวได้รับสิ่งจูงใจ ให้รีวิวผลิตภัณฑ์หรือไม่
<review_timestamp> ต้องระบุ (1) xs:dateTime

การประทับเวลาที่ระบุเวลาที่เขียนรีวิว

ตัวอย่างเช่น

2014-04-21T11:07:07-06:00
2014-04-21T18:00:00+01:00
2014-04-21T00:00:00Z
<title> ไม่บังคับ (1) nonEmptyStringType ชื่อของรีวิว
<content> ต้องระบุ (1) nonEmptyStringType เนื้อหาของรีวิว
<review_language> ไม่บังคับ (1) xs:string ภาษาของรีวิว (BCP 47)
<review_country> ไม่บังคับ (1) xs:string รหัสประเทศ (ISO 3166-1) ของผู้ตรวจสอบ
<pros> ไม่บังคับ (1) xs:sequence มีข้อดีตามความคิดเห็นของผู้รีวิว ละเว้นข้อความสำเร็จรูป เช่น "ข้อดี:" เว้นแต่ผู้รีวิวจะเป็นคนเขียน
<cons> ไม่บังคับ (1) xs:sequence มีข้อเสียตามความคิดเห็นของผู้รีวิว ละเว้นข้อความ มาตรฐาน เช่น "ข้อเสีย:" เว้นแต่จะเขียนโดยผู้รีวิว
<reviewer_images> ไม่บังคับ (1) xs:sequence มีลิงก์ไปยังรูปภาพของผลิตภัณฑ์ที่ผู้รีวิวจัดหาให้
<review_url> ต้องระบุ (1) reviewUrlType URL ของหน้า Landing Page ของรีวิว
<ratings> ต้องระบุ (1) xs:sequence มีการให้คะแนนที่เชื่อมโยงกับรีวิว
<products> ต้องระบุ (1) xs:sequence มีผลิตภัณฑ์ที่เชื่อมโยงกับรีวิว
<is_spam> ไม่บังคับ (1) xs:boolean ระบุว่ารีวิวถูกทำเครื่องหมายว่าเป็นสแปมในระบบของผู้เผยแพร่โฆษณาหรือไม่
<collection_method> ไม่บังคับ (1) collectionMethodType

วิธีการที่ใช้ในการรวบรวมรีวิว ค่าต้องเป็นค่าใดค่าหนึ่งต่อไปนี้

unsolicited
ผู้ใช้ไม่ได้ตอบสนองต่อการร้องขอที่เฉพาะเจาะจงเมื่อ ส่งรีวิว
post_fulfillment
ผู้ใช้ส่งรีวิวเพื่อตอบสนองต่อการร้องขอหลังจาก ดำเนินการตามคำสั่งซื้อของผู้ใช้แล้ว
<transaction_id> ไม่บังคับ (1) nonEmptyStringType ตัวระบุที่ไม่ซ้ำกันแบบถาวรสำหรับธุรกรรมที่เชื่อมโยงกับ รีวิวในระบบของผู้เผยแพร่โฆษณา รหัสนี้ใช้เพื่อระบุว่ารีวิวหลายรายการเชื่อมโยงกับธุรกรรมเดียวกัน

<reviewer>

ผู้เขียนรีวิวผลิตภัณฑ์ องค์ประกอบ <reviewer> มีองค์ประกอบต่อไปนี้ตามลำดับที่ระบุ

องค์ประกอบ รายการ ประเภท คำอธิบาย
<name> ต้องระบุ (1) reviewerNameType

ชื่อผู้เขียนรีวิว

ตัวอย่างเช่น

<name>Jane</name>
<reviewer_id> ไม่บังคับ (1) nonEmptyStringType

ตัวระบุที่ไม่ซ้ำกันแบบถาวรสำหรับผู้เขียนรีวิวในระบบของผู้เผยแพร่โฆษณา

ตัวอย่างเช่น

<reviewer_id>14295</reviewer_id>

<name>

ชื่อผู้เขียนรีวิว องค์ประกอบ <name> คือส่วนขยายของ nonEmptyStringType และมีชื่อหรือชื่อแทนของผู้รีวิว องค์ประกอบ <name> มีแอตทริบิวต์ต่อไปนี้

แอตทริบิวต์ รายการ ประเภท คำอธิบาย
is_anonymous ไม่บังคับ xs:boolean

ระบุว่าผู้รีวิวไม่ประสงค์จะออกนามหรือไม่

ตัวอย่างเช่น

<name is_anonymous="true">Anonymous</name>

<pros>

มีข้อดีตามความคิดเห็นของผู้รีวิว องค์ประกอบ <pros> มีองค์ประกอบต่อไปนี้ตามลำดับที่ระบุ

องค์ประกอบ รายการ ประเภท คำอธิบาย
<pro> ต้องระบุ (1-ไม่จำกัด) nonEmptyStringType

ข้อดีแต่ละข้อขึ้นอยู่กับความคิดเห็นของผู้รีวิว โดยควรระบุข้อดีตามลำดับที่แสดง ละเว้นข้อความสำเร็จรูป เช่น "ข้อดี:" เว้นแต่ผู้รีวิวจะเป็นคนเขียน

ตัวอย่างเช่น

<pros>
  <pro>Sleek design</pro>
</pros>

<cons>

มีข้อเสียตามความคิดเห็นของผู้รีวิว องค์ประกอบ <cons> มีองค์ประกอบต่อไปนี้ตามลำดับที่ระบุ

องค์ประกอบ รายการ ประเภท คำอธิบาย
<con> ต้องระบุ (1-ไม่จำกัด) nonEmptyStringType

ข้อเสียแต่ละข้อขึ้นอยู่กับความคิดเห็นของผู้รีวิว ควรแสดงข้อเสียตามลำดับเดียวกับที่แสดง ละเว้นข้อความสำเร็จรูป เช่น "ข้อเสีย:" เว้นแต่จะเขียนโดยผู้รีวิว

ตัวอย่างเช่น

<cons>
  <con>Pricey</con>
</cons>

<review_url>

URL ของหน้า Landing Page ของรีวิว องค์ประกอบ <review_url> เป็นส่วนขยาย ของ httpUrlType และมีลิงก์ไปยังหน้า Landing Page ของรีวิว องค์ประกอบ <review_url> มีแอตทริบิวต์ต่อไปนี้

แอตทริบิวต์ รายการ ประเภท คำอธิบาย
type จำเป็น xs:string

ประเภทต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้

singleton
หน้าแสดงรีวิวมีรีวิวนี้เพียงรายการเดียว
group
หน้าแสดงรีวิวมีกลุ่มรีวิวซึ่งรวมถึงรีวิวนี้

ตัวอย่างเช่น

<review_url type="singleton">http://www.example.com/review_5.html</review_url>

<reviewer_images>

มีรูปภาพของผลิตภัณฑ์ที่ผู้รีวิวจัดหาให้ แท็ก <reviewer_images> มีองค์ประกอบ <reviewer_image> จำนวนมาก

องค์ประกอบ รายการ ประเภท คำอธิบาย
<reviewer_image> ต้องระบุ (1-ไม่จำกัด) reviewImageType

รูปภาพของผลิตภัณฑ์ที่รีวิวซึ่งผู้เขียนรีวิวสร้างขึ้น

<reviewer_image>

องค์ประกอบรูปภาพรีวิวเดียว

องค์ประกอบ รายการ ประเภท คำอธิบาย
<url> ต้องระบุ (1) httpUrlType

URL ของรูปภาพผลิตภัณฑ์ที่ได้รับการรีวิวซึ่งสร้างโดยผู้เขียนรีวิว URL ไม่จำเป็นต้องลงท้ายด้วยนามสกุลไฟล์รูปภาพ

ตัวอย่างเช่น

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

มีการให้คะแนนที่เชื่อมโยงกับรีวิว องค์ประกอบ <ratings> มีองค์ประกอบต่อไปนี้ตามลำดับที่ระบุ

องค์ประกอบ รายการ ประเภท คำอธิบาย
<overall> ต้องระบุ (1) ratingType คะแนนโดยรวมของผลิตภัณฑ์ที่ผู้รีวิวให้

<overall>

คะแนนโดยรวมของผลิตภัณฑ์ที่ผู้รีวิวให้ องค์ประกอบ <overall> ขยาย xs:decimal simpleType และบันทึกคะแนนที่ผู้รีวิวมอบให้ ค่าควรอยู่ในช่วงที่รวมค่าที่กำหนดโดยแอตทริบิวต์ min และ max องค์ประกอบ <overall> มีแอตทริบิวต์ต่อไปนี้

แอตทริบิวต์ รายการ ประเภท คำอธิบาย
min จำเป็น xs:integer คะแนนต่ำสุดที่เป็นไปได้ ค่านี้ควรเป็นคะแนนที่แย่ที่สุด ที่เป็นไปได้ และไม่ควรเป็น ค่าสำหรับไม่มีการให้คะแนน
max จำเป็น xs:integer คะแนนสูงสุดที่เป็นไปได้ ค่าของแอตทริบิวต์ max ต้องมากกว่าค่าของแอตทริบิวต์ min

<products>

มีผลิตภัณฑ์ที่เชื่อมโยงกับรีวิว องค์ประกอบ <products> มีองค์ประกอบต่อไปนี้ตามลำดับที่ระบุ

องค์ประกอบ รายการ ประเภท คำอธิบาย
<product> ต้องระบุ (1-ไม่จำกัด) productType ผลิตภัณฑ์ที่เชื่อมโยงกับรีวิว

<product>

ผลิตภัณฑ์ที่เชื่อมโยงกับรีวิว องค์ประกอบ <product> มีองค์ประกอบต่อไปนี้ตามลำดับที่ระบุ

องค์ประกอบ รายการ ประเภท คำอธิบาย
<product_ids> ไม่บังคับ (1) productIdsType ตัวระบุที่เชื่อมโยงกับผลิตภัณฑ์
<product_name> ไม่บังคับ (1) nonEmptyStringType ชื่อที่สื่อความหมายของผลิตภัณฑ์
<product_url> ต้องระบุ (1) httpUrlType URL ของผลิตภัณฑ์ URL นี้อาจมีค่าเดียวกับองค์ประกอบ <review_url> หาก URL ของรีวิวและ URL ของผลิตภัณฑ์เหมือนกัน

<product_ids>

ตัวระบุที่เชื่อมโยงกับผลิตภัณฑ์ องค์ประกอบ <product_ids> มีองค์ประกอบต่อไปนี้ตามลำดับที่ระบุ

องค์ประกอบ รายการ ประเภท คำอธิบาย
<gtins> ต้องระบุ (สำหรับรีวิวทั้งหมดที่เชื่อมโยงกับผลิตภัณฑ์ที่มี GTIN ที่ทราบแล้ว)

ไม่บังคับสำหรับรีวิวอื่นๆ ทั้งหมด (1)		 gtinsType มี GTIN (หมายเลขสินค้าการค้าสากล) ที่เชื่อมโยงกับผลิตภัณฑ์ ระบบรองรับ GTIN ประเภทย่อย (เช่น UPC, EAN, ISBN, JAN)
<mpns> ต้องระบุ (สำหรับรีวิวทั้งหมดที่เชื่อมโยงกับผลิตภัณฑ์ที่มี MPN ที่ทราบ)

ไม่บังคับสำหรับรีวิวอื่นๆ ทั้งหมด (1)		 mpnsType มี MPN (หมายเลขชิ้นส่วนของผู้ผลิต) ที่เชื่อมโยงกับผลิตภัณฑ์
<skus> ต้องระบุ (สำหรับรีวิวทั้งหมดที่เชื่อมโยงกับผลิตภัณฑ์ที่มี SKU ที่ทราบ)

ไม่บังคับสำหรับรีวิวอื่นๆ ทั้งหมด (1)		 skusType มี SKU (สต็อกคีปปิ้งยูนิต) ที่เชื่อมโยงกับผลิตภัณฑ์ ซึ่งมักจะตรงกับรหัสข้อเสนอผลิตภัณฑ์ในฟีดผลิตภัณฑ์
<brands> ต้องระบุ (สำหรับรีวิวทั้งหมดที่เชื่อมโยงกับผลิตภัณฑ์ที่มีแบรนด์ที่รู้จัก)

ไม่บังคับสำหรับรีวิวอื่นๆ ทั้งหมด (1)		 brandsType มีชื่อแบรนด์ที่เชื่อมโยงกับผลิตภัณฑ์
<asins> ไม่บังคับ (1) asinsType มี ASIN (หมายเลขประจำตัวมาตรฐานของ Amazon) ที่เชื่อมโยงกับผลิตภัณฑ์

<gtins>

มี GTIN (หมายเลขสินค้าการค้าสากล) ที่เชื่อมโยงกับผลิตภัณฑ์ องค์ประกอบ <gtins> มีองค์ประกอบต่อไปนี้ตามลำดับที่ระบุ

องค์ประกอบ รายการ ประเภท คำอธิบาย
<gtin> ต้องระบุ (1-ไม่จำกัด) nonEmptyStringType หมายเลขสินค้าการค้าสากลของผลิตภัณฑ์ ระบบรองรับ GTIN ประเภทย่อย (เช่น UPC, EAN, ISBN, JAN)

<mpns>

มี MPN (หมายเลขชิ้นส่วนของผู้ผลิต) ที่เชื่อมโยงกับผลิตภัณฑ์ องค์ประกอบ <mpns> มีองค์ประกอบต่อไปนี้ตามลำดับที่ระบุ

องค์ประกอบ รายการ ประเภท คำอธิบาย
<mpn> ต้องระบุ (1-ไม่จำกัด) nonEmptyStringType หมายเลขชิ้นส่วนของผู้ผลิตของผลิตภัณฑ์

<skus>

มี SKU (สต็อกคีปปิ้งยูนิต) ที่เชื่อมโยงกับผลิตภัณฑ์ องค์ประกอบ <skus> มีองค์ประกอบต่อไปนี้ตามลำดับที่ระบุ

องค์ประกอบ รายการ ประเภท คำอธิบาย
<sku> ต้องระบุ (1-ไม่จำกัด) nonEmptyStringType สต็อกคีปปิ้งยูนิตของผลิตภัณฑ์ในพื้นที่โฆษณาของผู้เผยแพร่โฆษณา

<brands>

มีชื่อแบรนด์ที่เชื่อมโยงกับผลิตภัณฑ์ องค์ประกอบ <brands> มีองค์ประกอบต่อไปนี้ตามลำดับที่ระบุ

องค์ประกอบ รายการ ประเภท คำอธิบาย
<brand> ต้องระบุ (1-ไม่จำกัด) nonEmptyStringType ชื่อแบรนด์ของผลิตภัณฑ์

<asins>

มี ASIN (หมายเลขประจำตัวมาตรฐานของ Amazon) ที่เชื่อมโยงกับ ผลิตภัณฑ์ องค์ประกอบ <asins> มีองค์ประกอบต่อไปนี้ตามลำดับที่ระบุ

องค์ประกอบ รายการ ประเภท คำอธิบาย
<asin> ต้องระบุ (1-ไม่จำกัด) nonEmptyStringType หมายเลขประจำตัวมาตรฐานของ Amazon สำหรับผลิตภัณฑ์ ASIN แต่ละรายการมีความยาว 10 อักขระและเป็นตัวอักษรและตัวเลขคละกัน