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

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

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

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

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

Google Cloud पर जाएं

खाता बनाएं

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

Merchant Center पर जाएं

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

Merchant API का इस्तेमाल करने के लिए, आपको डेवलपर रजिस्ट्रेशन के तरीके का इस्तेमाल करके, अपने Merchant Center खाते और Google Cloud प्रोजेक्ट को लिंक करना होगा. इसके लिए, यह तरीका अपनाएं:

  1. Merchant Center और अपने Google Cloud प्रोजेक्ट को लिंक करें: लिंक को अपने-आप मंज़ूरी मिल जाती है, क्योंकि कॉल करने वाले के पास Google Cloud प्रोजेक्ट का मान्य ऐक्सेस टोकन या एपीआई पासकोड होता है. साथ ही , वह Merchant Center खाते का आधिकारिक उपयोगकर्ता होता है.

  2. Merchant Center खाते में एपीआई डेवलपर उपयोगकर्ता जोड़ना: रजिस्ट्रेशन एपीआई, Merchant Center खाते में एपीआई डेवलपर उपयोगकर्ता जोड़ता है. अगर कोई उपयोगकर्ता पहले से मौजूद है, तो उसे ऐक्सेस का नया टाइप दिया जाएगा. अगर उपयोगकर्ता नया है, तो उसे Merchant Center में शामिल होने का न्योता ईमेल से मिलेगा.

हमारा सुझाव है कि आप accounts.users.create तरीका इस्तेमाल करके, एपीआई डेवलपर के तौर पर अतिरिक्त या बैकअप खाते जोड़ें. इससे यह पुष्टि की जा सकेगी कि अगर कोई व्यक्ति आपके संगठन को छोड़ देता है या उसका खाता मिटा दिया जाता है, तो भी आपके पास डेवलपर के तौर पर मान्य रजिस्ट्रेशन रहेगा.

रजिस्ट्रेशन के बाद, GetDeveloperRegistration का इस्तेमाल करके रजिस्ट्रेशन का स्टेटस देखा जा सकता है या UnregisterGCP का इस्तेमाल करके रजिस्ट्रेशन रद्द किया जा सकता है.

रजिस्ट्रेशन कॉल

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

{
  developer_email:"example-email@example.com"
}

अनुरोध पूरा होने के बाद, आपको यह जवाब मिल सकता है:

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

एपीआई डेवलपर के रजिस्टर होने के बाद, उसे STANDARD और ADMIN जैसी अन्य भूमिकाएं देने के लिए, accounts.users.patch तरीके का इस्तेमाल किया जा सकता है.

अपना खाता आईडी पाना

accounts.list के तरीके का इस्तेमाल करके, खाता आईडी पाया जा सकता है.

Merchant API के अनुरोध चलाने के लिए, Google APIs Explorer का इस्तेमाल किया जा सकता है. पुष्टि करने के लिए, APIs Explorer, Google OAuth 2.0 का इस्तेमाल करता है. अनुरोध चलाने से पहले, पक्का करें कि Google OAuth 2.0 चेकबॉक्स पर सही का निशान लगा हो.

OAuth 2.0 का इस्तेमाल करके पुष्टि करने के लिए, आपको अपने Google खाते में साइन इन करना होगा. इसके बाद, API Explorer में साइन इन करें. आपको एपीआई एक्सप्लोरर को अपनी प्रॉडक्ट लिस्टिंग और खातों को मैनेज करने की अनुमति भी देनी होगी.

नीचे दिए गए अनुरोध में, खाता आईडी वापस पाने का तरीका बताया गया है:

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts

या

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}

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

{
  "accounts": [
    {
      "name": "{ACCOUNT_NAME}",
      "accountId": "{ACCOUNT_ID}",
      "accountName": "{ACCOUNT_DISPLAY_NAME}",
      "timeZone": {
        "id": "America/Los_Angeles"
      },
      "languageCode": "en-US"
    }
  ]
}

{ACCOUNT_ID} को कॉपी करें, क्योंकि आपको अन्य अनुरोध चलाने के लिए इसकी ज़रूरत पड़ेगी.

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

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

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources HTTP/1.1

{
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "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": {
    "channel": "ONLINE_PRODUCTS",
    "feedLabel": "US",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

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

प्रॉडक्ट डालने के लिए, बनाए गए डेटा सोर्स को उपलब्ध होने में कुछ मिनट लगते हैं.

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

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

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

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

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

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

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

{
  "name": "accounts/{ACCOUNT_ID}/productInputs/online~en~US~tshirt-123",
  "product": "accounts/{ACCOUNT_ID}/products/online~en~US~tshirt-123",
  "channel": "ONLINE",
  "offerId": "tshirt-123",
  "contentLanguage": "en",
  "feedLabel": "US",
  "attributes": {
    "brand": "New brand",
    "gender": "Male"
  }
}

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

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