تتيح لك واجهة Products الفرعية إدارة مستودع منتجاتك آليًا في Google Merchant Center. يمكنك إنشاء المنتجات واستردادها وتعديلها وحذفها، ما يمنحك المرونة لدمج أنظمتك مباشرةً مع Google.
من المفاهيم الأساسية في Merchant API هو التمييز بين البيانات التي ترسلها والمنتج النهائي الذي تستخدمه Google. يوفّر هذا الفصل نموذجًا أوضح لدورة حياة بيانات المنتجات ويمنحك تحكّمًا أكثر دقة في معلومات منتجاتك. وتعكس واجهة برمجة التطبيقات ذلك من خلال مصدرَين رئيسيَّين:
ProductInput: تمثّل هذه السمة بيانات المنتجات الأولية التي ترسلها إلى مصدر بيانات معيّن. يمكنك اعتبارها الصف الذي تحمّله في ملف خلاصة أو البيانات التي ترسلها باستخدام طلب بيانات من واجهة برمجة التطبيقات قبل إجراء أي معالجة في Merchant Center. يمكنك استخدام هذا المورد لجميع عمليات الكتابة (insertوpatchوdelete).Product: هذا المورد مخصّص للقراءة فقط ويمثّل المنتج النهائي الذي تمت معالجته كما يظهر في Merchant Center وعلى مساحات عرض Google. ويتم إنشاؤه من مصدرProductInputأساسي واحد ومصادرProductInputتكميلية عددها صفر أو أكثر بعد تطبيق جميع قواعد الخلاصات وعمليات المعالجة. يتضمّن هذا المورد الحالة النهائية للمنتج وأي مشاكل في جودة البيانات. يمكنك استخدام هذا المرجع لجميع عمليات القراءة (getوlist).
يتم تحديد التنسيق والمتطلبات لجميع سمات المنتجات التي يتم إرسالها باستخدام المورد ProductInput في مواصفات بيانات المنتج.
الإجراءات التي تتيح واجهة Products sub-API تنفيذها
تتيح لك واجهة Products الفرعية تنفيذ المهام الرئيسية التالية. يمكنك الاطّلاع على الأدلّة للحصول على تعليمات مفصّلة وعيّنات من الرموز البرمجية لكل حالة استخدام.
- إضافة المنتجات وإدارتها: تعرَّف على كيفية إضافة منتجات جديدة إلى حسابك، وتقديم بيانات تكميلية للمنتجات الحالية، وحذف المنتجات التي توقفت عن بيعها.
- إجراء تعديلات متكرّرة على منتجاتك: تعرَّف على كيفية إجراء تعديلات جزئية فعّالة على سمات المنتجات التي تتغيّر باستمرار، مثل السعر ومدى التوفّر.
- عرض بيانات المنتجات ومشاكلها: تعرَّف على كيفية استرداد منتجاتك التي تمت معالجتها، والتحقّق من حالة الموافقة عليها في وجهات مختلفة، وتحديد أي مشاكل في جودة البيانات قد تؤثر في ظهورها.
قبل البدء
قبل استخدام واجهة Products الفرعية، يجب إنشاء مصدر بيانات واحد على الأقل لواجهة برمجة التطبيقات في حسابك على Merchant Center. يمكن لواجهة Products sub-API فقط إدراج المنتجات أو تعديلها في مصادر البيانات من النوع API. للحصول على التعليمات، يُرجى الاطّلاع على دليل إدارة مصادر بيانات واجهة برمجة التطبيقات لتحميل المنتجات.