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