إدارة منتجاتك

تتيح لك واجهة برمجة التطبيقات الفرعية "المنتجات" إدارة مستودع منتجاتك آليًا في 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. للحصول على التعليمات، يمكنك الاطّلاع على دليل إدارة مصادر بيانات واجهة برمجة التطبيقات لعمليات تحميل المنتجات.