एपीआई कॉल सीधे तौर पर किए जाते हैं

Merchant API के साथ इंटरैक्ट करने के इस तरीके में, एपीआई एंडपॉइंट को सीधे तौर पर रॉ अनुरोध किए जाते हैं. आम तौर पर, ये अनुरोध एचटीटीपी(एस) पर किए जाते हैं. आपको अनुरोध का मुख्य हिस्सा बनाना, हेडर सेट करना (इसमें पुष्टि करना भी शामिल है), और जवाब को पार्स करना जैसे काम मैन्युअल तरीके से करने होते हैं.

पहला चरण. डेवलपर के रूप में पंजीकृत करें

Merchant API का इस्तेमाल करने के लिए, आपको डेवलपर की संपर्क जानकारी रजिस्टर करनी होगी.

रजिस्ट्रेशन से ये काम किए जा सकते हैं:

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

रजिस्टर करते समय, रजिस्ट्रेशन पेज पर दी गई ज़रूरी शर्तों और पाबंदियों का पालन करें.

developerRegistration.registerGcp तरीके का इस्तेमाल करके रजिस्टर करने के लिए, इस उदाहरण से शुरुआत करें. अनुरोध के मुख्य हिस्से में, {DEVELOPER_EMAIL} को सही ईमेल पते से बदलें.

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
  "developerEmail": "{DEVELOPER_EMAIL}"
}

कॉल पूरा होने पर, DeveloperRegistration संसाधन मिलता है. इससे पुष्टि होती है कि आपका प्रोजेक्ट और खाता लिंक हो गया है.

{
  "name": "accounts/{ACCOUNT_ID}/developerRegistration",
  "gcpIds": [
    "123456789012345"
  ]
}

दूसरा चरण. डेवलपर के संपर्कों और अनुमतियों को मैनेज करना

रजिस्टर करने पर:

  • अगर ईमेल पता, Merchant Center खाते के किसी उपयोगकर्ता का है, तो उस उपयोगकर्ता को API_DEVELOPER की भूमिका असाइन की जाती है.
  • अगर ईमेल पता किसी मौजूदा उपयोगकर्ता का नहीं है, तो उस पते पर न्योता भेजा जाता है. API_DEVELOPER भूमिका के साथ नए उपयोगकर्ता के तौर पर जोड़े जाने के लिए, न्योता पाने वाले व्यक्ति को न्योता स्वीकार करना होगा.

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

दूसरा चरण. अतिरिक्त अनुमतियां देना

अहम सूचनाएं पाने के लिए, API_DEVELOPER भूमिका ज़रूरी है. हालांकि, इसके पास Merchant Center में बहुत कम अनुमतियां होती हैं. इस उपयोगकर्ता को अन्य एपीआई कॉल करने या Merchant Center के यूज़र इंटरफ़ेस (यूआई) में सेटिंग मैनेज करने की अनुमति देने के लिए, आपको उसे अतिरिक्त भूमिकाएं देनी होंगी. जैसे, STANDARD या ADMIN. ज़्यादा जानकारी के लिए, ऐक्सेस के टाइप लेख पढ़ें.

accounts.users.patch तरीके का इस्तेमाल करके, किसी उपयोगकर्ता के ऐक्सेस के अधिकारों को अपडेट किया जा सकता है.

यहां दिए गए उदाहरण में, किसी उपयोगकर्ता को ADMIN और API_DEVELOPER, दोनों भूमिकाएं देने के लिए उसे अपडेट करने का तरीका बताया गया है. इससे वे खाते को पूरी तरह से मैनेज कर पाएंगे. साथ ही, उन्हें एपीआई से जुड़ी सूचनाएं भी मिलेंगी.

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{DEVELOPER_EMAIL}?update_mask=access_rights

{
  "access_rights": [
    "ADMIN",
    "API_DEVELOPER"
  ]
}

दूसरा चरण. बैकअप डेवलपर जोड़ना

अगर आपका प्राइमरी डेवलपर कॉन्टैक्ट आपके संगठन को छोड़ देता है, तो एपीआई का ऐक्सेस बाधित हो सकता है. इससे बचने के लिए, आपको कम से कम एक बैकअप डेवलपर जोड़ना चाहिए.

accounts.users.create तरीके का इस्तेमाल करके, किसी उपयोगकर्ता को जोड़ा जा सकता है. इसके अलावा, accounts.users.patch तरीके का इस्तेमाल करके, किसी उपयोगकर्ता की जानकारी अपडेट की जा सकती है. हमारा सुझाव है कि इस उपयोगकर्ता को ADMIN और API_DEVELOPER, दोनों भूमिकाएं असाइन करें.

तीसरा चरण. प्रॉडक्ट का प्राइमरी डेटा सोर्स बनाना

कोई प्रॉडक्ट जोड़ने के लिए, आपके पास प्रॉडक्ट का प्राइमरी डेटा सोर्स होना चाहिए. यहां दिए गए अनुरोध में, ऐसा डेटा सोर्स बनाने का तरीका बताया गया है जिसका इस्तेमाल करके, अपने खाते में कोई प्रॉडक्ट डाला जा सकता है:

POST https://merchantapi.googleapis.com/datasources/v1/accounts/{ACCOUNT_ID}/dataSources

{
  "primaryProductDataSource": {
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "feedLabel": "US"
  },
  "name": "primary-data-source",
  "displayName": "Primary Products Data Source"
}

{ACCOUNT_ID} की जगह, बनाए गए Merchant Center खाते का आईडी डालें.

अनुरोध पूरा होने के बाद, आपको यह जवाब दिखेगा:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
  "dataSourceId": "{DATASOURCE_ID}",
  "displayName": "Primary Products Data Source",
  "primaryProductDataSource": {
    "feedLabel": "US",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

name फ़ील्ड की वैल्यू कॉपी करें. प्रॉडक्ट डालने के लिए, आपको इसकी ज़रूरत होगी.

इस डेटा सोर्स को Merchant Center के यूज़र इंटरफ़ेस (यूआई) में देखा जा सकता है. ज़्यादा जानकारी के लिए, डेटा सोर्स टैब को ढूंढने का तरीका लेख पढ़ें.

चरण 4. एक प्रॉडक्ट डालें

डेटा सोर्स बनाने के बाद, उसमें कोई प्रॉडक्ट डालने की कोशिश करें. नीचे दिए गए कोड को चलाएं और सही ACCOUNT_ID की जानकारी दें. {DATASOURCE_NAME} को उस वैल्यू से बदलें जिसे आपने पहले कॉपी किया था.

POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME}
{
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "productAttributes": {
    "gender": "MALE",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}

अनुरोध पूरा होने के बाद, आपको यह जवाब दिखेगा:

{
  "name": "accounts/{ACCOUNT_ID}/productInputs/en~US~tshirt-123",
  "product": "accounts/{ACCOUNT_ID}/products/en~US~tshirt-123",
  "offerId": "tshirt-123",
  "contentLanguage": "en",
  "feedLabel": "US",
  "productAttributes": {
    "brand": "New brand",
    "gender": "MALE"
  }
}

नए प्रॉडक्ट का आईडी en~US~tshirt-123 है. इस प्रॉडक्ट के बारे में जानकारी पाने के लिए, accounts.products.get तरीके का इस्तेमाल किया जा सकता है. इस प्रॉडक्ट को देखने के लिए, Merchant Center के यूज़र इंटरफ़ेस (यूआई) का भी इस्तेमाल किया जा सकता है. अपना प्रॉडक्ट डेटा देखना लेख पढ़ें.

पीछे जाएं
Overview
आगे बढ़ें
Client libraries