Package google.shopping.merchant.datasources.v1beta

الفهرس

DataSourcesService

خدمة لإدارة مصادر البيانات الأساسية والتكميليّة والمستودعية وغيرها من مصادر البيانات اطّلِع على المزيد من المعلومات في مقالة مساعدة Merchant Center.

CreateDataSource

rpc CreateDataSource(CreateDataSourceRequest) returns (DataSource)

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

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

DeleteDataSource

rpc DeleteDataSource(DeleteDataSourceRequest) returns (Empty)

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

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

FetchDataSource

rpc FetchDataSource(FetchDataSourceRequest) returns (Empty)

تُجري عملية استرجاع البيانات على الفور (حتى لو كانت خارج الجدول الزمني للجلب) على مصدر بيانات من حسابك على Merchant Center. وإذا كنت بحاجة إلى استدعاء هذه الطريقة أكثر من مرة في اليوم، فيجب عليك استخدام خدمة "المنتجات" لتحديث بيانات المنتج بدلاً من ذلك. تعمل هذه الطريقة فقط مع مصادر البيانات التي تتضمن مجموعة إدخال ملف.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

GetDataSource

rpc GetDataSource(GetDataSourceRequest) returns (DataSource)

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

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

ListDataSources

rpc ListDataSources(ListDataSourcesRequest) returns (ListDataSourcesResponse)

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

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

UpdateDataSource

rpc UpdateDataSource(UpdateDataSourceRequest) returns (DataSource)

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

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

CreateDataSourceRequest

اطلب رسالة بشأن طريقة CreateDataSource.

الحقول
parent

string

مطلوب. الحساب الذي سيتم إنشاء مصدر البيانات هذا فيه تنسيق الملف: accounts/{account}

data_source

DataSource

مطلوب. مصدر البيانات المراد إنشاؤه.

DataSource

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

الحقول
name

string

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

data_source_id

int64

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

display_name

string

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

input

Input

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

file_input

FileInput

اختياريّ. لا يتم استخدام هذا الحقل إلا عندما تتم إدارة البيانات من خلال ملف.

حقل الاتحاد Type. نوع مصدر البيانات. يمكن أن يكون Type واحدًا فقط مما يلي:
primary_product_data_source

PrimaryProductDataSource

مطلوب. مصدر البيانات الأساسي للمنتجات المحلية والمعروضة على الإنترنت:

supplemental_product_data_source

SupplementalProductDataSource

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

local_inventory_data_source

LocalInventoryDataSource

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

regional_inventory_data_source

RegionalInventoryDataSource

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

promotion_data_source

PromotionDataSource

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

إدخال

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

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

مصدر بيانات المنتجات التي تمّت إضافتها مباشرةً في Merchant Center

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

هذا النوع من مصدر البيانات للقراءة فقط.

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

DeleteDataSourceRequest

اطلب رسالة لطريقة DeleteDataSource.

الحقول
name

string

مطلوب. اسم مصدر البيانات المطلوب حذفه. تنسيق الملف: accounts/{account}/dataSources/{datasource}

FetchDataSourceRequest

اطلب إرسال رسالة بشأن طريقة FetchDataSource.

الحقول
name

string

مطلوب. اسم مورد مصدر البيانات المطلوب جلبه. تنسيق الملف: accounts/{account}/dataSources/{datasource}

FileInput

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

الحقول
fetch_settings

FetchSettings

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

file_name

string

اختياريّ. اسم ملف مصدر البيانات. هذا الحقل مطلوب لنوع إدخال الملف UPLOAD.

file_input_type

FileInputType

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

FetchSettings

يمكنك استرجاع التفاصيل لعرض مصدر البيانات.

الحقول
enabled

bool

اختياريّ. لتفعيل الجدول الزمني للجلب أو إيقافه مؤقتًا

day_of_month

int32

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

time_of_day

TimeOfDay

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

day_of_week

DayOfWeek

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

time_zone

string

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

frequency

Frequency

مطلوب. معدل التكرار الذي يصف الجدول الزمني للجلب.

fetch_uri

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).

التردد

تختلف الحقول المطلوبة بناءً على تكرار الجلب. يجب إدخال [اليوم من الشهر][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 ويتم جلب الملف من ملف [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] الذي تم ضبطه.
GOOGLE_SHEETS ويتم جلب الملف من "جداول بيانات Google" المحدّدة في [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri].

GetDataSourceRequest

اطلب رسالة بشأن طريقة GetDataSource.

الحقول
name

string

مطلوب. اسم مصدر البيانات المطلوب استرداده. تنسيق الملف: accounts/{account}/dataSources/{datasource}

ListDataSourcesRequest

اطلب رسالة لطريقة ListDataSources.

الحقول
parent

string

مطلوب. الحساب المطلوب إدراج مصادر البيانات له تنسيق الملف: accounts/{account}

page_size

int32

اختياريّ. الحد الأقصى لعدد مصادر البيانات المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. الحد الأقصى للقيمة هو 1000؛ سيتم فرض القيم الأكبر من 1000 على 1000. وفي حال عدم تحديدها، سيتم عرض الحد الأقصى لعدد مصادر البيانات.

page_token

string

اختياريّ. رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق "ListDataSources". يمكنك توفير هذا الحقل لاسترداد الصفحة التالية.

عند التقسيم على صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى ListDataSources مع الاستدعاء الذي قدّم الرمز المميّز للصفحة.

ListDataSourcesResponse

رسالة ردّ لطريقة ListDataSources.

الحقول
data_sources[]

DataSource

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

next_page_token

string

رمز مميز يمكن إرساله على شكل page_token لاسترداد الصفحة التالية. في حال إسقاط هذا الحقل، لن تظهر أي صفحات لاحقة.

LocalInventoryDataSource

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

الحقول
feed_label

string

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

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

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

content_language

string

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

PrimaryProductDataSource

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

الحقول
channel

Channel

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

countries[]

string

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

feed_label

string

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

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

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

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

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

content_language

string

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

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

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

القناة

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

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

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

PromotionDataSource

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

الحقول
target_country

string

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

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

content_language

string

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

RegionalInventoryDataSource

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

الحقول
feed_label

string

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

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

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

content_language

string

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

SupplementalProductDataSource

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

الحقول
feed_label

string

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

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

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

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

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

content_language

string

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

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

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

UpdateDataSourceRequest

اطلب رسالة لطريقة UpdateDataSource.

الحقول
data_source

DataSource

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

update_mask

FieldMask

مطلوب. قائمة حقول مصادر البيانات التي سيتم تعديلها.

سيتم حذف الحقول المحدّدة في قناع التحديث بدون قيمة محدّدة في النص من مصدر البيانات.

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