يوفر هذا المستند الإرشادات اللازمة لإنشاء مصدر XML لبيانات المنتج بتنسيق Atom 1.0. لقد ربطنا السمات القياسية بأقسامها في مواصفات Atom 1.0 الرسمية لمساعدتك في العثور على معلومات إضافية عن المكوّنات من أمثلتنا. على الرغم من أننا نقدم أمثلة على ملفات Atom 1.0، إلا أننا نوفّر الحد الأدنى من التفاصيل عن تنسيق Atom 1.0 نفسه.
إذا أردت الحصول على المزيد من المعلومات عن هذا المعيار، نقترح عليك الاطّلاع على هذه المواصفات بالانتقال إلى الرابط تنسيق مشاركة Atom.
لتنزيل عيّنة من ملف Atom 1.0، يُرجى النقر هنا.
القسم 1: تنسيق Atom 1.0
استنادًا إلى مواصفات تنسيق Atom 1.0، تتوفّر خمسة عناصر محددة مسبقًا على مستوى الإدخال، وهي: العنوان والمعرّف والرابط والملخص والتحديث. على الرغم من أنّ هذه العناصر اختيارية في معيار Atom 1.0، إلا أنها مطلوبة في مصادر بيانات المنتج.
تتطلّب مصادر بيانات المنتج أيضًا توفُّر عناصر إضافية، مثل السعر والحالة. ولإتاحة تضمين معلومات أكثر تفصيلاً عن سلعة معيّنة، وسّعنا معيار Atom 1.0 من خلال إضافة مساحة الاسم في Google Merchant Center. يتيح لك تحديد مساحة الاسم في Google Merchant Center استخدام عناصر إضافية تُسمّى "السمات" ويزيد من مقدار المعلومات التي يمكنك تقديمها حول كل منتج في مصدر بيانات المنتج.
في ما يلي مثال على مستند Atom 1.0 أساسي يحتوي على سلعة واحدة:
<?xml version="1.0"?>
<feed xmlns="http://www.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://www.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://www.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://www.google.com/images/google_sm.gif</g:image_link> <g:price>25</g:price> <g:condition>new</g:condition>
</entry> </feed>
يعكس هذا المثال إضافتَين أساسيتَين، هما بيان مساحة الاسم وتضمين ثلاث سمات هي (رابط الصورة [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://www.google.com/images/google_sm.gif</g:image_link>
يجب أن تتضمن السمات الواردة في مساحة الاسم في Google Merchant Center هذه البادئة أو السمات، وسيتم تجاهل أي قيم مضمّنة.
السمات
يمكنك استخدام العدد الذي تريده من السمات ذات الصلة بمنتجاتك. وعند توفير معلومات إضافية عن منتجاتك باستخدام هذه السمات، تزيد فرص ظهور المنتجات بشكل كبير في النتائج. بالإضافة إلى ذلك، يمكن استخدام العديد من السمات المحدّدة في مساحة الاسم في Google Merchant Center أكثر من مرة واحدة ضمن المنتج نفسه. يتيح لك ذلك إضافة المزيد من المعلومات المتوفّرة عن أحد المنتجات في مصدر بيانات منتجك.
القسم 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 وCustom Google Merchant Center مع البادئة المحددة في تعريف مساحة الاسم.
أزل السمات التي لا تحتوي على أي قيم.
القسم 3: الملاحظة النهائية
تم تبسيط إدخال النموذج المضمَّن في هذا المستند للسماح بالتركيز بشكل أوضح على أساسيات إنشاء مصدر XML لبيانات المنتج في Google Merchant Center. على الرغم من أنّنا نقبل مصادر بيانات المنتج التي تحتوي على عناصر أخرى محددة في معيار Atom 1.0 أو في مساحة الاسم الخاصة بك، سيتم تجاهل أي معلومات تحتوي عليها هذه العناصر أثناء المعالجة ولن تظهر في إعلاناتك أو بيانات المنتج المجانية. وسنعالج في هذا الوقت فقط البيانات المضمّنة في عناصر Atom 1.0 التلقائية وفي السمات المدرَجة ضمن مساحات الأسماء العادية والمخصصة في Google Merchant Center.