سرویس موجودی محلی به شما امکان می دهد نمونه هایی از منبع موجودی محلی را ایجاد و به روز کنید که حاوی فیلدهایی هستند که می توانند مقادیر متفاوتی برای مکان های مختلف فروشگاه فیزیکی داشته باشند. هر نمونه موجودی محلی فرزند یک منبع محصول موجود است و فیلدهای داده محصول را از منبع اصلی به ارث می برد. برای مثال، ممکن است محصولی داشته باشید که قیمت و مقدار متفاوتی در فروشگاه‌های مختلف دارد، اما شناسه، توضیحات و سایر داده‌های محصول را در همه فروشگاه‌ها به اشتراک می‌گذارد. داده‌های موجودی محلی برای سطوح محلی در سراسر Google و برنامه‌های تبلیغات موجودی محلی استفاده می‌شود.
این راهنما قبل از شروع استفاده از سرویس موجودی محلی به آنچه نیاز دارید توضیح می دهد، زمینه ها و روش های موجود را توضیح می دهد و نمونه ای از درخواست خدمات را ارائه می دهد.
پیش نیازها
- برای استفاده از سرویس موجودی محلی، باید یک نمایه کسب و کار ایجاد کنید ، نمایه کسب و کار خود را به حساب Merchant Center خود پیوند دهید ، کسب و کار خود را تأیید کنید و کدهای فروشگاه نمایه کسب و کار خود را تنظیم کنید .
حساب Merchant Center شما باید در یک برنامه محلی ثبت شود: یا سطوح محلی در سراسر Google یا تبلیغات موجودی محلی . برای اطلاعات بیشتر در مورد استفاده از تبلیغات موجودی محلی از طریق Content API، به شروع با تبلیغات موجودی محلی مراجعه کنید.
سرویس موجودی محلی نمونه‌های موجودی محلی را برای محصولات محلی موجود ایجاد می‌کند. ابتدا باید محصولات محلی را با استفاده از سرویس محصولات Content API یا فیدهای داده Merchant Center با تنظیم فیلد
channelرویlocalایجاد کنید. سپس می توانید از سرویس موجودی محلی برای ایجاد نمونه های موجودی محلی برای هرstorecodeنمایه کسب و کار که در آن محصول فروخته می شود استفاده کنید.
فیلدها
هر نمونه موجودی محلی شامل مجموعه‌ای از فیلدها است که از طریق فیلد storeCode (که در نمایه کسب‌وکار خود تعریف می‌کنید) با یک مکان فروشگاه خاص مرتبط است. برای همه درخواست‌ها فقط storecode و productId لازم است. تمام فیلدهای دیگر اختیاری هستند:
- مورد نیاز برای همه درخواست‌ها:
storeCode،productId(در URL) - اختیاری:
quantity،price،salePrice،salePriceEffectiveDate،availability،pickupMethod،pickupSla،instoreProductLocation
برای فهرست کامل فیلدهای موجودی محلی و توضیحات آنها، به صفحه مرجع موجودی محلی مراجعه کنید.
روش ها
خدمات موجودی محلی فقط شامل دو روش است:
localinventory.insert
localinventory.insert به شما امکان می دهد یک نمونه موجودی محلی برای یک محصول محلی واحد ایجاد کنید.
این مثال نحوه استفاده از سرویس موجودی محلی را برای ایجاد یک فروش در فروشگاه از 24 فوریه 2021 در ساعت 1:00 بعد از ظهر (GMT-8) تا 28 فوریه 2021 در ساعت 3:30 بعد از ظهر (GMT-8) نشان می دهد. این درخواست همچنین مقدار موجود برای نمونه موجودی محلی را به روز می کند. برخلاف فیدهای تکمیلی برای داده‌های محصول غیرمحلی، فیلدهایی که در متن درخواست گنجانده نشده‌اند توسط این تماس بازنویسی می‌شوند:
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId/localinventory
{
"storeCode": “1235”,
"salePrice": {
"value": “100.00”,
"currency": “USD”
},
"salePriceEffectiveDate": “2021-02-24T13:00-0800/2021-02-28T15:30-0800”,
"quantity": 200,
}
موجودی محلی.سفارشی
localinventory.custombatch به شما امکان می دهد چندین نمونه موجودی محلی برای یک محصول محلی واحد در چندین فروشگاه ایجاد کنید، یا نمونه های موجودی محلی را برای چندین محصول محلی ایجاد کنید.