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)
  }
  // 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)

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

PrimaryProductDataSource

مصدر البيانات الأساسي للمنتجات المحلية والإلكترونية.

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

enum (Channel)

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

string

اختياريّ. البلدان التي قد يتم عرض السلع فيها. ويتم تمثيله كرمز CLDR للمنطقة
feedLabel

string

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

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

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

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

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

string

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

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

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

قناة

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

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

عمليات التعداد
CHANNEL_UNSPECIFIED لم يتم تحديده.
ONLINE_PRODUCTS منتج على الإنترنت.
LOCAL_PRODUCTS منتج محلّي.
PRODUCTS مصدر بيانات موحد لكل من المنتجات المحلية والإلكترونية.

SupplementalProductDataSource

مصدر البيانات التكميلي للمنتجات المحلية والإلكترونية:

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

string

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

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

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

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

في حال ضبط هذه السياسة، لن يقبل مصدر البيانات سوى المنتجات التي تتطابق مع هذه التركيبة. في حال ترك هذه السياسة بدون ضبط، سيقبل مصدر البيانات المنتجات بدون هذا القيد.
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 للعناصر المتوفّرة في مصدر البيانات.

إدخال

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

عمليات التعداد
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

اختياريّ. اسم مستخدم اختياري لـ [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. تُستخدَم هذه الوظيفة لإرسال مصادر البيانات من خلال بروتوكول النقل الآمن للملفات (SFTP).
password

string

اختياريّ. كلمة مرور اختيارية لـ [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

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.Fetch Schedule.time_of_day]. للحصول على جدول زمني للجلب اليومي، يجب تخصيص [ساعة من اليوم][google.shopping.content.bundles.DataSources.FileInput.Fetch Schedule.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].

الطُرق

create

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

delete

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

fetch

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

get

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

list

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

patch

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