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

หนังสือ: /product-review-feeds/_book.yaml

ชื่อ: การอ้างอิงสคีมา XML

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

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

สคีมา XML สําหรับฟีดรีวิวผลิตภัณฑ์มีเผยแพร่ที่นี่ http://www.google.com/shopping/reviews/schema/product/2.3/product_reviews.xsd

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

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

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

องค์ประกอบ <feed> มีองค์ประกอบเหล่านี้ตามลําดับที่แสดง

องค์ประกอบ รายการ ประเภท คำอธิบาย
<version> ต้องระบุ (1) xs:string ระบุว่าใช้สคีมาฟีดรีวิวผลิตภัณฑ์เวอร์ชันใดอยู่ ปัจจุบันรองรับเฉพาะ <version>2.3</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 ลิงก์ไปยังไอคอน Fav ของบริษัทของผู้เผยแพร่ รูปภาพควรมีขนาดไอคอน Fav ซึ่งก็คือ 16x16 พิกเซล รูปแบบรูปภาพควรเป็น GIF, JPG หรือ PNG

<reviews>

มีรีวิวผลิตภัณฑ์ องค์ประกอบ <reviews> มีองค์ประกอบเหล่านี้ ตามลําดับที่แสดง

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

<review>

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

องค์ประกอบ รายการ ประเภท คำอธิบาย
<review_id> ไม่บังคับ (1) nonEmptyStringType ตัวระบุถาวรที่ไม่ซ้ํากันสําหรับรีวิวผลิตภัณฑ์ในระบบของผู้เผยแพร่โฆษณา
<reviewer> ต้องระบุ (1) reviewerType ผู้เขียนรีวิวผลิตภัณฑ์
<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 เนื้อหาของรีวิว
<pros> ไม่บังคับ (1) xs:sequence มีข้อดีที่อิงตามความคิดเห็นของผู้ตรวจสอบ ไม่ใส่ข้อความสําเร็จรูป เช่น "pro:" ยกเว้นข้อความจะถูกเขียนโดยผู้ตรวจสอบ
<cons> ไม่บังคับ (1) xs:sequence มีข้อเสียตามความคิดเห็นของผู้รีวิว ไม่ใส่ข้อความสําเร็จรูป เช่น "con:" ยกเว้นข้อความจะถูกเขียนโดยผู้ตรวจสอบ
<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

มืออาชีพแต่ละรายจะคิดตามความคิดเห็นของผู้ตรวจสอบ มือโปรควรแสดงตามลําดับเดียวกันกับที่แสดง ไม่ใส่ข้อความสําเร็จรูป เช่น "pro:" ยกเว้นข้อความจะถูกเขียนโดยผู้ตรวจสอบ

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

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

<cons>

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

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

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

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

<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 (หมายเลขสินค้าการค้าสากล) ที่เชื่อมโยงกับผลิตภัณฑ์
<mpns> ต้องระบุ (MPN ควรรวมไว้เพื่ออํานวยความสะดวกในการจับคู่รีวิวหากผลิตภัณฑ์ที่เชื่อมโยงกับรีวิวไม่มี GTIN ที่กําหนดไว้ ต้องส่งพร้อมกับแบรนด์)

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

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

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

<gtins>

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

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

<mpns>

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

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

<skus>

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

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

<brands>

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

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

<asins>

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

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