Merchant API के बारे में खास जानकारी

इस पेज पर, Merchant API के बारे में जानकारी दी गई है. साथ ही, Merchant Center पर खातों, प्रॉडक्ट, और इन्वेंट्री को मैनेज करने से जुड़े अलग-अलग वर्कफ़्लो को ऑटोमेट करने के लिए, इसका इस्तेमाल करने का तरीका बताया गया है.

ज़्यादा ग्राहकों तक पहुंचने और Google के सभी प्लैटफ़ॉर्म पर अपने प्रॉडक्ट दिखाने के लिए, Merchant API का इस्तेमाल किया जा सकता है. Merchant Center के बड़े या कॉम्प्लेक्स खातों को मैनेज करने के लिए, Merchant API का इस्तेमाल किया जा सकता है. इस्तेमाल के कुछ सामान्य उदाहरणों में ये शामिल हैं:

  • खाते का अपने-आप मैनेज होना
  • प्रॉडक्ट का अपने-आप मैनेज होना
  • ऑटोमेटेड इन्वेंट्री मैनेजमेंट
  • कस्टम रिपोर्टिंग

Merchant API की मदद से, कई डेटा सोर्स बनाए और मैनेज किए जा सकते हैं. इससे प्रॉडक्ट, प्रमोशन, और समीक्षाओं की जानकारी को बेहतर तरीके से व्यवस्थित किया जा सकता है. Merchant API की मदद से, प्रॉडक्ट को इस तरह मैनेज किया जा सकता है कि वह फ़ाइलों और ऑटोफ़ीड जैसे प्रॉडक्ट डेटा अपलोड करने के अन्य तरीकों के साथ काम करे.

Merchant API, Content API for Shopping का फिर से डिज़ाइन किया गया वर्शन है. इसमें कई सब-एपीआई शामिल हैं.

खुदरा दुकानदारों को शॉपिंग विज्ञापनों और मुफ़्त में दिखाई जाने वाली लिस्टिंग की नीतियों का पालन करना होगा. Google Shopping, इन नीतियों को लागू करने का अधिकार सुरक्षित रखता है. साथ ही, अगर हमें इन नीतियों का उल्लंघन करने वाला कॉन्टेंट या व्यवहार मिलता है, तो हम ज़रूरत के हिसाब से कार्रवाई करेंगे.

Merchant API में नया क्या है

Merchant API पर अपग्रेड करने की कुछ वजहें यहां दी गई हैं:

  • इन्वेंट्री डेटा को बेहतर तरीके से मैनेज करने के लिए, यहां दिए गए नए तरीकों का इस्तेमाल करें:

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

  • इससे आपके प्रॉडक्ट डेटा में हुए बदलावों के बारे में सूचनाएं मिलती हैं. इससे, प्रॉडक्ट की स्थिति में बदलाव होने पर, समय-समय पर डेटा फ़ेच करने की ज़रूरत नहीं पड़ती.

  • अपने-आप फ़ीड होने की सेटिंग को वापस पाने और अपडेट करने के लिए, accounts.autofeedSettings संसाधन और तरीकों के बारे में जानकारी दी गई है.

  • प्रॉडक्ट की समीक्षाएं और कारोबारी/कंपनी की समीक्षाएं अपलोड करने की सुविधा जोड़ी गई है.

  • accounts.productInputs रिसॉर्स के ज़रिए, accounts.products रिसॉर्स को आसान बनाया गया है.

  • फ़ाइलों जैसे डेटा अपलोड करने के अन्य तरीकों के साथ-साथ, प्रॉडक्ट डेटा को अपडेट करने की सुविधा देता है.

  • प्रॉडक्ट के अलावा, वेबसाइट की परफ़ॉर्मेंस के डेटा के लिए नई NonProductPerformanceView टेबल. जैसे, खुदरा दुकानदार की वेबसाइट पर आने वाले ट्रैफ़िक की जानकारी.

  • मॉड्यूलर डिज़ाइन, जिसमें अलग-अलग सुविधाओं में बार-बार और बेहतर सुधार किए जाते हैं.

  • Google के एपीआई को बेहतर बनाने के सुझावों के साथ बेहतर अलाइनमेंट.

  • अपडेट किए गए दस्तावेज़ और कोड सैंपल.

ज़्यादा जानकारी के लिए, Merchant API के बीटा वर्शन में जोड़ी गई नई सुविधाएं देखें.

शुरू करने से पहले

Merchant API का अनुरोध करने के लिए, आपके पास ये चीज़ें होनी चाहिए:

  • Merchant Center खाता: यह वह खाता है जिसमें डेटा को क्वेरी किया जाएगा, अपडेट किया जाएगा, और अपलोड किया जाएगा. पक्का करें कि आपके पास इस खाते में प्रॉडक्ट और इन्वेंट्री मैनेज करने के लिए ज़रूरी अनुमतियां हों.

  • Google Cloud प्रोजेक्ट: इस प्रोजेक्ट का इस्तेमाल, आपके खाते का एपीआई ऐक्सेस पाने के लिए किया जाता है.

Merchant API की मदद से पुष्टि करना

पुष्टि करने के लिए, इन विकल्पों का इस्तेमाल किया जा सकता है:

  • अपने ऐप्लिकेशन के लिए, OAuth 2.0 क्लाइंट आईडी और पासवर्ड जनरेट किया जा सकता है. इसके बाद, इस आईडी और पासवर्ड का इस्तेमाल करके, Merchant Center खाते के लिए एपीआई कॉल में ज़रूरी OAuth 2.0 क्रेडेंशियल जनरेट किए जा सकते हैं.
  • एपीआई कॉल करने के लिए, सर्विस खाता बनाया जा सकता है और उसकी निजी कुंजी डाउनलोड की जा सकती है.

खाता और प्रॉडक्ट आइडेंटिफ़ायर

Merchant API, पहचान करने के लिए आईडी के बजाय रिसॉर्स के नाम का इस्तेमाल करता है. किसी प्रॉडक्ट के लिए संसाधन का नाम, उदाहरण के लिए accounts/123456/products/online~en~US~sku123 हो सकता है. इसमें 123456, खाते का यूनीक आइडेंटिफ़ायर है और online~en~US~sku123, प्रॉडक्ट का यूनीक आइडेंटिफ़ायर है.

अनुरोध का यूआरएल फ़ॉर्मैट

किसी संसाधन पर काम करने के लिए, यूआरएल पर इस फ़ॉर्मैट में अनुरोध भेजें:

https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}

list और get जैसे स्टैंडर्ड तरीकों के लिए, :{METHOD} वाला हिस्सा हटा दिया जाता है.

उदाहरण के लिए, इस अनुरोध से रीजनल इन्वेंट्री मिट जाती है:

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123456/products/online~en~US~sku123/regionalInventories/456

नया संसाधन बनाने के लिए, पैरंट संसाधन के नाम और नीचे दिए गए यूआरएल का इस्तेमाल किया जा सकता है:

POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}

उदाहरण के लिए, नीचे दिए गए अनुरोध में बताया गया है कि accounts/123456 के लिए नया क्षेत्र कैसे बनाया जा सकता है:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123456/regions?regionId=WA HTTP/1.1

{
  "displayName": "Washington",
  "name": "Washington",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98039",
        "end": "98118"
      }
    ],
    "regionCode": "US"
  }
}

खास सेवाओं के बारे में ज़्यादा जानने के लिए, Merchant API का रेफ़रंस दस्तावेज़ देखें.

Merchant API का इस्तेमाल शुरू करना

Merchant API के काम करने का तरीका तुरंत जानने और प्रॉडक्ट का सैंपल अपलोड करने के लिए, Merchant API का इस्तेमाल शुरू करना लेख पढ़ें.

gRPC या REST का इस्तेमाल करना

Merchant API, gRPC और REST के साथ काम करता है. Merchant Center के एपीआई कॉल करने के दो तरीके यहां दिए गए हैं:

gRPC (सुझाया गया) REST
  1. अनुरोध का मुख्य हिस्सा, प्रोटोकॉल बफ़र के तौर पर बनाएं.
  2. एचटीटीपी/2 के साथ सर्वर को अनुरोध बॉडी भेजें.
  3. प्रोटोकॉल बफ़र में जवाब को डिसिएरियलाइज़ करें.
  4. परिणामों की व्याख्या करें.
  1. अनुरोध का मुख्य हिस्सा, JSON ऑब्जेक्ट के तौर पर बनाएं.
  2. इसे एचटीटीपी 1.1 का इस्तेमाल करके सर्वर पर भेजें.
  3. रिस्पॉन्स को JSON ऑब्जेक्ट के तौर पर डीसीरीलाइज़ करें.
  4. परिणामों की व्याख्या करें.

क्लाइंट लाइब्रेरी और कोड सैंपल का इस्तेमाल करना

हर सब-एपीआई में क्लाइंट लाइब्रेरी होती हैं, ताकि आप शुरू कर सकें. कोड के सैंपल की मदद से, Java, PHP, और Python में कोड लिखना शुरू किया जा सकता है. ज़्यादा जानकारी के लिए, Merchant API के लिए सैंपल देखें.

सहायता पाएं

सहायता पाने के बारे में जानकारी के लिए, Merchant API से जुड़ी मदद पाएं लेख पढ़ें.

सुझाव दें

बीटा वर्शन की अवधि के दौरान, हमें आपके सुझाव/राय/शिकायत इकट्ठा करने और उन पर कार्रवाई करने का मौका मिलता है. ऐसा, सामान्य तौर पर उपलब्ध होने से पहले किया जाता है. सुझाव/राय देने या शिकायत करने के लिए, इनमें से कोई एक सबमिट करें:

  • एपीआई की सुविधाएं: फ़ीडबैक फ़ॉर्म सबमिट करें
  • दस्तावेज़: पेज पर मौजूद थंब रेटिंग और सुझाव/राय दें या शिकायत करें बटन का इस्तेमाल करें.
  • सैंपल और लाइब्रेरी: कोड सैंपल के लिए, GitHub के डेटा स्टोर करने की जगह पर समस्या दर्ज करें.

हर टास्क लागू करने के बाद सामान्य सुझाव, राय या शिकायत देने के लिए, सुझाव, राय या शिकायत वाले फ़ॉर्म का इस्तेमाल करें.

आगे क्या करना है

  • पुराने वर्शन के साथ काम करने की सुविधा के बारे में जानने के लिए, Content API for Shopping के साथ काम करने की सुविधा देखें.

  • Merchant API की मुख्य सुविधाओं के बारे में ज़्यादा जानने के लिए, बाईं ओर मौजूद नेविगेशन मेन्यू में गाइड देखें.

  • उपलब्ध संसाधनों और सेवाओं के बारे में जानकारी के लिए, रेफ़रंस दस्तावेज़ देखें.

आगे बढ़ें
डिज़ाइन