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

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

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

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

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

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

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

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

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

डेटा सोर्स बनाने के बाद, उसमें कोई प्रॉडक्ट जोड़ने की कोशिश करें. यहां दिया गया अनुरोध पूरा करें. इसके लिए, सही 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 में प्रॉडक्ट की खास जानकारी देखें.