कंपैरिज़न शॉपिंग सर्विस (सीएसएस) का इस्तेमाल शुरू करना

एपीआई का इस्तेमाल शुरू करने के लिए, उससे बुनियादी काम करना एक अच्छा तरीका है.

ज़रूरी शर्तें

शुरू करने से पहले, ये काम पूरे करें:

  • पक्का करें कि आपके पास मान्य CSS Center खाता हो.
  • एपीआई डेवलपर को रजिस्टर करें.
  • पुष्टि करें कि अनुमतियों का सेटअप सही है या नहीं.
  • पुष्टि करें कि आपने सीएसएस एपीआई चालू किया हो.
  • पुष्टि करें कि आपने अपने एनवायरमेंट के लिए क्लाइंट लाइब्रेरी इंस्टॉल कर ली हैं.

ज़्यादा जानकारी के लिए, क्विकस्टार्ट लेख पढ़ें.

CSS API को चालू करना

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

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

एपीआई डेवलपर को रजिस्टर करना

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

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

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

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

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

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

सीएसएस प्रॉडक्ट

प्रॉडक्ट सब-एपीआई की तरह ही, CSS API भी CssProductInput और ListCssProduct के बीच अंतर करता है. InsertCssProductInput का इस्तेमाल करके कोई प्रॉडक्ट डालें.

हमारे इंटरनल सिस्टम के प्रॉडक्ट को प्रोसेस करने में कुछ समय लग सकता है. इसके बाद, ListCssProducts का इस्तेमाल करके प्रॉडक्ट को वापस पाएं.

raw_provided_id का इस्तेमाल करके, अपने प्रॉडक्ट की पहचान करें. हमारा सुझाव है कि आप अपने सिस्टम में पहले से इस्तेमाल किए जा रहे आइडेंटिफ़ायर का इस्तेमाल करें. इसके अलावा, एक कैंपेन बनाने के लिए, इनमें से किसी एक तरीके का इस्तेमाल किया जा सकता है:

  • ग्लोबल यूनीक आइडेंटिफ़ायर (GUID)
  • यूनिवर्सल यूनीक आइडेंटिफ़ायर (यूयूआईडी)
  • प्रॉडक्ट के यूनीक एट्रिब्यूट को आपस में जोड़ना (उदाहरण के लिए, brand_model_color_size)

ज़्यादा जानकारी के लिए, प्रॉडक्ट डालना/सूची बनाना/अपडेट करना/मिटाएं लेख पढ़ें.

बुनियादी कार्रवाइयां

यहां कुछ बुनियादी अनुरोध दिए गए हैं. इन्हें आज़माकर देखें.

  1. InsertCssProductInput का इस्तेमाल करके, टेस्ट प्रॉडक्ट डालें. भेजे जाने वाले एट्रिब्यूट के बारे में मदद पाने के लिए, यह सैंपल कोड देखें.

  2. ListCssProducts का इस्तेमाल करके, अपने सभी प्रॉडक्ट की लिस्ट बनाएं. ध्यान दें कि किसी प्रॉडक्ट को डालने और उसे लिस्टिंग में दिखने में थोड़ी देरी होती है. अगर आपको तुरंत कोई विकल्प नहीं दिखता है, तो कुछ सेकंड बाद फिर से कोशिश करें.

  3. cssproductinput.name का इस्तेमाल करके, UpdateCssProductInput का इस्तेमाल करके किसी एक प्रॉडक्ट को अपडेट करें. आपको सिर्फ़ उन एट्रिब्यूट की वैल्यू भेजनी होगी जिन्हें अपडेट करना ज़रूरी है. उदाहरण के लिए, सैंपल कोड देखें.

  4. raw_provided_id की वैल्यू सबमिट करके, DeleteCssProductInpu का इस्तेमाल करके, टेस्ट प्रॉडक्ट मिटाएं.

सीमाएं

किसी प्रॉडक्ट को डालने या मिटाने में थोड़ा समय लग सकता है. परफ़ॉर्मेंस को बेहतर बनाने के लिए, परफ़ॉर्मेंस को बेहतर बनाने के लिए, ऐसिंक का इस्तेमाल करें. इससे, एपीआई को एक साथ कॉल किया जा सकता है.

अपने खातों की सूची बनाना और उन्हें लेबल करना

CSS API में लेबल मैनेजमेंट की सुविधा की मदद से, कस्टम टैग का इस्तेमाल करके अपने क्लाइंट Merchant Center खातों को प्रोग्राम के हिसाब से व्यवस्थित किया जा सकता है. इस सुविधा की मदद से, क्लाइंट को बेहतर तरीके से कैटगरी में बांटा जा सकता है. जैसे, टाइप या रणनीति के हिसाब से. इससे, क्लाइंट को बेहतर तरीके से मैनेज किया जा सकता है और ऑपरेशन को आसान बनाया जा सकता है. एपीआई का इस्तेमाल करके, लेबल पर ये काम किए जा सकते हैं: