Merchant API का इस्तेमाल शुरू करना

इस पेज पर बताया गया है कि Merchant Center खाता कैसे बनाया जा सकता है. साथ ही, Merchant API का इस्तेमाल करके प्रॉडक्ट का सैंपल कैसे अपलोड किया जा सकता है.

शुरू करने से पहले

अपने Google Cloud प्रोजेक्ट में Merchant API चालू करें.

अगर Shopping Content Service का इस्तेमाल करके, AppScript में एपीआई इंटिग्रेशन किया जाता है, तो यह डिफ़ॉल्ट Google Cloud प्रोजेक्ट बनाता है. साथ ही, Merchant API सेवा को अपने-आप चालू कर देता है. हालांकि, Merchant API का इस्तेमाल करने से पहले, आपको डेवलपर के तौर पर एक बार रजिस्टर करना होगा. ज़्यादा जानकारी के लिए, Apps Script में Merchant API Service का इस्तेमाल करना लेख पढ़ें.

Google Cloud पर जाएं

खाता बनाएं

Merchant API का इस्तेमाल करने के लिए, आपके पास Merchant Center खाता होना चाहिए. इसे बनाने के लिए, Merchant Center का इस्तेमाल शुरू करना लेख पढ़ें.

Merchant Center पर जाएं

डेवलपर के रूप में पंजीकृत करें

Merchant API का इस्तेमाल करने के लिए, आपको अपने Google Cloud प्रोजेक्ट और मुख्य Merchant Center खाते के बीच लिंक बनाना होगा. Merchant API के साथ इस्तेमाल किए जाने वाले हर Google Cloud प्रोजेक्ट के लिए, एक बार रजिस्टर करना ज़रूरी है.

डेवलपर के तौर पर रजिस्टर करने से दो काम होते हैं:

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

Google Cloud प्रोजेक्ट रजिस्टर करना

रजिस्टर करने के लिए, developerRegistration.registerGcp तरीके को कॉल करें. इस कॉल से, कॉल करने के लिए इस्तेमाल किए जा रहे Google Cloud प्रोजेक्ट को उस Merchant Center खाते से लिंक किया जाता है जिसे आपने अनुरोध में बताया है.

अनुरोध के मुख्य हिस्से में, आपको डेवलपर का ईमेल पता देना होगा, ताकि उसका इस्तेमाल तकनीकी संपर्क के तौर पर किया जा सके. यह पता, किसी Google खाते (Google Workspace खाता या Gmail खाता) से जुड़ा होना चाहिए. उदाहरण के लिए, sampleuser@gmail.com.

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

अनुरोध का एक उदाहरण यहां दिया गया है:

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

{
  "developerEmail": "{DEVELOPER_EMAIL}"
}

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

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

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

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

अतिरिक्त अनुमतियां देना

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

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

एक प्रॉडक्ट डालें

अपने खाते में सैंपल प्रॉडक्ट डालने के लिए, यह अनुरोध चलाएं:

POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1

{
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "attributes": {
    "gender": "Male",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}

{DATASOURCE_NAME} को उस वैल्यू से बदलें जिसे आपने पहले कॉपी किया था.

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

{
  "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",
  "attributes": {
    "brand": "New brand",
    "gender": "Male"
  }
}

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

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