Package google.shopping.merchant.inventories.v1beta

الفهرس

LocalInventoryService

خدمة لإدارة مستودع المنتجات داخل المتجر

DeleteLocalInventory

rpc DeleteLocalInventory(DeleteLocalInventoryRequest) returns (Empty)

تؤدي هذه العملية إلى حذف سمة LocalInventory المحدّدة من المنتج المحدّد في حساب التاجر. قد يستغرق حذف LocalInventory من المنتج المحدّد مدة تصل إلى ساعة. بعد تلقّي استجابة ناجحة لطلب الحذف، انتظِر هذه الفترة قبل محاولة الحذف مرة أخرى.

نطاقات التفويض

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

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

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

rpc InsertLocalInventory(InsertLocalInventoryRequest) returns (LocalInventory)

تُستخدَم هذه السمة لإدراج مرجع LocalInventory لمنتج في حساب التاجر.

تستبدل هذه السمة المورد الكامل LocalInventory إذا كان هناك إدخال يتضمّن storeCode نفسه للمنتج.

قد يستغرق ظهور مرجع LocalInventory الجديد أو المعدَّل في المنتجات مدة تصل إلى 30 دقيقة.

نطاقات التفويض

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

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

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

rpc ListLocalInventories(ListLocalInventoriesRequest) returns (ListLocalInventoriesResponse)

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

يتم إدراج LocalInventory مورد لكل منتج في حساب معيّن.

نطاقات التفويض

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

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

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

RegionalInventoryService

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

DeleteRegionalInventory

rpc DeleteRegionalInventory(DeleteRegionalInventoryRequest) returns (Empty)

تؤدي هذه الوظيفة إلى حذف مورد RegionalInventory المحدّد من المنتج المحدّد في حساب التاجر. قد يستغرق حذف RegionalInventory من المنتج المحدّد مدة تصل إلى ساعة. بعد تلقّي استجابة ناجحة لطلب الحذف، انتظِر هذه الفترة قبل محاولة الحذف مرة أخرى.

نطاقات التفويض

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

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

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

rpc InsertRegionalInventory(InsertRegionalInventoryRequest) returns (RegionalInventory)

تُدرج RegionalInventory في منتج معيّن في حساب التاجر.

تستبدل هذه السمة المورد الكامل RegionalInventory إذا كان هناك إدخال يتضمّن region نفسه للمنتج.

قد يستغرق ظهور مرجع RegionalInventory الجديد أو المعدَّل في المنتجات مدة تصل إلى 30 دقيقة.

نطاقات التفويض

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

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

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

rpc ListRegionalInventories(ListRegionalInventoriesRequest) returns (ListRegionalInventoriesResponse)

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

يتم إدراج RegionalInventory مورد لكل منتج في حساب معيّن.

نطاقات التفويض

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

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

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

DeleteLocalInventoryRequest

رسالة طلب لطريقة DeleteLocalInventory

الحقول
name

string

مطلوب. اسم المستودع الفعلي للمنتج المحدّد المطلوب حذفه. التنسيق: accounts/{account}/products/{product}/localInventories/{store_code}

DeleteRegionalInventoryRequest

رسالة طلب لطريقة DeleteRegionalInventory

الحقول
name

string

مطلوب. اسم مورد RegionalInventory المطلوب حذفه التنسيق: accounts/{account}/products/{product}/regionalInventories/{region}

InsertLocalInventoryRequest

رسالة طلب لطريقة InsertLocalInventory

الحقول
parent

string

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

LocalInventory

مطلوب. معلومات المنتجات المتوفّرة داخل المتجر إذا كان المنتج يتضمّن حاليًا مورد LocalInventory للعنصر storeCode نفسه، يتم استبدال مورد LocalInventory بالكامل.

InsertRegionalInventoryRequest

رسالة طلب لطريقة InsertRegionalInventory

الحقول
parent

string

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

RegionalInventory

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

ListLocalInventoriesRequest

رسالة طلب لطريقة ListLocalInventories

الحقول
parent

string

مطلوب. name المنتج الرئيسي الذي تريد إدراج المستودعات الفعلية المحلية له التنسيق: accounts/{account}/products/{product}
page_size

int32

الحد الأقصى لعدد موارد LocalInventory التي يمكن عرضها للمنتج المحدّد تعرِض الخدمة عددًا أقل من هذه القيمة إذا كان عدد المستودعات للمنتج المحدّد أقل من pageSize. القيمة التلقائية هي 25000. الحد الأقصى للقيمة هو 25, 000. إذا تم تحديد قيمة أعلى من الحد الأقصى، سيتم ضبط pageSize تلقائيًا على الحد الأقصى.
page_token

string

رمز مميّز للصفحة، تم تلقّيه من مكالمة ListLocalInventories سابقة قدِّم رمز علامة الصفحة لاسترداد الصفحة اللاحقة.

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

ListLocalInventoriesResponse

رسالة الردّ على طريقة ListLocalInventories

الحقول
local_inventories[]

LocalInventory

LocalInventory مورد للمنتج المحدّد من الحساب المحدّد
next_page_token

string

رمز مميّز يمكن إرساله على شكل pageToken لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

ListRegionalInventoriesRequest

رسالة طلب لطريقة ListRegionalInventories

الحقول
parent

string

مطلوب. name المنتج الرئيسي الذي تريد إدراج RegionalInventory مورد له التنسيق: accounts/{account}/products/{product}
page_size

int32

الحد الأقصى لعدد موارد RegionalInventory التي يمكن عرضها للمنتج المحدّد تعرِض الخدمة عددًا أقل من هذه القيمة إذا كان عدد المستودعات للمنتج المحدّد أقل من pageSize. القيمة التلقائية هي 25000. الحد الأقصى للقيمة هو 100000. إذا تم تحديد قيمة أعلى من الحد الأقصى، سيتم ضبط pageSize تلقائيًا على الحد الأقصى.
page_token

string

رمز مميّز للصفحة، تم تلقّيه من مكالمة ListRegionalInventories سابقة قدِّم رمز علامة الصفحة لاسترداد الصفحة اللاحقة.

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

ListRegionalInventoriesResponse

رسالة الردّ على طريقة ListRegionalInventories

الحقول
regional_inventories[]

RegionalInventory

RegionalInventory مورد للمنتج المحدّد من الحساب المحدّد
next_page_token

string

رمز مميّز يمكن إرساله على شكل pageToken لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

LocalInventory

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

الحقول
name

string

النتائج فقط. اسم مورد LocalInventory التنسيق: accounts/{account}/products/{product}/localInventories/{store_code}
account

int64

النتائج فقط. الحساب الذي يملك المنتج. سيتم تجاهل هذا الحقل إذا ضبطه العميل.
store_code

string

مطلوب. غير قابل للتغيير رمز المتجر (معرّف المتجر من ملفك التجاري) للمتجر المادي الذي يُباع فيه المنتج اطّلِع على مواصفات بيانات المنتجات المتوفّرة داخل المتجر للحصول على مزيد من المعلومات.
price

Price

سعر المنتج في هذا المتجر
sale_price

Price

سعر المنتج المخفَّض في هذا المتجر. إلزامية إذا تم تحديد salePriceEffectiveDate.
sale_price_effective_date

Interval

TimePeriod من فترة التخفيض في هذا المتجر
custom_attributes[]

CustomAttribute

قائمة بالسمات المخصّصة (التي يقدّمها التاجر) يمكنك أيضًا استخدام CustomAttribute لإرسال أيّ سمة من مواصفات البيانات بتنسيقها العام.
availability

string

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

int64

كمية المنتج المتوفّرة في هذا المتجر يجب أن تكون القيمة أكبر من أو تساوي صفرًا.
pickup_method

string

طريقة الاستلام المتاحة لهذا المنتج يجب إرسال هذا الحقل مع pickupSla ما لم تكن القيمة هي "not supported". للاطّلاع على قيم السمات المقبولة، يمكنك الاطّلاع على مواصفات بيانات مستودع المنتجات داخل المتجر.
pickup_sla

string

الفترة الزمنية النسبية من تاريخ طلب هذا المنتج من هذا المتجر إلى أن يصبح جاهزًا للاستلام يجب إرسالها باستخدام pickupMethod. للاطّلاع على قيم السمات المقبولة، يمكنك الاطّلاع على مواصفات بيانات مستودع المنتجات داخل المتجر.
instore_product_location

string

مكان المنتج داخل المتجر الحد الأقصى للطول هو 20 بايت.

RegionalInventory

معلومات المستودع الإقليمي للمنتج يمثّل معلومات محدّدة، مثل السعر ومدى توفّر منتج معيّن في region معيّن. للحصول على قائمة بجميع قيم السمات المقبولة، اطّلِع على مواصفات بيانات مستودع المنتجات على مستوى منطقة معيّنة.

الحقول
name

string

النتائج فقط. اسم مورد RegionalInventory التنسيق: {regional_inventory.name=accounts/{account}/products/{product}/regionalInventories/{region}
account

int64

النتائج فقط. الحساب الذي يملك المنتج. سيتم تجاهل هذا الحقل إذا ضبطه العميل.
region

string

مطلوب. غير قابل للتغيير رقم تعريف المنطقة لمورد RegionalInventory هذا. اطّلِع على مقالة ضبط السعر ومدى التوفّر على مستوى منطقة معيّنة للحصول على مزيد من التفاصيل.
price

Price

سعر المنتج في هذه المنطقة
sale_price

Price

سعر المنتج المخفَّض في هذه المنطقة. إلزامية إذا تم تحديد salePriceEffectiveDate.
sale_price_effective_date

Interval

TimePeriod من السعر المخفَّض في هذه المنطقة.
custom_attributes[]

CustomAttribute

قائمة بالسمات المخصّصة (التي يقدّمها التاجر) يمكنك أيضًا استخدام CustomAttribute لإرسال أيّ سمة من مواصفات البيانات بتنسيقها العام.
availability

string

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