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

تعرض هذه الصفحة كيفية إنشاء مصادر البيانات وتعديلها آليًا. إدراج المنتجات البيانات المبرمَجة المصادر تسهّل إرسال بيانات منتجاتك إلى 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 .