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 را در یک محصول در حساب تاجر شما درج می کند.

اگر ورودی با همان storeCode قبلاً برای محصول وجود داشته باشد، منبع کامل LocalInventory را جایگزین می‌کند.

ممکن است تا 30 دقیقه طول بکشد تا منبع LocalInventory جدید یا به روز شده در محصولات ظاهر شود.

محدوده مجوز

به محدوده 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 .

منطقه ای Inventory Service

خدمات مدیریت موجودی منطقه ای محصولات. همچنین برای مدیریت تعاریف مناطق، منبع و API جداگانه ای regions مناطق وجود دارد.

حذف موجودی منطقه ای

rpc DeleteRegionalInventory( DeleteRegionalInventoryRequest ) returns ( Empty )

منبع RegionalInventory مشخص شده را از محصول داده شده در حساب تاجر شما حذف می کند. ممکن است تا یک ساعت طول بکشد تا RegionalInventory از محصول خاص حذف شود. هنگامی که پاسخ حذف موفقیت آمیز را دریافت کردید، قبل از تلاش مجدد برای حذف، منتظر آن دوره باشید.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

Insert RegionalInventory

rpc InsertRegionalInventory( InsertRegionalInventoryRequest ) returns ( RegionalInventory )

یک RegionalInventory در یک محصول معین در حساب تجاری شما درج می کند.

اگر ورودی با همان region قبلاً برای محصول وجود داشته باشد، منبع کامل RegionalInventory را جایگزین می‌کند.

ممکن است تا 30 دقیقه طول بکشد تا منبع جدید یا به‌روزرسانی شده RegionalInventory در محصولات ظاهر شود.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

فهرست موجودی های منطقه ای

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 است. حداکثر مقدار 25000 است. اگر مقداری بالاتر از حداکثر مشخص شده باشد، pageSize به صورت پیش‌فرض به حداکثر خواهد رسید

page_ token

string

یک نشانه صفحه، دریافت شده از تماس قبلی ListLocalInventories . رمز صفحه را برای بازیابی صفحه بعدی ارائه دهید.

هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به ListLocalInventories باید با فراخوانی که توکن صفحه را ارائه می کند مطابقت داشته باشد. توکن در پاسخ به درخواست قبلی به عنوان nextPageToken بازگشت.

ListLocalInventoriesResponse

پیام پاسخ برای متد ListLocalInventories .

فیلدها
local_ inventories[]

LocalInventory

منابع LocalInventory برای محصول داده شده از حساب مشخص شده.

next_ page_ token

string

یک نشانه، که می تواند به عنوان pageToken برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد.

درخواست فهرست منطقه ای موجودی ها

درخواست پیام برای روش ListRegionalInventories .

فیلدها
parent

string

مورد نیاز. name محصول اصلی برای فهرست منابع RegionalInventory . قالب: accounts/{account}/products/{product}

page_ size

int32

حداکثر تعداد منابع RegionalInventory برای بازگشت محصول داده شده. اگر تعداد موجودی‌های محصول داده‌شده کمتر از pageSize باشد، خدمات کمتر از این مقدار برمی‌گرداند. مقدار پیش فرض 25000 است. حداکثر مقدار 100000 است. اگر مقداری بالاتر از حداکثر مشخص شده باشد، pageSize به صورت پیش‌فرض به حداکثر خواهد رسید.

page_ token

string

یک نشانه صفحه، دریافت شده از تماس قبلی ListRegionalInventories . رمز صفحه را برای بازیابی صفحه بعدی ارائه دهید.

هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به ListRegionalInventories باید با فراخوانی که توکن صفحه را ارائه می کند مطابقت داشته باشد. توکن در پاسخ به درخواست قبلی به عنوان nextPageToken بازگشت.

ListRegionalInventories Response

پیام پاسخ برای روش ListRegionalInventories .

فیلدها
regional_ inventories[]

RegionalInventory

منابع RegionalInventory برای محصول داده شده از حساب مشخص شده.

next_ page_ token

string

یک نشانه، که می تواند به عنوان pageToken برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد.

موجودی محلی

اطلاعات موجودی محلی برای محصول اطلاعات موجود در فروشگاه را برای یک محصول خاص در فروشگاه مشخص شده توسط 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

روش پیکاپ پشتیبانی شده برای این محصول. مگر اینکه مقدار "not supported" ، این فیلد باید همراه با pickupSla ارسال شود. برای مقادیر مشخصه پذیرفته شده، مشخصات داده موجودی محصول محلی را ببینید

pickup_ sla

string

بازه زمانی نسبی از تاریخ سفارش برای سفارش این محصول، از این فروشگاه، آماده تحویل. باید با pickupMethod ارسال شود. برای مقادیر مشخصه پذیرفته شده، مشخصات داده موجودی محصول محلی را ببینید

instore_ product_ location

string

محل قرارگیری محصول در داخل فروشگاه حداکثر طول 20 بایت است.

موجودی منطقه ای

اطلاعات موجودی منطقه ای محصول نشان دهنده اطلاعات خاصی مانند قیمت و در دسترس بودن برای یک محصول معین در یک 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

در دسترس بودن محصول در این منطقه برای مقادیر مشخصه پذیرفته شده، مشخصات داده های موجودی محصول منطقه ای را ببینید