نظرة عامة على واجهة برمجة التطبيقات لمصادر البيانات للتجّار

توضّح هذه الصفحة كيفية إنشاء مصادر البيانات وتعديلها آليًا لتتيح لك إدخال المنتجات. تسهِّل مصادر البيانات التلقائية إرسال بيانات منتجاتك إلى Google. تتأكد مصادر البيانات التلقائية من وصول أحدث المعلومات حول المنتجات ذات الصلة من موقعك الإلكتروني إلى Google.

تتيح لك Content API for Shopping إنشاء مصادر بيانات أساسية فقط. باستخدام واجهة برمجة تطبيقات مصادر بيانات التاجر، يمكنك إنشاء الأنواع التالية من مصادر البيانات:

سمحت Content API for Shopping بإدارة مصادر البيانات فقط من خلال إدخال ملف. تتيح لك واجهة Merchant API إدارة مصادر البيانات من خلال إدخالات الملفات وواجهة برمجة التطبيقات.

باستخدام واجهة برمجة تطبيقات مصادر بيانات التاجر، يمكنك إجراء ما يلي:

  • أنشِئ مصدر بيانات أساسيًّا جديدًا باستخدام feedLabel وcontentLanguage محدّدين.
  • أنشئ مصدر بيانات حرف بدل. لا يحتوي مصدر بيانات حرف البدل على حقلي feedLabel وcontentLanguage تم ضبطهما. تتيح لك مصادر بيانات أحرف البدل إدراج منتجات بمجموعات مختلفة من feedLabel وcontentLanguage في مصدر بيانات.
  • أنشِئ مصدر بيانات تكميليًا لربطه بمصدر بيانات أساسي حالي.
  • أعِد جدولاً زمنيًا لمصدر بيانات ملف.
  • إدارة مصادر بيانات واجهة برمجة التطبيقات
  • استخدِم أنواعًا أخرى من مصادر البيانات، مثل العروض الترويجية.

المتطلّبات الأساسية

  • ويجب أن يكون قد تم نقل حسابك إلى خلاصات محلية واحدة.

  • للتأكّد من أنّه سبق نقل الحساب إلى تقسيم استهداف البيانات، استخدِم قائمة مصادر البيانات أو احصل على الطرق. في حال عدم أهليتك، ستتلقّى رسالة الاستثناء التالية ويجب التواصل مع فريق الدعم.

    This account is in the data sources migration process and can't be used with
this API yet. Contact support for more info on when this account will be able
to use the data sources endpoint.

إنشاء مصدر بيانات جديد

لإنشاء مصدر بيانات أساسي جديد باستخدام feedLabel وcontentLanguage محدّدَين، يجب ضبط الحقلَين feedLabel وcontentLanguage في الإعدادات الخاصة بالنوع. مثلاً: PrimaryProductDataSource

للاطّلاع على مصدر البيانات الذي تمّ إنشاؤه حديثًا، أنشئ طلب GET أو LIST.

إنشاء مصدر بيانات أساسي لحرف بدل جديد

لإنشاء خلاصة أساسية جديدة بحرف بدل، يجب ضبط مصدر البيانات باستخدام PrimaryProductDataSource وعدم ضبط الحقلين feedLabel وcontentLanguage.

باستخدام Content API for Shopping، تم إنشاء مصدر بيانات واجهة برمجة تطبيقات واحد لك فقط. باستخدام واجهة برمجة التطبيقات لمصادر بيانات التاجر، يمكنك إنشاء مصادر بيانات متعددة لواجهة برمجة التطبيقات، ويمكن أن يكون بعضها حرف بدل.

يمكن أن تكون مصادر البيانات التي تتضمن إدخال واجهة برمجة التطبيقات فقط مصادر بيانات أحرف بدل. لا تتوافق مصادر بيانات أحرف البدل مع إدخالات الملفات.

إنشاء مصدر بيانات تكميلي وربطه بمصدر البيانات الأساسي

يمكنك استخدام مصادر البيانات التكميلية لإجراء تعديلات جزئية على بيانات المنتجات عن طريق إضافة المعرّف الفريد لمصدر البيانات كمَعلمة طلب بحث عند إجراء طلبات إلى الطريقتَين accounts.productInputs.insert وaccounts.productInputs.delete. يمكنك استخدام مصادر البيانات التكميلية فقط لتعديل المنتجات الحالية.

لإنشاء مصدر بيانات تكميلي، يمكنك ضبط مصدر بياناتك باستخدام SupplementalProductDataSource، ثم ربطه من خلال تعديل الحقل defaultRule في مصدر البيانات الأساسي.

لا يمكن أن تكون مصادر بيانات الملفات التكميلية مصادر بيانات أحرف بدل. يجب أن تكون دائمًا مصادر بيانات واجهة برمجة التطبيقات التكميلية مصادر بيانات أحرف بدل.

إعداد جدول زمني لمصدر بيانات ملفك

لإعداد جدول زمني لخلاصة الملفات، يجب ضبط مصدر بياناتك ليكون مصدرًا لبيانات الملف باستخدام حقل FileInput، ثم إعداد fetchsettings باستخدام الحقل FileInput.FetchSettings.

حذف مصدر بيانات

لحذف مصدر بيانات حالي من حسابك، استخدِم الطريقة accounts.dataSources.delete.

استرجاع مصدر البيانات

لاسترجاع ملف تم إعداده في مصدر البيانات، استخدِم الطريقة accounts.dataSources.fetch. تؤدي هذه الطريقة إلى تنفيذ استرجاع البيانات فورًا على مصدر بيانات من حسابك. تعمل هذه الطريقة فقط مع مصادر البيانات التي تتضمن مجموعة إدخال ملف.

الحصول على مصدر البيانات

للعثور على إعدادات مصدر البيانات لحسابك، استخدِم الطريقة accounts.dataSources.get.

سرد مصدر البيانات

لسرد إعدادات مصادر البيانات لحسابك، استخدِم الطريقة accounts.dataSources.list.

مصدر بيانات التصحيح

لتعديل إعدادات مصدر بيانات حالي، استخدِم الطريقة accounts.dataSources.patch.