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