الفهرس
DataSourcesService
(واجهة)FileUploadsService
(واجهة)CreateDataSourceRequest
(رسالة)DataSource
(رسالة)DataSource.Input
(تعداد)DataSourceReference
(رسالة)DeleteDataSourceRequest
(رسالة)FetchDataSourceRequest
(رسالة)FileInput
(رسالة)FileInput.FetchSettings
(رسالة)FileInput.FetchSettings.Frequency
(تعداد)FileInput.FileInputType
(تعداد)FileUpload
(رسالة)FileUpload.Issue
(رسالة)FileUpload.Issue.Severity
(تعداد)FileUpload.ProcessingState
(تعداد)GetDataSourceRequest
(رسالة)GetFileUploadRequest
(رسالة)ListDataSourcesRequest
(رسالة)ListDataSourcesResponse
(رسالة)LocalInventoryDataSource
(رسالة)MerchantReviewDataSource
(رسالة)PrimaryProductDataSource
(رسالة)PrimaryProductDataSource.Channel
(تعداد)PrimaryProductDataSource.DefaultRule
(رسالة)ProductReviewDataSource
(رسالة)PromotionDataSource
(رسالة)RegionalInventoryDataSource
(رسالة)SupplementalProductDataSource
(رسالة)UpdateDataSourceRequest
(رسالة)
DataSourcesService
خدمة لإدارة مصادر البيانات الأساسية والتكميلية والمستودع وغيرها يمكنك الاطّلاع على مزيد من المعلومات في مقالة المساعدة في Merchant Center.
CreateDataSource |
---|
تُنشئ هذه الإجراء إعدادات مصدر البيانات الجديد للحساب المحدّد.
|
DeleteDataSource |
---|
يؤدي هذا الإجراء إلى حذف مصدر بيانات من حسابك على Merchant Center.
|
FetchDataSource |
---|
تُجري هذه العملية عملية جلب البيانات على الفور (حتى خارج الجدول الزمني لجلب البيانات) من مصدر بيانات في حسابك على Merchant Center. إذا كنت بحاجة إلى استدعاء هذه الطريقة أكثر من مرة في اليوم، عليك استخدام خدمة "المنتجات" لتعديل بيانات منتجاتك بدلاً من ذلك. لا تعمل هذه الطريقة إلا على مصادر البيانات التي تتضمّن مجموعة إدخال ملف.
|
GetDataSource |
---|
يسترجع إعدادات مصدر البيانات للحساب المحدّد.
|
ListDataSources |
---|
يسرد الإعدادات لمصادر البيانات للحساب المحدّد.
|
UpdateDataSource |
---|
تعديل إعدادات مصدر البيانات الحالي سيتم حذف الحقول التي تم ضبطها في قناع التعديل ولكن لم يتم توفيرها في المورد.
|
FileUploadsService
خدمة لإدارة عمليات تحميل ملفات مصادر البيانات
GetFileUpload |
---|
الحصول على أحدث عملية تحميل لملف مصدر البيانات لا يُسمح بتحميل الملفات إلا باستخدام عنوان
|
CreateDataSourceRequest
رسالة طلب لطريقة CreateDataSource
الحقول | |
---|---|
parent |
مطلوب. الحساب الذي سيتم إنشاء مصدر البيانات هذا فيه التنسيق: |
data_ |
مطلوب. مصدر البيانات المطلوب إنشاؤه. |
DataSource
مصدر البيانات لحساب Merchant Center
الحقول | |
---|---|
name |
المعرّف اسم مصدر البيانات. التنسيق: |
data_ |
النتائج فقط. معرّف مصدر البيانات |
display_ |
مطلوب. اسم مصدر البيانات المعروض في واجهة مستخدم Merchant Center. |
input |
النتائج فقط. لتحديد نوع الإدخال لمصدر البيانات. استنادًا إلى الإدخال، قد لا تعمل بعض الإعدادات. يمكن إنشاء مصادر البيانات العامة فقط من خلال واجهة برمجة التطبيقات. |
file_ |
اختيارية: لا يتم استخدام الحقل إلا عند إدارة البيانات من خلال ملف. |
حقل الربط Type مطلوب. نوع مصدر البيانات يمكن أن يكون Type واحدًا فقط مما يلي: |
|
primary_ |
مصدر البيانات الأساسي للمنتجات داخل المتجر وعلى الإنترنت |
supplemental_ |
مصدر البيانات الإضافي للمنتجات داخل المتجر وعلى الإنترنت |
local_ |
مصدر بيانات المستودع داخل المتجر |
regional_ |
مصدر بيانات المستودع الإقليمي |
promotion_ |
مصدر بيانات العرض الترويجي. |
product_ |
مصدر بيانات مراجعة المنتج |
merchant_ |
مصدر بيانات مراجعة التاجر |
الإدخال
لتحديد نوع الإدخال في مصدر البيانات. استنادًا إلى الإدخال، قد لا تكون بعض الإعدادات متاحة.
عمليات التعداد | |
---|---|
INPUT_UNSPECIFIED |
الإدخال غير محدّد. |
API |
تمثّل مصادر البيانات التي يتم تقديم البيانات لها بشكل أساسي من خلال واجهة برمجة التطبيقات. |
FILE |
تمثّل مصادر البيانات التي يتم تقديم البيانات لها بشكل أساسي من خلال إدخال الملفات. وسيظل بإمكانك تقديم البيانات من خلال واجهة برمجة التطبيقات. |
UI |
مصدر بيانات المنتجات المُضافة مباشرةً في Merchant Center لا يمكن إنشاء هذا النوع من مصادر البيانات أو تعديله من خلال واجهة برمجة التطبيقات هذه، بل من خلال واجهة مستخدِم Merchant Center فقط. هذا النوع من مصادر البيانات مخصّص للقراءة فقط. |
AUTOFEED |
يُعرف ذلك أيضًا باسم الخلاصات المبرمَجة المستخدَمة لإنشاء بيانات المنتجات تلقائيًا. يمكن تفعيل هذا النوع من مصادر البيانات أو إيقافه من خلال حِزمة "الحسابات". |
DataSourceReference
يمكن استخدام مرجع مصدر البيانات لإدارة مصادر البيانات ذات الصلة ضمن خدمة مصدر البيانات.
الحقول | |
---|---|
حقل الربط يمكن أن يكون |
|
self |
يجب استخدام Self للإشارة إلى مصدر البيانات الأساسي نفسه. |
primary_ |
اختيارية: اسم مصدر البيانات الأساسي التنسيق: |
supplemental_ |
اختيارية: اسم مصدر البيانات التكميلية. التنسيق: |
DeleteDataSourceRequest
رسالة طلب لطريقة DeleteDataSource
الحقول | |
---|---|
name |
مطلوب. اسم مصدر البيانات المطلوب حذفه التنسيق: |
FetchDataSourceRequest
رسالة طلب لطريقة FetchDataSource
الحقول | |
---|---|
name |
مطلوب. اسم مورد مصدر البيانات الذي تريد استرجاعه. التنسيق: |
FileInput
البيانات الخاصة بمصادر بيانات الملفات يكون هذا الحقل فارغًا لإدخالات مصادر البيانات الأخرى.
الحقول | |
---|---|
fetch_ |
اختيارية: استرجاع التفاصيل لإرسال مصدر البيانات يحتوي على إعدادات لأنواع إدخال الملفات |
file_ |
اختيارية: اسم ملف مصدر البيانات. مطلوب لنوع إدخال ملف |
file_ |
النتائج فقط. نوع إدخال الملف |
FetchSettings
استرجاع التفاصيل لإرسال مصدر البيانات
الحقول | |
---|---|
enabled |
اختيارية: تفعيل جدول الجلب أو إيقافه مؤقتًا |
day_ |
اختيارية: يوم الشهر الذي يجب فيه جلب ملف مصدر البيانات (من 1 إلى 31). لا يمكن ضبط هذا الحقل إلا لعدد مرّات الظهور الشهري. |
time_ |
اختيارية: ساعة اليوم التي يجب فيها جلب ملف مصدر البيانات. لا يمكن استخدام الدقائق والثواني وسيتم تجاهلها. |
day_ |
اختيارية: يوم الأسبوع الذي يجب فيه جلب ملف مصدر البيانات. لا يمكن ضبط هذا الحقل إلا لعدد مرّات الظهور الأسبوعي. |
time_ |
اختيارية: المنطقة الزمنية المستخدَمة للجدول الزمني التوقيت العالمي المُنسّق (UTC) تلقائيًا على سبيل المثال، "America/Los_Angeles". |
frequency |
مطلوب. معدّل تكرار جدول الجلب |
fetch_ |
اختيارية: عنوان URL الذي يمكن من خلاله جلب ملف مصدر البيانات تتيح خدمة Google Merchant Center عمليات التحميل المُجدوَلة تلقائيًا باستخدام بروتوكول HTTP أو HTTPS أو SFTP، لذا يجب أن تكون القيمة رابطًا صالحًا باستخدام أحد هذه البروتوكولات الثلاثة. لا يمكن تغييرها في ملفات "جداول بيانات Google". |
username |
اختيارية: اسم مستخدم اختياري لـ |
password |
اختيارية: كلمة مرور اختيارية لـ " |
التردد
تختلف الحقول المطلوبة استنادًا إلى معدّل جلبها. بالنسبة إلى جدول جلب شهري، يجب توفير [يوم الشهر][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_month] و[ساعة اليوم][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day]. بالنسبة إلى جدول الجلب الأسبوعي، يجب توفير السمتَين [يوم الأسبوع][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_week] و[ساعة اليوم][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day]. لتحديد جدول زمني لجلب البيانات يوميًا، يجب فقط تحديد [ساعة اليوم][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day].
عمليات التعداد | |
---|---|
FREQUENCY_UNSPECIFIED |
لم يتم تحديد معدّل التكرار. |
FREQUENCY_DAILY |
يتمّ جلب البيانات كلّ يوم. |
FREQUENCY_WEEKLY |
ويتم جلب البيانات كل أسبوع. |
FREQUENCY_MONTHLY |
ويتمّ جلب البيانات كل شهر. |
FileInputType
طريقة إرسال الملفات.
عمليات التعداد | |
---|---|
FILE_INPUT_TYPE_UNSPECIFIED |
لم يتم تحديد نوع إدخال الملف. |
UPLOAD |
يتم تحميل الملف من خلال بروتوكول النقل الآمن للملفات (SFTP) أو Google Cloud Storage أو يدويًا في Merchant Center. |
FETCH |
يتم جلب الملف من fetch_uri الذي تم ضبطه. |
GOOGLE_SHEETS |
يتم جلب الملف من "جداول بيانات Google" المحدّد في fetch_uri . |
FileUpload
تحميل ملف لمصدر بيانات معيّن، أي نتيجة استرجاع مصدر البيانات في طابع زمني معيّن يتم احتسابه بشكل غير متزامن عند الانتهاء من معالجة مصدر البيانات. لا ينطبق إلا على مصادر بيانات الملفات.
الحقول | |
---|---|
name |
المعرّف اسم ملف تحميل مصدر البيانات. التنسيق: |
data_ |
النتائج فقط. معرّف مصدر البيانات |
processing_ |
النتائج فقط. حالة معالجة مصدر البيانات. |
issues[] |
النتائج فقط. قائمة المشاكل التي تحدث في مصدر البيانات |
items_ |
النتائج فقط. عدد العناصر في مصدر البيانات التي تمت معالجتها. |
items_ |
النتائج فقط. عدد العناصر التي تم إنشاؤها في مصدر البيانات |
items_ |
النتائج فقط. عدد العناصر في مصدر البيانات التي تم تعديلها |
upload_ |
النتائج فقط. التاريخ الذي تم فيه تحميل ملف مصدر البيانات. |
المشكلة
خطأ في مصدر البيانات، مثل "السعر غير صالح"
الحقول | |
---|---|
title |
النتائج فقط. عنوان المشكلة، على سبيل المثال، "العنصر كبير جدًا" |
description |
النتائج فقط. وصف الخطأ، على سبيل المثال، "يحتوي مصدر البيانات على سلع تحتوي على سمات كثيرة جدًا أو كبيرة جدًا. سيتم حذف هذه العناصر". |
code |
النتائج فقط. رمز الخطأ، على سبيل المثال، "validation/invalid_value". تعرِض هذه الدالة القيمة "؟" إذا كان الرمز غير معروف. |
count |
النتائج فقط. عدد مرات حدوث الخطأ في تحميل الملف |
severity |
النتائج فقط. درجة خطورة المشكلة |
documentation_ |
النتائج فقط. رابط إلى المستندات التي توضّح المشكلة بمزيد من التفاصيل، إذا كان متوفّرًا |
درجة الخطورة
درجة خطورة المشكلة
عمليات التعداد | |
---|---|
SEVERITY_UNSPECIFIED |
لم يتم تحديد مستوى الخطورة. |
WARNING |
المشكلة هي التحذير. |
ERROR |
المشكلة هي خطأ. |
ProcessingState
حالة معالجة مصدر البيانات.
عمليات التعداد | |
---|---|
PROCESSING_STATE_UNSPECIFIED |
لم يتم تحديد حالة المعالجة. |
FAILED |
تعذّرت معالجة مصدر البيانات أو كانت هناك أخطاء في جميع العناصر. |
IN_PROGRESS |
تتم معالجة مصدر البيانات. |
SUCCEEDED |
تمت معالجة مصدر البيانات بنجاح، ولكن قد تكون بعض العناصر قد احتوت على أخطاء. |
GetDataSourceRequest
رسالة طلب لطريقة GetDataSource
الحقول | |
---|---|
name |
مطلوب. اسم مصدر البيانات المطلوب استرجاعه التنسيق: |
GetFileUploadRequest
رسالة طلب لطريقة GetFileUploadRequest
الحقول | |
---|---|
name |
مطلوب. اسم ملف مصدر البيانات الذي يتم تحميله لاسترداده. التنسيق: |
ListDataSourcesRequest
رسالة طلب لطريقة ListDataSources
الحقول | |
---|---|
parent |
مطلوب. الحساب الذي تريد إدراج مصادر البيانات له. التنسيق: |
page_ |
اختيارية: الحد الأقصى لعدد مصادر البيانات التي سيتم عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة. الحد الأقصى للقيمة هو 1000، وسيتم تحويل القيم التي تزيد عن 1000 إلى 1000. إذا لم يتم تحديدها، سيتم عرض الحد الأقصى لعدد مصادر البيانات. |
page_ |
اختيارية: رمز مميّز للصفحة، تم تلقّيه من مكالمة عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى |
ListDataSourcesResponse
رسالة الاستجابة لطريقة ListDataSources
الحقول | |
---|---|
data_ |
مصادر البيانات من الحساب المحدّد |
next_ |
رمز مميّز يمكن إرساله على شكل |
LocalInventoryDataSource
مصدر بيانات المنتجات المتوفرة داخل المتجر
الحقول | |
---|---|
feed_ |
مطلوب. غير قابل للتغيير تصنيف الخلاصة للعروض التي يتم توفير المنتجات داخل المتجر لها. يجب أن يكون عدد الأحرف أقل من أو يساوي 20 حرفًا كبيرًا (A-Z) وأرقامًا (0-9) وشرطًا (-). راجِع أيضًا نقل البيانات إلى تصنيفات الخلاصات. |
content_ |
مطلوب. غير قابل للتغيير رمز اللغة المكوّن من حرفَين وفقًا لمعيار ISO 639-1 للعناصر التي يتوفّر لها مستودع داخل المتجر |
MerchantReviewDataSource
لا يحتوي هذا النوع على أي حقول.
مصدر بيانات مراجعات التجار
PrimaryProductDataSource
مصدر البيانات الأساسي للمنتجات داخل المتجر وعلى الإنترنت.
الحقول | |
---|---|
channel |
مطلوب. غير قابل للتغيير تحدِّد هذه السمة نوع قناة مصدر البيانات. |
countries[] |
اختيارية: البلدان التي قد تظهر فيها السلع يتم تمثيلها على شكل رمز CLDR للمنطقة. |
default_ |
اختيارية: إدارة القواعد التلقائية لمصدر البيانات في حال ضبطها، سيتم استبدال مصادر البيانات المرتبطة. |
feed_ |
اختيارية: غير قابل للتغيير تصنيف الخلاصة المحدّد على مستوى مصدر البيانات. يجب أن يكون عدد الأحرف أقل من أو يساوي 20 حرفًا كبيرًا (A-Z) وأرقامًا (0-9) وشرطة (-). راجِع أيضًا نقل البيانات إلى تصنيفات الخلاصات. يجب ضبط في حال ضبطها، لن يقبل مصدر البيانات سوى المنتجات التي تتطابق مع هذه المجموعة. في حال عدم ضبط هذه القيمة، سيقبل مصدر البيانات المنتجات بدون هذا القيد. |
content_ |
اختيارية: غير قابل للتغيير رمز اللغة المكوّن من حرفَين وفقًا لمعيار ISO 639-1 للعناصر في مصدر البيانات يجب ضبط في حال ضبطها، لن يقبل مصدر البيانات سوى المنتجات التي تتطابق مع هذه المجموعة. في حال عدم ضبط هذه القيمة، سيقبل مصدر البيانات المنتجات بدون هذا القيد. |
القناة
قناة مصدر البيانات
تُستخدَم القناة للتمييز بين مصادر البيانات لمجالات المنتجات المختلفة.
عمليات التعداد | |
---|---|
CHANNEL_UNSPECIFIED |
غير محدّد |
ONLINE_PRODUCTS |
منتج على الإنترنت |
LOCAL_PRODUCTS |
منتج محلّي |
PRODUCTS |
مصدر بيانات موحّد لكلٍّ من المنتجات في المتجر والمنتجات على الإنترنت ملاحظة: لا يمكن إدارة المنتجات من خلال واجهة برمجة التطبيقات لهذه القناة. |
DefaultRule
إدارة القواعد التلقائية لمصدر البيانات
الحقول | |
---|---|
take_ |
مطلوب. قائمة مصادر البيانات المرتبطة في القاعدة التلقائية يتم ترتيب هذه القائمة حسب الأولوية التلقائية للقاعدة في دمج البيانات. قد لا تتضمّن أيّ إشارات أو إشارات متعددة إلى يجب ألا تكون القائمة فارغة. لربط مصدر البيانات بالقاعدة التلقائية، عليك إضافة مرجع جديد إلى هذه القائمة (بترتيب تسلسلي). لإلغاء ربط مصدر البيانات بالقاعدة التلقائية، عليك إزالة المرجع المحدّد من هذه القائمة. سيؤدي تغيير ترتيب هذه القائمة إلى تغيير أولوية مصادر البيانات في القاعدة التلقائية. على سبيل المثال، عند تقديم القائمة التالية: [ |
ProductReviewDataSource
لا يحتوي هذا النوع على أي حقول.
مصدر بيانات مراجعات المنتجات
PromotionDataSource
مصدر بيانات العرض الترويجي.
الحقول | |
---|---|
target_ |
مطلوب. غير قابل للتغيير البلد المستهدَف المستخدَم كجزء من المعرّف الفريد يتم تمثيلها على شكل رمز CLDR للمنطقة. تتوفّر العروض الترويجية في بلدان محدّدة فقط. |
content_ |
مطلوب. غير قابل للتغيير رمز اللغة المكوّن من حرفَين وفقًا لمعيار ISO 639-1 للعناصر في مصدر البيانات |
RegionalInventoryDataSource
مصدر بيانات المستودع الإقليمي
الحقول | |
---|---|
feed_ |
مطلوب. غير قابل للتغيير تصنيف الخلاصة للعروض التي يتم توفير المستودع الإقليمي لها. يجب أن يكون عدد الأحرف أقل من أو يساوي 20 حرفًا كبيرًا (A-Z) وأرقامًا (0-9) وشرطة (-). راجِع أيضًا نقل البيانات إلى تصنيفات الخلاصات. |
content_ |
مطلوب. غير قابل للتغيير رمز اللغة المكوَّن من حرفَين وفقًا لمعيار ISO 639-1 للعناصر التي يتوفّر لها المستودع الإقليمي |
SupplementalProductDataSource
مصدر البيانات الإضافي للمنتجات داخل المتجر وعلى الإنترنت بعد الإنشاء، يجب التأكّد من ربط مصدر بيانات المنتجات التكميلية بمصدر بيانات منتجات أساسي واحد أو أكثر.
الحقول | |
---|---|
referencing_ |
النتائج فقط. قائمة (غير مرتبة وغير مكرّرة) بجميع مصادر البيانات الأساسية المرتبطة بمصدر البيانات هذا في القواعد التلقائية أو المخصّصة لا يمكن حذف مصدر البيانات الإضافي قبل إزالة جميع الروابط. |
feed_ |
اختيارية: غير قابل للتغيير تصنيف الخلاصة المحدّد على مستوى مصدر البيانات. يجب أن يكون عدد الأحرف أقل من أو يساوي 20 حرفًا كبيرًا (A-Z) وأرقامًا (0-9) وشرطًا (-). راجِع أيضًا نقل البيانات إلى تصنيفات الخلاصات. يجب ضبط ويجب ضبطها لمصادر البيانات التي تحتوي على في حال ضبطها، لن يقبل مصدر البيانات سوى المنتجات التي تتطابق مع هذه المجموعة. في حال عدم ضبط هذه القيمة، سيقبل مصدر البيانات المنتجات بدون هذا التقييد. |
content_ |
اختيارية: غير قابل للتغيير رمز اللغة المكوّن من حرفَين وفقًا لمعيار ISO 639-1 للعناصر في مصدر البيانات يجب ضبط في حال ضبطها، لن يقبل مصدر البيانات سوى المنتجات التي تتطابق مع هذه المجموعة. في حال عدم ضبط هذه القيمة، سيقبل مصدر البيانات المنتجات بدون هذا التقييد. |
UpdateDataSourceRequest
رسالة طلب لطريقة UpdateDataSource
الحقول | |
---|---|
data_ |
مطلوب. مورد مصدر البيانات المطلوب تعديله |
update_ |
مطلوب. قائمة حقول مصدر البيانات التي سيتم تعديلها سيتم حذف الحقول المحدّدة في قناع التعديل بدون قيمة محدّدة في النصّ من مصدر البيانات. لا يُسمَح بتقديم القيمة الخاصة "*" لاستبدال مصدر البيانات بالكامل. |