स्थानीय इन्वेंट्री सेवा

स्थानीय इन्वेंट्री सेवा की मदद से, स्थानीय इन्वेंट्री संसाधन के इंस्टेंस बनाए और अपडेट किए जा सकते हैं. इनमें ऐसे फ़ील्ड शामिल होते हैं जिनकी अलग-अलग दुकानों के लिए, अलग-अलग वैल्यू हो सकती हैं. हर स्थानीय इन्वेंट्री इंस्टेंस किसी मौजूदा प्रॉडक्ट संसाधन का चाइल्ड है. साथ ही, यह पैरंट रिसॉर्स से प्रॉडक्ट डेटा फ़ील्ड इनहेरिट करता है. उदाहरण के लिए, हो सकता है कि आपके पास ऐसा प्रॉडक्ट हो जिसकी कीमत और संख्या अलग-अलग स्टोर में अलग-अलग हो, लेकिन सभी स्टोर में मौजूद प्रॉडक्ट का आईडी, ब्यौरा, और अन्य प्रॉडक्ट डेटा शेयर किया गया हो. स्थानीय इन्वेंट्री डेटा का इस्तेमाल, Local surfaces across Google और स्थानीय इन्वेंट्री विज्ञापन प्रोग्राम के लिए किया जाता है.

इस गाइड में बताया गया है कि स्थानीय इन्वेंट्री सेवा का इस्तेमाल शुरू करने से पहले आपको किन चीज़ों की ज़रूरत होगी. साथ ही, इसमें उपलब्ध फ़ील्ड और तरीकों के बारे में बताया गया है और सेवा के अनुरोध का उदाहरण भी दिया गया है.

ज़रूरी शर्तें

  • स्थानीय इन्वेंट्री सेवा का इस्तेमाल करने के लिए, आपको Business Profile बनाना, Business Profile को अपने Merchant Center खाते से लिंक करना, अपने कारोबार की पुष्टि करना, और Business Profile में मौजूद स्टोर कोड सेट अप करना होगा.

  • आपका Merchant Center खाता किसी स्थानीय प्रोग्राम में रजिस्टर होना चाहिए: Local surfaces across Google या स्थानीय इन्वेंट्री विज्ञापन. Content API की मदद से स्थानीय इन्वेंट्री विज्ञापनों का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, स्थानीय इन्वेंट्री विज्ञापनों का इस्तेमाल शुरू करना लेख पढ़ें.

  • स्थानीय इन्वेंट्री सेवा, मौजूदा स्थानीय प्रॉडक्ट के लिए स्थानीय इन्वेंट्री इंस्टेंस बनाती है. सबसे पहले, आपको channel फ़ील्ड को local पर सेट करके, Content API प्रॉडक्ट सेवा या Merchant Center के डेटाफ़ीड का इस्तेमाल करके, स्थानीय प्रॉडक्ट बनाने होंगे. इसके बाद, स्थानीय इन्वेंट्री सेवा का इस्तेमाल करके, हर उस Business Profile storecode के लिए स्थानीय इन्वेंट्री इंस्टेंस बनाए जा सकते हैं जहां प्रॉडक्ट बेचा जाता है.

फ़ील्ड

हर स्थानीय इन्वेंट्री इंस्टेंस में फ़ील्ड का एक सेट होता है, जो storeCode फ़ील्ड (जिसे अपनी Business Profile में बताया जाता है) के ज़रिए किसी खास स्टोर की जगह से जुड़ा होता है. सभी अनुरोधों के लिए सिर्फ़ storecode और productId ज़रूरी हैं. दूसरे सभी फ़ील्ड ज़रूरी नहीं हैं:

  • सभी अनुरोधों के लिए ज़रूरी है: storeCode, productId (यूआरएल में)
  • ज़रूरी नहीं: quantity, price, salePrice, salePriceEffectiveDate, availability, pickupMethod, pickupSla, instoreProductLocation

स्थानीय इन्वेंट्री फ़ील्ड और उनसे जुड़ी जानकारी की पूरी सूची देखने के लिए, localinventory से जुड़ा रेफ़रंस पेज देखें.

तरीके

स्थानीय इन्वेंट्री सेवा में सिर्फ़ दो तरीके शामिल हैं:

localinventory.insert

localinventory.insert की मदद से, एक स्थानीय प्रॉडक्ट के लिए स्थानीय इन्वेंट्री इंस्टेंस बनाया जा सकता है.

इस उदाहरण में बताया गया है कि 24 फ़रवरी, 2021 को दोपहर 1 बजे (जीएमटी-8) से लेकर 28 फ़रवरी, 2021 को दोपहर 3:30 बजे (जीएमटी-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

localinventory.custombatch इसकी मदद से, कई स्टोर में मौजूद किसी स्थानीय प्रॉडक्ट के लिए, कई स्थानीय इन्वेंट्री इंस्टेंस बनाए जा सकते हैं. इसके अलावा, कई स्थानीय प्रॉडक्ट के लिए स्थानीय इन्वेंट्री इंस्टेंस बनाए जा सकते हैं.