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