REST Resource: accounts.dataSources

المرجع: DataSource

مصدر البيانات لحساب Merchant Center

تمثيل JSON 
{
  "name": string,
  "dataSourceId": string,
  "displayName": string,
  "input": enum (Input),
  "fileInput": {
    object (FileInput)
  },

  // Union field Type can be only one of the following:
  "primaryProductDataSource": {
    object (PrimaryProductDataSource)
  },
  "supplementalProductDataSource": {
    object (SupplementalProductDataSource)
  },
  "localInventoryDataSource": {
    object (LocalInventoryDataSource)
  },
  "regionalInventoryDataSource": {
    object (RegionalInventoryDataSource)
  },
  "promotionDataSource": {
    object (PromotionDataSource)
  },
  "productReviewDataSource": {
    object (ProductReviewDataSource)
  },
  "merchantReviewDataSource": {
    object (MerchantReviewDataSource)
  }
  // End of list of possible types for union field Type.
}
الحقول
name

string

المعرّف اسم مصدر البيانات. التنسيق: {datasource.name=accounts/{account}/dataSources/{datasource}}
dataSourceId

string (int64 format)

النتائج فقط. معرّف مصدر البيانات
displayName

string

مطلوب. اسم مصدر البيانات المعروض في واجهة مستخدم Merchant Center.
input

enum (Input)

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

object (FileInput)

اختيارية: لا يتم استخدام الحقل إلا عند إدارة البيانات من خلال ملف.
حقل الربط Type نوع مصدر البيانات يمكن أن يكون Type واحدًا فقط مما يلي:
primaryProductDataSource

object (PrimaryProductDataSource)

مطلوب. مصدر البيانات الأساسي للمنتجات داخل المتجر وعلى الإنترنت
supplementalProductDataSource

object (SupplementalProductDataSource)

مطلوب. مصدر البيانات الإضافي للمنتجات داخل المتجر وعلى الإنترنت
localInventoryDataSource

object (LocalInventoryDataSource)

مطلوب. مصدر بيانات المستودع داخل المتجر
regionalInventoryDataSource

object (RegionalInventoryDataSource)

مطلوب. مصدر بيانات المستودع الإقليمي
promotionDataSource

object (PromotionDataSource)

مطلوب. مصدر بيانات العرض الترويجي.
productReviewDataSource

object (ProductReviewDataSource)

مطلوب. مصدر بيانات مراجعة المنتج
merchantReviewDataSource

object (MerchantReviewDataSource)

مطلوب. مصدر بيانات مراجعة التاجر

PrimaryProductDataSource

مصدر البيانات الأساسي للمنتجات داخل المتجر وعلى الإنترنت.

تمثيل JSON 
{
  "channel": enum (Channel),
  "countries": [
    string
  ],
  "defaultRule": {
    object (DefaultRule)
  },
  "feedLabel": string,
  "contentLanguage": string
}
الحقول
channel

enum (Channel)

مطلوب. غير قابل للتغيير تحدِّد نوع قناة مصدر البيانات.
countries[]

string

اختيارية: البلدان التي قد تظهر فيها العناصر يتم تمثيلها على شكل رمز CLDR للمنطقة.
defaultRule

object (DefaultRule)

اختيارية: إدارة القواعد التلقائية لمصدر البيانات في حال ضبطها، سيتم استبدال مصادر البيانات المرتبطة.
feedLabel

string

اختيارية: غير قابل للتغيير تصنيف الخلاصة المحدّد على مستوى مصدر البيانات.

يجب أن يكون عدد الأحرف أقل من أو يساوي 20 حرفًا كبيرًا (A-Z) وأرقامًا (0-9) وشرطًا (-).

راجِع أيضًا نقل البيانات إلى تصنيفات الخلاصات.

يجب ضبط feedLabel وcontentLanguage أو عدم ضبطهما لمصادر البيانات التي تحتوي على نوع محتوى المنتج. ويجب ضبطها لمصادر البيانات التي تتضمّن إدخال ملف.

في حال ضبطها، لن يقبل مصدر البيانات سوى المنتجات التي تتطابق مع هذه المجموعة. في حال عدم ضبط هذه السياسة، سيقبل مصدر البيانات المنتجات بدون هذا التقييد.
contentLanguage

string

اختيارية: غير قابل للتغيير رمز اللغة المكوّن من حرفَين وفقًا لمعيار ISO 639-1 للعناصر في مصدر البيانات

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

في حال ضبطها، لن يقبل مصدر البيانات سوى المنتجات التي تتطابق مع هذه المجموعة. في حال عدم ضبط هذه السياسة، سيقبل مصدر البيانات المنتجات بدون هذا التقييد.

القناة

قناة مصدر البيانات

تُستخدَم القناة للتمييز بين مصادر البيانات لمجالات المنتجات المختلفة.

عمليات التعداد
CHANNEL_UNSPECIFIED غير محدّد
ONLINE_PRODUCTS منتج على الإنترنت
LOCAL_PRODUCTS منتج محلّي
PRODUCTS مصدر بيانات موحّد لكلٍّ من المنتجات داخل المتجر والمنتجات على الإنترنت ملاحظة: لا يمكن إدارة المنتجات من خلال واجهة برمجة التطبيقات لهذه القناة.

DefaultRule

إدارة القواعد التلقائية لمصدر البيانات

تمثيل JSON 
{
  "takeFromDataSources": [
    {
      object (DataSourceReference)
    }
  ]
}
الحقول
takeFromDataSources[]

object (DataSourceReference)

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

يجب ألا تكون القائمة فارغة.

لربط مصدر البيانات بالقاعدة التلقائية، عليك إضافة مرجع جديد إلى هذه القائمة (بترتيب تسلسلي).

لإلغاء ربط مصدر البيانات بالقاعدة التلقائية، عليك إزالة المرجع المحدّد من هذه القائمة.

سيؤدي تغيير ترتيب هذه القائمة إلى تغيير أولوية مصادر البيانات في القاعدة التلقائية.

على سبيل المثال، عند تقديم القائمة التالية: [1001, self]، سيتم الحصول على قيم السمات من مصدر البيانات الإضافي 1001، وسيتم الرجوع إلى self إذا لم يتم ضبط السمة في 1001.

DataSourceReference

يمكن استخدام مرجع مصدر البيانات لإدارة مصادر البيانات ذات الصلة ضمن خدمة مصدر البيانات.

تمثيل JSON 
{

  // Union field data_source_id can be only one of the following:
  "self": boolean,
  "primaryDataSourceName": string,
  "supplementalDataSourceName": string
  // End of list of possible types for union field data_source_id.
}
الحقول

حقل الربط data_source_id

يمكن أن يكون data_source_id واحدًا فقط مما يلي:
self

boolean

يجب استخدام Self للإشارة إلى مصدر البيانات الأساسي نفسه.
primaryDataSourceName

string

اختيارية: اسم مصدر البيانات الأساسي التنسيق: accounts/{account}/dataSources/{datasource}
supplementalDataSourceName

string

اختيارية: اسم مصدر البيانات التكميلية. التنسيق: accounts/{account}/dataSources/{datasource}

SupplementalProductDataSource

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

تمثيل JSON 
{
  "referencingPrimaryDataSources": [
    {
      object (DataSourceReference)
    }
  ],
  "feedLabel": string,
  "contentLanguage": string
}
الحقول
referencingPrimaryDataSources[]

object (DataSourceReference)

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

string

اختيارية: غير قابل للتغيير تصنيف الخلاصة المحدّد على مستوى مصدر البيانات.

يجب أن يكون عدد الأحرف أقل من أو يساوي 20 حرفًا كبيرًا (A-Z) وأرقامًا (0-9) وشرطًا (-).

راجِع أيضًا نقل البيانات إلى تصنيفات الخلاصات.

يجب ضبط feedLabel وcontentLanguage أو عدم ضبطهما لمصادر البيانات التي تحتوي على نوع محتوى المنتج.

يجب ضبطها لمصادر البيانات التي تحتوي على file input. يجب عدم ضبط الحقول لمصادر البيانات التي لا تحتوي على file input.

في حال ضبطها، لن يقبل مصدر البيانات سوى المنتجات التي تتطابق مع هذه المجموعة. في حال عدم ضبط هذا الخيار، سيقبل مصدر البيانات المنتجات بدون هذا القيد.
contentLanguage

string

اختيارية: غير قابل للتغيير رمز اللغة المكوّن من حرفَين وفقًا لمعيار ISO 639-1 للعناصر في مصدر البيانات

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

في حال ضبطها، لن يقبل مصدر البيانات سوى المنتجات التي تتطابق مع هذه المجموعة. في حال عدم ضبط هذا الخيار، سيقبل مصدر البيانات المنتجات بدون هذا القيد.

LocalInventoryDataSource

مصدر بيانات المنتجات المتوفّرة داخل المتجر

تمثيل JSON 
{
  "feedLabel": string,
  "contentLanguage": string
}
الحقول
feedLabel

string

مطلوب. غير قابل للتغيير تصنيف الخلاصة للعروض التي يتم توفير المنتجات داخل المتجر لها.

يجب أن يكون عدد الأحرف أقل من أو يساوي 20 حرفًا كبيرًا (A-Z) وأرقامًا (0-9) وشرطًا (-).

راجِع أيضًا نقل البيانات إلى تصنيفات الخلاصات.
contentLanguage

string

مطلوب. غير قابل للتغيير رمز اللغة المكوّن من حرفَين وفقًا لمعيار ISO 639-1 للعناصر التي يتوفّر لها المنتج داخل المتجر

RegionalInventoryDataSource

مصدر بيانات المستودع الإقليمي

تمثيل JSON 
{
  "feedLabel": string,
  "contentLanguage": string
}
الحقول
feedLabel

string

مطلوب. غير قابل للتغيير تصنيف الخلاصة للعروض التي يتم توفير المستودع الإقليمي لها.

يجب أن يكون عدد الأحرف أقل من أو يساوي 20 حرفًا كبيرًا (A-Z) وأرقامًا (0-9) وشرطًا (-).

راجِع أيضًا نقل البيانات إلى تصنيفات الخلاصات.
contentLanguage

string

مطلوب. غير قابل للتغيير رمز اللغة المكوّن من حرفَين وفقًا لمعيار ISO 639-1 للعناصر التي يتوفّر لها المستودع الإقليمي

PromotionDataSource

مصدر بيانات العرض الترويجي.

تمثيل JSON 
{
  "targetCountry": string,
  "contentLanguage": string
}
الحقول
targetCountry

string

مطلوب. غير قابل للتغيير البلد المستهدَف المستخدَم كجزء من المعرّف الفريد يتم تمثيلها على شكل رمز CLDR للمنطقة.

تتوفّر العروض الترويجية في بلدان محدّدة فقط.
contentLanguage

string

مطلوب. غير قابل للتغيير رمز اللغة المكوّن من حرفَين وفقًا لمعيار ISO 639-1 للعناصر في مصدر البيانات

ProductReviewDataSource

لا يحتوي هذا النوع على أي حقول.

مصدر بيانات مراجعات المنتجات

MerchantReviewDataSource

لا يحتوي هذا النوع على أي حقول.

مصدر بيانات مراجعات التجار

الإدخال

لتحديد نوع الإدخال في مصدر البيانات. استنادًا إلى الإدخال، قد لا تكون بعض الإعدادات متاحة.

عمليات التعداد
INPUT_UNSPECIFIED الإدخال غير محدّد.
API تمثّل مصادر البيانات التي يتم تقديم البيانات لها بشكل أساسي من خلال واجهة برمجة التطبيقات.
FILE تمثّل مصادر البيانات التي يتم تقديم البيانات لها بشكل أساسي من خلال إدخال الملفات. وسيظل بإمكانك تقديم البيانات من خلال واجهة برمجة التطبيقات.
UI

مصدر بيانات المنتجات المُضافة مباشرةً في Merchant Center.

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

هذا النوع من مصادر البيانات مخصّص للقراءة فقط.
AUTOFEED يُعرف ذلك أيضًا باسم الخلاصات المبرمَجة المستخدَمة لإنشاء بيانات المنتجات تلقائيًا. يمكن تفعيل هذا النوع من مصادر البيانات أو إيقافه من خلال حزمة "الحسابات".

FileInput

البيانات الخاصة بمصادر بيانات الملفات يكون هذا الحقل فارغًا لإدخالات مصادر البيانات الأخرى.

تمثيل JSON 
{
  "fetchSettings": {
    object (FetchSettings)
  },
  "fileName": string,
  "fileInputType": enum (FileInputType)
}
الحقول
fetchSettings

object (FetchSettings)

اختيارية: استرجاع التفاصيل لإرسال مصدر البيانات يحتوي على إعدادات لأنواع إدخال الملفات FETCH وGOOGLE_SHEETS. تختلف الحقول المطلوبة استنادًا إلى معدّل جلبها.
fileName

string

اختيارية: اسم ملف مصدر البيانات. مطلوب لنوع إدخال ملف UPLOAD.
fileInputType

enum (FileInputType)

النتائج فقط. نوع إدخال الملف

FetchSettings

استرجاع التفاصيل لإرسال مصدر البيانات

تمثيل JSON 
{
  "enabled": boolean,
  "dayOfMonth": integer,
  "timeOfDay": {
    object (TimeOfDay)
  },
  "dayOfWeek": enum (DayOfWeek),
  "timeZone": string,
  "frequency": enum (Frequency),
  "fetchUri": string,
  "username": string,
  "password": string
}
الحقول
enabled

boolean

اختيارية: تفعيل جدول الجلب أو إيقافه مؤقتًا
dayOfMonth

integer

اختيارية: يوم الشهر الذي يجب فيه جلب ملف مصدر البيانات (من 1 إلى 31). لا يمكن ضبط هذا الحقل إلا لعدد مرّات الظهور الشهري.
timeOfDay

object (TimeOfDay)

اختيارية: ساعة اليوم التي يجب فيها جلب ملف مصدر البيانات. لا يمكن استخدام الدقائق والثواني وسيتم تجاهلها.
dayOfWeek

enum (DayOfWeek)

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

string

اختيارية: المنطقة الزمنية المستخدَمة للجدول الزمني التوقيت العالمي المنسّق (UTC) تلقائيًا على سبيل المثال، "America/Los_Angeles".
frequency

enum (Frequency)

مطلوب. معدّل تكرار جدول الجلب
fetchUri

string

اختيارية: عنوان URL الذي يمكن من خلاله جلب ملف مصدر البيانات تتيح خدمة Google Merchant Center عمليات التحميل المُجدوَلة تلقائيًا باستخدام بروتوكول HTTP أو HTTPS أو SFTP، لذا يجب أن تكون القيمة رابطًا صالحًا باستخدام أحد هذه البروتوكولات الثلاثة. لا يمكن تغييرها في ملفات "جداول بيانات Google".
username

string

اختيارية: اسم مستخدم اختياري لـ fetchUri يُستخدَم لإرسال مصادر البيانات من خلال بروتوكول النقل الآمن للملفات (SFTP).
password

string

اختيارية: كلمة مرور اختيارية لـ "fetchUri" يُستخدَم لإرسال مصادر البيانات من خلال بروتوكول النقل الآمن للملفات (SFTP).

TimeOfDay

يمثّل وقتًا من اليوم. التاريخ والمنطقة الزمنية غير مهمّين أو تم تحديدهما في مكان آخر. قد تختار واجهة برمجة التطبيقات السماح بالثواني الكبيسة. الأنواع ذات الصلة هي google.type.Date وgoogle.protobuf.Timestamp.

تمثيل JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
الحقول
hours

integer

ساعات اليوم بتنسيق 24 ساعة يجب أن تكون أكبر من أو تساوي 0 ويجب أن تكون عادةً أقل من أو تساوي 23. قد تختار واجهة برمجة التطبيقات السماح بالقيمة "24:00:00" لسيناريوهات مثل وقت إغلاق النشاط التجاري.
minutes

integer

دقائق الساعة يجب أن تكون القيمة أكبر من أو تساوي 0 وأصغر من أو تساوي 59.
seconds

integer

ثوانٍ من الدقيقة يجب أن تكون أكبر من أو تساوي 0 ويجب أن تكون عادةً أقل من أو تساوي 59. قد تسمح واجهة برمجة التطبيقات بالقيمة 60 إذا كانت تسمح بالثواني الكبيسة.
nanos

integer

أجزاء من الثانية، بالنانوسيكون يجب أن تكون أكبر من أو تساوي 0 وأقل من أو تساوي 999,999,999.

DayOfWeek

يمثّل يومًا من أيام الأسبوع.

عمليات التعداد
DAY_OF_WEEK_UNSPECIFIED يوم الأسبوع غير محدّد.
MONDAY الاثنين
TUESDAY الثلاثاء
WEDNESDAY الأربعاء
THURSDAY الخميس
FRIDAY الجمعة
SATURDAY السبت
SUNDAY الأحد

التردد

تختلف الحقول المطلوبة استنادًا إلى معدّل جلبها. بالنسبة إلى جدول جلب شهري، يجب توفير [يوم الشهر][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 يتم جلب الملف من fetchUri الذي تم ضبطه.
GOOGLE_SHEETS يتم جلب الملف من "جداول بيانات Google" المحدّدة في fetchUri.

الطُرق

create

 تُنشئ هذه الوظيفة إعدادات مصدر البيانات الجديد للحساب المحدّد.

delete

 يؤدي هذا الإجراء إلى حذف مصدر بيانات من حسابك على Merchant Center.

fetch

 تُجري هذه العملية عملية جلب البيانات على الفور (حتى خارج الجدول الزمني لجلب البيانات) من مصدر بيانات في حسابك على Merchant Center.

get

 يسترجع إعدادات مصدر البيانات للحساب المحدّد.

list

 يسرد الإعدادات لمصادر البيانات للحساب المحدّد.

patch

 تعديل إعدادات مصدر البيانات الحالي