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

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

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

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

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

defaultRule {
 takeFromDataSources: [
   '1001', // Supplemental product data source
   'self', //  Self reference to the primary data source
   '1002' // Supplemental product data source
 ]
}

ملاحظة: لا يمكن تعديل القواعد المخصّصة من خلال واجهة برمجة التطبيقات.

الإدارة التلقائية للخلاصات

لتسجيل حسابك في الإدارة التلقائية لمصادر البيانات، عليك إجراء ما يلي: التالي:

• تحقَّق مما إذا كان حسابك مؤهلاً للتسجيل من خلال الاتصال على طريقة Accounts.AutofeedSettings.Get.
• تأكَّد من أنّ حسابك ليس سوقًا. الحساب.

بعد أن يصبح حسابك مؤهلاً للتسجيل، يمكنك استخدام طريقة Accounts.AutofeedSettings.Update لتفعيل الإدارة التلقائية للبيانات المصادر. يؤدي تفعيل الإدارة التلقائية لمصادر البيانات إلى السماح لمحرّك بحث Google تلقائيًا. إضافة منتجاتك من متجرك على الإنترنت والتأكّد من أنّها حديثة دائمًا على منصات Google.

استرداد حالة تحميل الملف

للحصول على حالة مصدر البيانات باستخدام ملف أو جلب أو جدول بيانات، يجب يمكنك استدعاء طريقة GET لخدمة FileUpload. للحصول على نتيجة آخر استرجاع لمصدر البيانات محسوبًا بشكل غير متزامن عندما تكون البيانات انتهت معالجة المصدر. استخدِم معرّف الاسم latest.

GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest

ويمكن أن تتضمّن حالة تحميل الملف عرضًا تفصيليًا لمنتجاتك، بما في ذلك: وأي مشكلات محتملة.

يُرجى العِلم أنّ حالة تحميل الملف قد لا تكون متوفّرة إذا لم يتم تحميله مطلقًا. قد تكون حالة تحميل الملف قيد المعالجة إذا تم طلبها بعد وقت قصير يتم تحميل الملف.