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

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

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

محدوده مجوز

به محدوده 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 مراجعه کنید.

منطقه ای Inventory Service

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

Delete RegionalInventory

rpc DeleteRegionalInventory( DeleteRegionalInventoryRequest ) returns ( Empty )

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

محدوده مجوز

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

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

Insert Regional Inventory

rpc InsertRegionalInventory( InsertRegionalInventoryRequest ) returns ( RegionalInventory )

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

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

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

محدوده مجوز

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

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

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

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 باشد، خدمات کمتر از این مقدار برمی‌گرداند. مقدار پیش فرض 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

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