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/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. इसे एचटीटीपी 1.1 का इस्तेमाल करके सर्वर पर भेजें.
  3. रिस्पॉन्स को JSON ऑब्जेक्ट के तौर पर डीसीरियलाइज़ करें.
  4. परिणामों की व्याख्या करें.

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

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

सहायता पाएं

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

सुझाव दें

सुझाव/राय देने या शिकायत करने के लिए, इनमें से कोई एक विकल्प चुनें:

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

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

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

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

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