توضّح هذه الصفحة كيفية تحميل منتجاتك وإدارتها آليًا. باستخدام Merchant Products API، يمكنك إدراج منتج أو تعديله في مصدر بيانات، واسترداد منتج من حسابك، وحذف منتج من مصدر بيانات.
يمكنك استخدام المرجع products لإنشاء كتالوج متجر على الإنترنت، وهو عبارة عن قائمة بالمنتجات المتوفّرة في إعلانات Shopping. يمكنك استخدام مورد products
بعد إنشاء حسابك على Merchant Center، وتصبح جاهزًا لتحميل
مجموعة أولية من المنتجات من خلال واجهة برمجة التطبيقات.
تقع على عاتقك مسؤولية الالتزام بسياسات إعلانات Shopping والبيانات المجانية. وتحتفظ "إعلانات Shopping" بالحق في فرض هذه السياسات والاستجابة بشكل مناسب في حال العثور على محتوى أو سلوك يخالف هذه السياسات.
يحمّل المورد products معلومات المنتجات إلى قاعدة بيانات Shopping Merchant Center. ويوفّر كذلك عددًا من الطرق التي تتيح لك الوصول إلى معلومات المنتجات أو تعديلها أو حذفها واحدًا تلو الآخر أو عدة طرق في كل مرة من خلال وضع الدفعة.
يمثّل المورد productInput
بيانات الإدخال التي ترسلها لمنتج معيّن. يجب أن يحتوي مورد productInput
على الحقول التالية:
channel: قناة المنتج.offerId: المعرّف الفريد للمنتج هذه القيمة هي نفسها لإدخالات المنتج والمنتج الذي تمت معالجته.contentLanguage: تمثّل هذه السمة رمز اللغة المكوَّن من حرفين وفقًا لمعيار ISO 639-1 للمنتج.feedLabel: تصنيف الخلاصة للمنتج
يستطيع التجّار تحميل المنتجات باستخدام ملف يُعرَف باسم الخلاصة الأساسية، ولكن تتوفر مزايا متعددة لإنشاء المنتجات وحذفها باستخدام Merchant API. وتشمل هذه المزايا وقت استجابة أسرع وإمكانية تعديل منتجات متعددة في الوقت الفعلي، بدون الحاجة إلى إدارة عدة خلاصات تكميلية. قد يستغرق ظهور التغييرات التي أُجريت من خلال طلبات البيانات من واجهة برمجة التطبيقات في قاعدة بيانات Shopping Merchant Center عدة ساعات.
يمكن أن تساعد Google في الحفاظ على سمات معيّنة لمنتجاتك تلقائيًا. ولمزيد من المعلومات، يُرجى الاطّلاع على تفعيل التحسينات التلقائية.
المتطلبات الأساسية
إذا لم يكن لديك مصدر بيانات، يمكنك إنشاء مصدر بيانات باستخدام Merchant Data sources API أو Merchant Center.
إذا كان لديك مصدر بيانات أنشأته إما باستخدام واجهة مستخدم Merchant Center أو باستخدام واجهة برمجة التطبيقات، يمكنك استخدام Merchant Products API لإضافة منتجاتك. إذا كنت تستخدم Content API في Shopping لإضافة منتجات، يُرجى مراجعة دليل نقل البيانات للاطّلاع على كيفية البدء باستخدام Merchant Products API.
تحميل بيانات المنتج إلى حسابك
لتحميل بيانات إدخال منتج إلى حسابك، استخدِم طريقة
accounts.productInputs.insert. يجب إدخال المعرّف الفريد لمصدر البيانات الأساسي أو التكميلي لإدراج منتج باستخدام Merchant Products API.
استرداد منتج تمت معالجته من حسابك
لاسترداد منتج تمّت معالجته من حسابك، يمكنك استخدام طريقة
accounts.products.get. قد يستغرق ظهور المنتج الذي تمت معالجته بعد الإدراج عدة دقائق.
حذف إدخال منتج من حسابك
لحذف إدخال منتج من حسابك، استخدِم طريقة
accounts.productInputs.delete. عليك تمرير المعرّف الفريد لمصدر البيانات الأساسي أو التكميلي الذي ينتمي إليه المنتج لحذف منتج باستخدام Merchant Products API.
إدراج منتجات من حسابك
لإدراج المنتجات التي تمّت معالجتها في حسابك، استخدِم الطريقة accounts.products.list.