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

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

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

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

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

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

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

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

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

ज़्यादा जानकारी के लिए, 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}

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

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

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 API कॉल करने के दो तरीके यहां दिए गए हैं:

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

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

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

सहायता पाएं

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

सुझाव दें

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

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

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

पीछे जाएं
Latest updates
आगे बढ़ें
Design