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

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

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

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

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

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

لا يمكنك استخدام Merchant API لإدراج منتجات في مصدر بيانات يحتوي على كل من المنتجات في المتاجر المحلية والمنتجات على الإنترنت. لمزيد من المعلومات حول قنوات مصادر البيانات، يُرجى الاطّلاع على القنوات.

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

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

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

    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.

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

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

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

لمزيد من المعلومات عن إنشاء مصدر بيانات، يُرجى الاطّلاع على الإجراء accounts.dataSources.create .

للاطّلاع على مصدر البيانات الذي تم إنشاؤه حديثًا، يمكنك استخدام accounts.dataSources.get أو accounts.dataSources.list .

إنشاء مصدر بيانات أساسي جديد يساعد على استهداف بلدان متعدّدة

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

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

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

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

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

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

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

يجب أن تحتوي مصادر بيانات الملفات التكميلية على feedLabel وcontentLanguage. مجموعة الحقول. يجب أن تحتوي مصادر بيانات واجهة برمجة التطبيقات التكميلية على feedLabel تم إلغاء ضبط حقلَين (contentLanguage).

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

لإعداد جدول زمني لخلاصة الملف، يجب ضبط مصدر البيانات على شكل ملف. مصدر البيانات باستخدام الحقل 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.updateAutofeedSettings لتفعيل الإدارة التلقائية لمصادر البيانات. يتيح تفعيل ميزة الإدارة التلقائية لمصادر البيانات لمحرّك بحث Google إضافة منتجاتك تلقائيًا من متجرك على الإنترنت والتأكّد من أنّها محدّثة دائمًا على منصات Google.

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

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

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

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

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