เอกสารนี้มีแนวทางสำหรับการสร้างแหล่งข้อมูลผลิตภัณฑ์ XML ในรูปแบบ Atom 0.3 เราได้เชื่อมโยงแอตทริบิวต์มาตรฐานกับส่วนต่างๆ ในข้อกำหนดอย่างเป็นทางการของ Atom 0.3 เพื่อช่วยคุณในการค้นหาข้อมูลเพิ่มเติมเกี่ยวกับส่วนประกอบจากตัวอย่างของเรา แม้จะมีตัวอย่างไฟล์ Atom 0.3 แต่ข้อมูลที่เราให้เกี่ยวกับตัว Atom 0.3 มีเพียงเล็กน้อย
หัวข้อที่ 1: Atom 0.3
ตามข้อกำหนดของ Atom 0.3 มีองค์ประกอบที่กำหนดไว้ล่วงหน้า 4 อย่างที่ระดับการป้อนข้อมูล คือ ชื่อ ลิงก์ รหัส และการแก้ไข แม้ว่าองค์ประกอบดังกล่าวจะเป็นตัวเลือกในมาตรฐาน Atom 0.3 แต่แหล่งข้อมูลผลิตภัณฑ์ยังจำเป็นต้องใช้องค์ประกอบเหล่านี้
แหล่งข้อมูลผลิตภัณฑ์จำเป็นต้องมีองค์ประกอบเพิ่มเติม เช่น ราคาและสภาพสินค้า หากต้องการรวมองค์ประกอบเหล่านี้และรายละเอียดเพิ่มเติมเกี่ยวกับผลิตภัณฑ์ เราได้ขยาย Atom 0.3 โดยการเพิ่มเนมสเปซใน Google Merchant Center การกำหนดเนมสเปซใน Google Merchant Center ช่วยให้คุณสามารถใช้องค์ประกอบเพิ่มเติมซึ่งเรียกว่า "แอตทริบิวต์" และเพิ่มปริมาณข้อมูลที่คุณสามารถระบุเกี่ยวกับผลิตภัณฑ์แต่ละรายการในแหล่งข้อมูลผลิตภัณฑ์
ด้านล่างเป็นตัวอย่างของเอกสาร Atom 0.3 ขั้นพื้นฐานที่มีผลิตภัณฑ์เดียว
<?xml version="1.0"?>
<feed version="0.3" xmlns="http://purl.org/atom/ns#"
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" /> <modified>2005-10-11T18:30:02Z</modified> <author> <name>Google</name> </author> <id>tag:google.com,2005-10-15:/support/products</id> <entry> <title>Red wool sweater</title> <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> <id>tag:google.com,2005-10-15:/support/products</id> <issued>2005-10-13T18:30:02Z</issued> <modified>2005-10-13T18:30:02Z</modified>
<g:image_link>http://example.com/image1.jpg</g:image_link> <g:price>25</g:price> <g:condition>new [ใหม่]</g:condition>
</entry> </feed>
การเพิ่มเติม 2 อย่างในตัวอย่างนี้ ได้แก่ การเพิ่มการประกาศเนมสเปซ (ในแถวที่ 3) และการรวมแอตทริบิวต์ 3 ประเภท (ลิงก์รูปภาพ [image_link]
, ราคา [price]
และสภาพสินค้า [condition]
)
การประกาศเนมสเปซของ Google Merchant Center
ต้องมีการประกาศเนมสเปซต่อไปนี้เพื่อใช้แอตทริบิวต์ที่กำหนดไว้เฉพาะในเนมสเปซของ Google Merchant Center
xmlns:g="http://base.google.com/ns/1.0"
นอกเหนือจากการประกาศเนมสเปซใน Google Merchant Center คุณต้องใส่คำนำหน้าภายในแท็กแอตทริบิวต์ทุกรายการ เราเพิ่มคำนำหน้านี้ในการแยกแยะแอตทริบิวต์ที่กำหนดไว้ในเนมสเปซของเราจากองค์ประกอบที่กำหนดไว้ใน Atom 0.3 คำนำหน้าที่เลือกสำหรับการประกาศเนมสเปซนี้คือ "g":
<g:image_link>http://example.com/image1.jpg</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 0.3 หรือในเนมสเปซของคุณเอง แต่ข้อมูลใดๆ ที่อยู่ในองค์ประกอบเหล่านี้จะถูกละเว้นในระหว่างการประมวลผลและจะไม่ปรากฏในข้อมูลของคุณ ในขณะนี้เราจะประมวลผลข้อมูลที่มีอยู่ในองค์ประกอบ Atom 0.3 เริ่มต้นและในแอตทริบิวต์ภายในของ Google Merchant Center และเนมสเปซที่กำหนดเองของ Google Merchant Center เท่านั้น