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

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

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

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

  • खाते का ऑटोमैटिक मैनेजमेंट
  • प्रॉडक्ट का ऑटोमैटिक मैनेजमेंट
  • इन्वेंट्री का ऑटोमैटिक मैनेजमेंट
  • परफ़ॉर्मेंस और मार्केट इनसाइट के बारे में रिपोर्ट का ऑटोमैटिक मैनेजमेंट

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

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

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

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

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

सहायता पाएं

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

सुझाव दें

सुझाव देने के लिए, इनमें से कोई एक तरीका अपनाएं:

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

  • बैकवर्ड कंपैटिबिलिटी के बारे में जानकारी के लिए, Content API for Shopping की कंपैटिबिलिटी देखें.

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

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

आगे बढ़ें
Terms and Conditions