- المورد: DataSource
- PrimaryProductDataSource
- القناة
- SupplementalProductDataSource
- LocalInventoryDataSource
- RegionalInventoryDataSource
- PromotionDataSource
- الإدخال
- FileInput
- FetchSettings
- TimeOfDay
- DayOfWeek
- معدل التكرار
- FileInputType
- الطُرق
المرجع: DataSource
مصدر البيانات لحساب Merchant Center.
تمثيل JSON |
---|
{ "name": string, "dataSourceId": string, "displayName": string, "input": enum ( |
الحقول | |
---|---|
name |
المُعرّف. اسم مصدر البيانات. تنسيق الملف: |
dataSourceId |
النتائج فقط. رقم تعريف مصدر البيانات. |
displayName |
مطلوب. اسم مصدر البيانات المعروض في واجهة مستخدم Merchant Center. |
input |
النتائج فقط. تحدد نوع الإدخال لمصدر البيانات. استنادًا إلى الإدخال، قد لا تعمل بعض الإعدادات. يمكن إنشاء مصادر البيانات العامة فقط من خلال واجهة برمجة التطبيقات. |
fileInput |
اختياريّ. لا يتم استخدام هذا الحقل إلا عندما تتم إدارة البيانات من خلال ملف. |
حقل الاتحاد Type . نوع مصدر البيانات. يمكن أن يكون Type واحدًا فقط مما يلي: |
|
primaryProductDataSource |
مطلوب. مصدر البيانات الأساسي للمنتجات المحلية والمعروضة على الإنترنت: |
supplementalProductDataSource |
مطلوب. مصدر البيانات التكميلي للمنتجات المحلية والمعروضة على الإنترنت: |
localInventoryDataSource |
مطلوب. مصدر البيانات المنتجات المتوفرة داخل المتجر |
regionalInventoryDataSource |
مطلوب. مصدر بيانات المستودع الإقليمي |
promotionDataSource |
مطلوب. مصدر بيانات العرض الترويجي. |
PrimaryProductDataSource
مصدر البيانات الأساسي للمنتجات المحلية والإلكترونية.
تمثيل JSON |
---|
{
"channel": enum ( |
الحقول | |
---|---|
channel |
مطلوب. غير قابل للتغيير. تحدّد نوع قناة مصدر البيانات. |
countries[] |
اختياريّ. البلدان التي قد يتم عرض السلع فيها. ويتم تمثيله كرمز CLDR للمنطقة |
feedLabel |
اختياريّ. غير قابل للتغيير. تصنيف الخلاصة المحدّد على مستوى مصدر البيانات يجب أن يكون أقل من أو يساوي 20 حرفًا كبيرًا (A-Z) وأرقامًا (0-9) وشُرطًا (-). راجِع أيضًا نقل البيانات إلى تصنيفات الخلاصات. يجب ضبط السمة في حال ضبط هذه السياسة، لن يقبل مصدر البيانات سوى المنتجات التي تتطابق مع هذه التركيبة. في حال ترك هذه السياسة بدون ضبط، سيقبل مصدر البيانات المنتجات التي لا تسري عليها هذه القيود. |
contentLanguage |
اختياريّ. غير قابل للتغيير. تمثّل هذه السمة اللغة المكوَّنة من حرفين وفقًا لمعيار ISO 639-1 للعناصر المتوفّرة في مصدر البيانات. يجب ضبط كل من في حال ضبط هذه السياسة، لن يقبل مصدر البيانات سوى المنتجات التي تتطابق مع هذه التركيبة. في حال ترك هذه السياسة بدون ضبط، سيقبل مصدر البيانات المنتجات التي لا تسري عليها هذه القيود. |
القناة
قناة مصدر البيانات.
تُستخدَم القناة للتمييز بين مصادر البيانات لفئات المنتجات المختلفة.
عمليات التعداد | |
---|---|
CHANNEL_UNSPECIFIED |
لم يتم تحديده. |
ONLINE_PRODUCTS |
منتج على الإنترنت. |
LOCAL_PRODUCTS |
منتج محلّي. |
PRODUCTS |
مصدر بيانات موحد لكل من المنتجات المحلية والإلكترونية. ملاحظة: لا يمكن لهذه القناة إدارة المنتجات من خلال واجهة برمجة التطبيقات. |
SupplementalProductDataSource
مصدر البيانات التكميلي للمنتجات المحلية والإلكترونية:
تمثيل JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
الحقول | |
---|---|
feedLabel |
اختياريّ. غير قابل للتغيير. تصنيف الخلاصة المحدّد على مستوى مصدر البيانات يجب أن يكون أقل من أو يساوي 20 حرفًا كبيرًا (A-Z) وأرقامًا (0-9) وشُرطًا (-). راجِع أيضًا نقل البيانات إلى تصنيفات الخلاصات. يجب ضبط السمة في حال ضبط هذه السياسة، لن يقبل مصدر البيانات سوى المنتجات التي تتطابق مع هذه التركيبة. في حال ترك هذه السياسة بدون ضبط، سيقبل مصدر البيانات المنتجات بدون هذا القيد. |
contentLanguage |
اختياريّ. غير قابل للتغيير. تمثّل هذه السمة اللغة المكوَّنة من حرفين وفقًا لمعيار ISO 639-1 للعناصر المتوفّرة في مصدر البيانات. يجب ضبط كل من في حال ضبط هذه السياسة، لن يقبل مصدر البيانات سوى المنتجات التي تتطابق مع هذه التركيبة. في حال ترك هذه السياسة بدون ضبط، سيقبل مصدر البيانات المنتجات بدون هذا القيد. |
LocalInventoryDataSource
مصدر بيانات المنتجات المتوفرة داخل المتجر.
تمثيل JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
الحقول | |
---|---|
feedLabel |
مطلوب. غير قابل للتغيير. تصنيف خلاصة العروض التي تم تقديم المنتجات المتوفرة داخل المتجر لها يجب أن يكون أقل من أو يساوي 20 حرفًا كبيرًا (A-Z) وأرقامًا (0-9) وشُرطًا (-). راجِع أيضًا نقل البيانات إلى تصنيفات الخلاصات. |
contentLanguage |
مطلوب. غير قابل للتغيير. تمثّل هذه السمة اللغة المكوَّنة من حرفَين وفقًا لمعيار ISO 639-1 للسلع التي يتوفّر لها المستودع المحلي. |
RegionalInventoryDataSource
مصدر بيانات المستودع الإقليمي.
تمثيل JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
الحقول | |
---|---|
feedLabel |
مطلوب. غير قابل للتغيير. تصنيف خلاصة العروض التي يتوفّر لها المستودع الإقليمي. يجب أن يكون أقل من أو يساوي 20 حرفًا كبيرًا (A-Z) وأرقامًا (0-9) وشُرطًا (-). راجِع أيضًا نقل البيانات إلى تصنيفات الخلاصات. |
contentLanguage |
مطلوب. غير قابل للتغيير. تمثّل هذه السمة اللغة المكوَّنة من حرفَين وفقًا لمعيار ISO 639-1 للسلع التي يتوفّر لها المستودع الإقليمي. |
PromotionDataSource
مصدر بيانات العرض الترويجي
تمثيل JSON |
---|
{ "targetCountry": string, "contentLanguage": string } |
الحقول | |
---|---|
targetCountry |
مطلوب. غير قابل للتغيير. البلد المستهدف المستخدَم كجزء من المعرّف الفريد ويتم تمثيله كرمز CLDR للمنطقة لا تتوفّر العروض الترويجية إلا في بلدان محدّدة. |
contentLanguage |
مطلوب. غير قابل للتغيير. تمثّل هذه السمة اللغة المكوَّنة من حرفين وفقًا لمعيار ISO 639-1 للعناصر المتوفّرة في مصدر البيانات. |
الإدخال
تحدد نوع الإدخال لمصدر البيانات. استنادًا إلى الإدخال، قد لا تتوافق بعض الإعدادات.
عمليات التعداد | |
---|---|
INPUT_UNSPECIFIED |
الإدخال غير محدّد. |
API |
تمثل هذه السياسة مصادر البيانات التي يتم توفير بياناتها بشكل أساسي من خلال واجهة برمجة التطبيقات. |
FILE |
يمثّل هذا الحقل مصادر البيانات التي يتم توفير البيانات لها بشكل أساسي من خلال إدخال الملف. وسيظل من الممكن تقديم البيانات من خلال واجهة برمجة التطبيقات. |
UI |
مصدر بيانات المنتجات التي تمّت إضافتها مباشرةً في Merchant Center ولا يمكن إنشاء هذا النوع من مصادر البيانات أو تعديله من خلال واجهة برمجة التطبيقات هذه، بل يمكن فقط باستخدام واجهة مستخدم Merchant Center. هذا النوع من مصدر البيانات للقراءة فقط. |
AUTOFEED |
تُعرَف هذه العملية أيضًا باسم الخلاصات المبرمَجة التي تُستخدم لإنشاء بيانات المنتجات تلقائيًا. يمكن تفعيل هذا النوع من مصدر البيانات أو إيقافه من خلال حزمة الحسابات. |
FileInput
البيانات الخاصة بمصادر بيانات الملفات. هذا الحقل فارغ لإدخالات مصدر البيانات الأخرى.
تمثيل JSON |
---|
{ "fetchSettings": { object ( |
الحقول | |
---|---|
fetchSettings |
اختياريّ. يمكنك استرجاع التفاصيل لعرض مصدر البيانات. ويحتوي على إعدادات لأنواع إدخال الملفات |
fileName |
اختياريّ. اسم ملف مصدر البيانات. هذا الحقل مطلوب لنوع إدخال الملف |
fileInputType |
النتائج فقط. نوع الملف الذي تم إدخاله. |
FetchSettings
يمكنك استرجاع التفاصيل لعرض مصدر البيانات.
تمثيل JSON |
---|
{ "enabled": boolean, "dayOfMonth": integer, "timeOfDay": { object ( |
الحقول | |
---|---|
enabled |
اختياريّ. لتفعيل الجدول الزمني للجلب أو إيقافه مؤقتًا |
dayOfMonth |
اختياريّ. اليوم من الشهر الذي يجب فيه استرجاع ملف مصدر البيانات (من 1 إلى 31) لا يمكن ضبط هذا الحقل إلا لمعدل التكرار الشهري. |
timeOfDay |
اختياريّ. الساعة من اليوم التي يجب استرجاع ملف مصدر البيانات فيها. لا تتوفّر الدقائق والثواني وسيتم تجاهلها. |
dayOfWeek |
اختياريّ. يوم من الأسبوع الذي يجب فيه استرجاع ملف مصدر البيانات لا يمكن ضبط هذا الحقل إلا لمعدل التكرار الأسبوعي. |
timeZone |
اختياريّ. المنطقة الزمنية المُستخدَمة للجدول الزمني التوقيت العالمي المنسَّق (UTC) تلقائيًا. على سبيل المثال، "America/Los_Angeles". |
frequency |
مطلوب. معدل التكرار الذي يصف الجدول الزمني للجلب. |
fetchUri |
اختياريّ. عنوان URL الذي يمكن جلب ملف مصدر البيانات منه تتيح خدمة Google Merchant Center إجراء عمليات التحميل المُجدوَلة التلقائية باستخدام بروتوكول HTTP أو HTTPS أو SFTP، وبالتالي يجب أن تكون القيمة رابطًا صالحًا يستخدم أحد هذه البروتوكولات الثلاثة. غير قابل للتغيير لملفات "جداول بيانات Google". |
username |
اختياريّ. اسم مستخدم اختياري لـ [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. تُستخدَم هذه الوظيفة لإرسال مصادر البيانات من خلال بروتوكول النقل الآمن للملفات (SFTP). |
password |
اختياريّ. كلمة مرور اختيارية لـ [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. تُستخدَم هذه الوظيفة لإرسال مصادر البيانات من خلال بروتوكول النقل الآمن للملفات (SFTP). |
TimeOfDay
يمثل وقتًا من اليوم. إما أن التاريخ والمنطقة الزمنية ليست مهمة أو تم تحديدها في مكان آخر. قد تختار واجهة برمجة التطبيقات السماح بالثواني. الأنواع ذات الصلة هي google.type.Date
وgoogle.protobuf.Timestamp
.
تمثيل JSON |
---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
الحقول | |
---|---|
hours |
ساعات اليوم بتنسيق 24 ساعة. يجب أن تتراوح القيمة بين 0 و23. قد تختار واجهة برمجة التطبيقات السماح بالقيمة "24:00:00" لسيناريوهات مثل موعد إغلاق العمل. |
minutes |
دقائق من ساعات اليوم. يجب أن تتراوح القيمة بين 0 و59. |
seconds |
ثواني الدقائق من الوقت. يجب أن تتراوح القيمة عادةً بين 0 و59. وقد تسمح واجهة برمجة التطبيقات بالقيمة 60 إذا كانت تسمح بالثواني الكبيسة. |
nanos |
الكسور من الثواني بالنانو ثانية. يجب أن تتراوح القيمة بين 0 و999,999,999. |
DayOfWeek
يمثل يومًا من الأسبوع.
عمليات التعداد | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
لم يتم تحديد اليوم من الأسبوع. |
MONDAY |
الاثنين |
TUESDAY |
الثلاثاء |
WEDNESDAY |
الأربعاء |
THURSDAY |
الخميس |
FRIDAY |
الجمعة |
SATURDAY |
السبت |
SUNDAY |
الأحد |
التردد
تختلف الحقول المطلوبة بناءً على تكرار الجلب. يجب إدخال [اليوم من الشهر][google.shopping.content.bundles.DataSources.FileInput.Fetch Schedule.day_of_month] و[ساعة من اليوم][google.shopping.content.bundles.DataSources.FileInput.Fetchschedule.time_of_day]. للحصول على جدول زمني أسبوعي لعمليات جلب البيانات، يجب إدخال كل من [يوم من الأسبوع][google.shopping.content.bundles.DataSources.FileInput.Fetch Schedule.day_of_week] و[ساعة من اليوم][google.shopping.content.bundles.DataSources.FileInput.Fetch Schedule.time_of_day]. للحصول على جدول زمني للجلب اليومي، يجب تخصيص [ساعة من اليوم][google.shopping.content.bundles.DataSources.FileInput.Fetch الزيارات.time_of_day] فقط.
عمليات التعداد | |
---|---|
FREQUENCY_UNSPECIFIED |
لم يتم تحديد معدّل التكرار. |
FREQUENCY_DAILY |
ويتم استرجاع الملفات كل يوم. |
FREQUENCY_WEEKLY |
ويحدث الجلب كل أسبوع. |
FREQUENCY_MONTHLY |
ويتم استرجاع هذه الرسائل كل شهر. |
FileInputType
طريقة تسليم الملف.
عمليات التعداد | |
---|---|
FILE_INPUT_TYPE_UNSPECIFIED |
لم يتم تحديد نوع إدخال الملف. |
UPLOAD |
يتم تحميل الملف عبر بروتوكول النقل الآمن للملفات (SFTP) أو Google Cloud Storage أو يدويًا في Merchant Center. |
FETCH |
ويتم جلب الملف من [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] الذي تم ضبطه. |
GOOGLE_SHEETS |
ويتم جلب الملف من "جداول بيانات Google" المحدّدة في [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri]. |
الطُرق |
|
---|---|
|
تنشئ إعدادات مصدر البيانات الجديدة للحساب المحدّد. |
|
تحذف مصدر بيانات من حسابك على Merchant Center. |
|
تُجري عملية استرجاع البيانات على الفور (حتى لو كانت خارج الجدول الزمني للجلب) على مصدر بيانات من حسابك على Merchant Center. |
|
استرداد إعدادات مصدر البيانات للحساب المحدّد. |
|
يسرد عمليات ضبط مصادر البيانات للحساب المحدّد. |
|
يتم تعديل إعدادات مصدر البيانات الحالية. |