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

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

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

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

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

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

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

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 की भूमिका वाले नए उपयोगकर्ता के तौर पर जुड़ने के लिए, न्योता स्वीकार करना होगा.

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

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

अहम सूचनाएं पाने के लिए, 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"
  ]
}

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

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

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 के यूज़र इंटरफ़ेस (यूआई) में देखा जा सकता है. ज़्यादा जानकारी के लिए, डेटा सोर्स टैब को ढूंढने का तरीका देखें.

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

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