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

Merchant API का इस्तेमाल करके ये काम किए जा सकते हैं:

  • यह मैनेज करना कि Google पर आपका कारोबार और प्रॉडक्ट कैसे दिखें.
  • प्रोग्राम के हिसाब से, अपने-आप होने वाली प्रोसेस के ज़रिए डेटा, अहम जानकारी, और यूनीक सुविधाओं का ऐक्सेस पाएं.
  • अपने कारोबार को आगे बढ़ाएं और Google पर ज़्यादा से ज़्यादा ग्राहकों तक पहुंचें.

Merchant API, Merchant Center के बड़े या कॉम्प्लेक्स खातों को मैनेज कर सकता है. आम तौर पर, इस तरह के मामलों में ऐसा किया जाता है:

  • खाते का ऑटोमेटेड मैनेजमेंट
  • प्रॉडक्ट अपने-आप मैनेज होने की सुविधा
  • अपने-आप होने वाला इन्वेंट्री मैनेजमेंट
  • परफ़ॉर्मेंस और मार्केट इनसाइट के लिए, अपने-आप जनरेट होने वाली रिपोर्ट मैनेज करना

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

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

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

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

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

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

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

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

  • आपके Merchant Center खाते और Google Cloud प्रोजेक्ट के बीच लिंक. डेवलपर रजिस्ट्रेशन वाले तरीके को कॉल करके लिंक बनाएं. एपीआई इंटिग्रेशन, सर्वे, और अवसरों के बारे में बातचीत करने के लिए, इस खाते और इन उपयोगकर्ताओं का इस्तेमाल किया जाएगा.

  • डेवलपर के तौर पर रजिस्टर करके, अपने Merchant Center खाते को Google Cloud प्रोजेक्ट से लिंक करें. एपीआई डेवलपर की भूमिका वाले उपयोगकर्ताओं को एपीआई से जुड़ी सूचनाएं मिलेंगी. इनमें सेवा में हुए अहम बदलावों के बारे में ज़रूरी एलान, डेवलपर सर्वे, और मौके शामिल हैं.

Merchant API के साथ पुष्टि करना

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

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

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

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

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

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

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

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

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

DELETE https://merchantapi.googleapis.com/inventories/v1/accounts/123456/products/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/v1/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 API कॉल करने के दो तरीके यहां दिए गए हैं:

gRPC (सुझाया गया) आराम का समय
  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 की मुख्य सुविधाओं के बारे में ज़्यादा जानने के लिए, बाईं ओर मौजूद नेविगेशन मेन्यू में दी गई गाइड देखें.

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

आगे बढ़ें
Merchant API terms and conditions