मिलें Merchant API से. यह Content API for Shopping की जगह लेने वाला आधिकारिक एपीआई है.

Merchant API की नई सुविधाओं, गड़बड़ियों को ठीक करने के तरीके, और अपडेट के बारे में अपडेट पाएं.

Merchant API का इस्तेमाल शुरू करें और बड़े पैमाने पर डेटा, अहम जानकारी, और खास सुविधाओं का ऐक्सेस पाएं.

ध्यान दें: Content API for Shopping, 18 अगस्त, 2026 को बंद हो जाएगा.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

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

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

ध्यान दें: Content API के 2.1 वर्शन में, स्थानीय इन्वेंट्री सेवा और पूरक फ़ीड, 2.0 वर्शन में मौजूद इन्वेंट्री सेवा की जगह लेते हैं. एपीआई v2.1 की मदद से, स्थानीय प्रॉडक्ट डेटा के अलावा अन्य प्रॉडक्ट डेटा को आंशिक रूप से अपडेट करने के लिए, पूरक फ़ीड का इस्तेमाल करें. स्थानीय प्रॉडक्ट के बारे में अतिरिक्त अपडेट देने के लिए, localinventory सेवा

का इस्तेमाल करें.

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

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

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

फ़ील्ड

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

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

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

तरीके

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

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

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

ध्यान दें: स्थानीय इन्वेंट्री के इंस्टेंस को वापस नहीं लाया जा सकता, उनकी सूची नहीं बनाई जा सकती या उन्हें मिटाया नहीं जा सकता. Merchant Center में स्थानीय इन्वेंट्री का डेटा देखने के लिए, सभी प्रॉडक्ट पेज पर जाकर कोई स्थानीय प्रॉडक्ट चुनें. इसके बाद, स्थानीय इन्वेंट्री सेक्शन को बड़ा करें. इस टेबल में, हर स्टोर कोड के लिए स्थानीय इन्वेंट्री डेटा दिखता है.