เอกสารนี้มีแนวทางสำหรับการสร้างแหล่งข้อมูลผลิตภัณฑ์ XML ในรูปแบบ Atom 1.0 เราได้ลิงก์แอตทริบิวต์มาตรฐานกับหัวข้อต่างๆ ในข้อกำหนดอย่างเป็นทางการเกี่ยวกับ Atom 1.0 เพื่อช่วยคุณค้นหาข้อมูลเพิ่มเติมเกี่ยวกับคอมโพเนนต์จากตัวอย่าง แม้จะมีตัวอย่างไฟล์ Atom 1.0 แต่ข้อมูลที่เราให้เกี่ยวกับ Atom 1.0 มีเพียงเล็กน้อย
หากคุณสนใจดูข้อมูลเพิ่มเติมเกี่ยวกับมาตรฐานนี้ เราขอแนะนำให้อ่านข้อกำหนดนี้ที่รูปแบบการเผยแพร่ Atom
หากต้องการดาวน์โหลดไฟล์ตัวอย่าง Atom 1.0 ให้คลิกที่นี่
หัวข้อที่ 1: Atom 1.0
ตามข้อกำหนดของ Atom 1.0 มีองค์ประกอบที่กำหนดไว้ล่วงหน้า 5 อย่างที่ระดับการป้อนข้อมูลได้แก่ ชื่อ รหัส ลิงก์ สรุป และอัปเดต แม้ว่าองค์ประกอบดังกล่าวจะเป็นตัวเลือกในมาตรฐาน Atom 1.0 แต่แหล่งข้อมูลผลิตภัณฑ์ยังจำเป็นต้องใช้องค์ประกอบเหล่านี้
แหล่งข้อมูลผลิตภัณฑ์จำเป็นต้องมีองค์ประกอบเพิ่มเติม เช่น ราคาและสภาพสินค้า หากต้องการรวมรายละเอียดเพิ่มเติมเกี่ยวกับสินค้า เราได้ขยาย Atom 1.0 โดยการเพิ่มเนมสเปซใน Google Merchant Center การกำหนดเนมสเปซใน Google Merchant Center ช่วยให้คุณสามารถใช้องค์ประกอบเพิ่มเติมซึ่งเรียกว่า "แอตทริบิวต์" และเพิ่มปริมาณข้อมูลที่คุณสามารถระบุเกี่ยวกับผลิตภัณฑ์แต่ละรายการในแหล่งข้อมูลผลิตภัณฑ์
ด้านล่างเป็นตัวอย่างของเอกสาร Atom 1.0 ขั้นพื้นฐานที่มีสินค้ารายการเดียว
<?xml version="1.0"?>
<feed xmlns="http://w3.org/2005/Atom"
xmlns:g="http://base.google.com/ns/1.0">
<title>The name of your product data source</title> <link href="http://example.com" rel="alternate" type="text/html" /> <updated>2006-06-11T18:30:02Z</updated> <author> <name>Google</name> </author>
<id>tag:example.com,2006-06-11:/support/products</id> <entry>
<title>Red wool sweater</title> <id>1a</id> <link href="http://example.com/item1-info-page.html" /> <summary>Comfortable and soft, this sweater will keep you warm on those cold winter nights.</summary>
<updated>2005-10-13T18:30:02Z</updated>
<g:image_link>http://google.com/images/google_sm.gif</g:image_link> <g:price>25</g:price> <g:condition>new</g:condition>
</entry> </feed>
การเพิ่มเติม 2 อย่างในตัวอย่างนี้ ได้แก่ การเพิ่มการประกาศเนมสเปซและการรวมแอตทริบิวต์ 3 ประเภท (ลิงก์รูปภาพ [image_link]
, ราคา [price]
และสภาพสินค้า [condition]
)
การประกาศเนมสเปซของ Google Merchant Center
ต้องมีการประกาศเนมสเปซต่อไปนี้เพื่อใช้แอตทริบิวต์ที่กำหนดไว้เฉพาะในเนมสเปซของ Google Merchant Center
xmlns:g="http://base.google.com/ns/1.0"
นอกเหนือจากการประกาศเนมสเปซใน Google Merchant Center คุณต้องใส่คำนำหน้าภายในแท็กแอตทริบิวต์ทุกรายการ เราเพิ่มคำนำหน้านี้ให้กับแอตทริบิวต์ต่างๆ เพื่อแยกแยะแอตทริบิวต์ที่กำหนดไว้ในเนมสเปซที่มาจากองค์ประกอบที่กำหนดไว้ใน Atom 1.0 คำนำหน้าที่เลือกสำหรับการประกาศเนมสเปซนี้คือ "g":
<g:image_link>
http://google.com/images/google_sm.gif</g:image_link>
แอตทริบิวต์ในเนมสเปซของ Google Merchant Center ต้องมีคำนำหน้านี้ มิเช่นนั้นแอตทริบิวต์และค่าใดๆ ที่มีอยู่จะถูกละเว้น
แอตทริบิวต์
คุณใช้แอตทริบิวต์ที่เกี่ยวข้องได้มากเท่าที่ต้องการตราบใดที่แอตทริบิวต์เหล่านั้นเจาะจงผลิตภัณฑ์ของคุณ การให้ข้อมูลเพิ่มเติมเกี่ยวกับผลิตภัณฑ์โดยใช้แอตทริบิวต์เหล่านี้จะช่วยเพิ่มโอกาสในการแสดงผลของผลิตภัณฑ์ในผลการค้นหา นอกจากนี้ คุณยังใช้แอตทริบิวต์ที่กำหนดไว้ในเนมสเปซของ Google Merchant Center ได้มากกว่า 1 ครั้งภายในผลิตภัณฑ์ 1 รายการ วิธีนี้จะช่วยให้คุณเพิ่มข้อมูลที่มีเกี่ยวกับผลิตภัณฑ์ในแหล่งข้อมูลผลิตภัณฑ์ได้
ส่วนที่ 2 รายการตรวจสอบที่สำคัญ
ก่อนที่จะส่งแหล่งข้อมูลผลิตภัณฑ์ เราขอแนะนำอย่างยิ่งให้คุณใช้รายการต่อไปนี้เพื่อตรวจสอบว่าไฟล์ได้รับการจัดรูปแบบอย่างถูกต้อง
ชื่อไฟล์ต้องลงท้ายด้วยนามสกุล .xml
ชื่อไฟล์แหล่งข้อมูลผลิตภัณฑ์ที่ลงทะเบียนในบัญชี Google Merchant Center ต้องตรงกับชื่อที่กำหนดให้กับไฟล์
อย่าลืมใส่การประกาศเนมสเปซ ค่าเหล่านี้ควรตรงกับตัวอย่างที่แสดงด้านล่าง
- เนมสเปซ Google Merchant Center:
xmlns:g="http://base.google.com/ns/1.0"
- เนมสเปซที่มีแอตทริบิวต์ที่กำหนดเอง:
xmlns:[prefix]="http://base.google.com/cns/1.0"
โดยแทนที่ [prefix] ด้วยคำนำหน้าที่ระบุไว้ในไฟล์
ยืนยันว่าคำนำหน้าที่มีอยู่ใน Google Merchant Center และแท็กแอตทริบิวต์ Google Merchant Center ที่กำหนดเองตรงกับคำนำหน้าที่กำหนดไว้ในการประกาศเนมสเปซ
นำแอตทริบิวต์ที่ไม่มีค่าใดๆ ออก
หัวข้อที่ 3: หมายเหตุสุดท้าย
รายการตัวอย่างที่รวมอยู่ในเอกสารฉบับนี้มีการปรับให้ง่ายขึ้นเพื่อให้เน้นข้อมูลพื้นฐานเกี่ยวกับการสร้างแหล่งข้อมูลผลิตภัณฑ์ XML ของ Google Merchant Center ได้ชัดเจนยิ่งขึ้น แม้ว่าเราจะยอมรับแหล่งข้อมูลผลิตภัณฑ์ที่มีองค์ประกอบอื่นๆ ซึ่งกำหนดไว้ในมาตรฐาน Atom 1.0 หรือในเนมสเปซของคุณเอง แต่ข้อมูลใดๆ ที่อยู่ในองค์ประกอบเหล่านี้จะถูกละเว้นในระหว่างการประมวลผล รวมทั้งจะไม่ปรากฏในโฆษณาหรือข้อมูลผลิตภัณฑ์ที่แสดงฟรี ขณะนี้เราจะประมวลผลเฉพาะข้อมูลที่มีอยู่ในองค์ประกอบ Atom 1.0 เริ่มต้น รวมถึงในแอตทริบิวต์ภายใน Google Merchant Center และเนมสเปซที่กำหนดเองของ Google Merchant Center เท่านั้น