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

rpc InsertLocalInventory(InsertLocalInventoryRequest) returns (LocalInventory)

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

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

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

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

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

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

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
ListLocalInventories

rpc ListLocalInventories(ListLocalInventoriesRequest) returns (ListLocalInventoriesResponse)

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

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

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

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

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

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

RegionalInventoryService

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

DeleteRegionalInventory

rpc DeleteRegionalInventory(DeleteRegionalInventoryRequest) returns (Empty)

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

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

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

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

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
InsertRegionalInventory

rpc InsertRegionalInventory(InsertRegionalInventoryRequest) returns (RegionalInventory)

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

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

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

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

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

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

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
ListRegionalInventories

rpc ListRegionalInventories(ListRegionalInventoriesRequest) returns (ListRegionalInventoriesResponse)

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

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

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

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

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

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

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. القيمة التلقائية هي 25,000. الحد الأقصى للقيمة هو 25000، وإذا تم تحديد قيمة أعلى من الحد الأقصى، سيتم ضبط 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. القيمة التلقائية هي 25,000. الحد الأقصى للقيمة هو 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

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