माइग्रेशन शुरू करना

इस पेज पर, हम आपको एपीआई माइग्रेशन की योजना बनाने के बारे में सलाह देते हैं.

इसके बाद, हम आपको माइग्रेट करने के लिए ज़रूरी चरणों के बारे में खास जानकारी देंगे.

माइग्रेशन की योजना बनाना

  1. Content API for Shopping के तरीकों को Merchant API के तरीकों से मैप करें.

    इससे, Merchant API के लिए ज़रूरी नए तरीकों और संसाधनों को समझने में मदद मिलती है.

  2. माइग्रेशन पर लागू होने वाले सबसे अहम बदलावों के बारे में जानें.

    हमारा सुझाव है कि आप इन संसाधनों को देखें और इन्हें ध्यान में रखें. इनसे आपको माइग्रेट करने में मदद मिलेगी:

    • Content API की खास जानकारी से माइग्रेट करना: इसमें Merchant API में होने वाले मुख्य बदलावों के बारे में बताया गया है
    • सब-एपीआई के लिए माइग्रेशन गाइड: उन सब-एपीआई के लिए माइग्रेशन गाइड देखें जिनकी आपको ज़रूरत है. इनमें नई फ़ील्ड मैपिंग जैसी ज़रूरी जानकारी होती है. उदाहरण के लिए, प्रॉडक्ट मैनेजमेंट से जुड़े डेटा को माइग्रेट करना लेख देखें.
    • Merchant API के रेफ़रंस में, Merchant API के संसाधनों और तरीकों के बारे में जानकारी दी गई है.
    • क्विकस्टार्ट गाइड में, Merchant API का इस्तेमाल तुरंत शुरू करने का तरीका बताया गया है. इसमें खाता बनाने और प्रॉडक्ट का सैंपल अपलोड करने का तरीका भी बताया गया है.
    • सुविधा के हिसाब से गाइड: नई सुविधा को लागू करने या ज़्यादा जानकारी पाने के लिए, नेविगेशन में दी गई सुविधा से जुड़ी गाइड देखें.
  3. उन सब-एपीआई की पहचान करें जिन्हें आपको माइग्रेट करना है और लागू करना है.

    इन दो बातों का पता लगाएं:

    • Merchant API की वे सुविधाएं जिन्हें माइग्रेट करना ज़रूरी है
    • आपको लागू करनी हैं नई सुविधाएं

    ऐसा करने के बाद, यह तय किया जा सकता है कि किस सब-एपीआई पर काम करने में कितना समय लगेगा और किस सब-एपीआई को प्राथमिकता दी जानी चाहिए.

    हमारा सुझाव है कि आप सभी डेटा को माइग्रेट करें या जितना हो सके उतना डेटा माइग्रेट करें. अगर आपको अहमियत और जटिलता की वजह से, शुरुआत में Content API के पूरे इंटिग्रेशन को माइग्रेट करने में समस्या आ रही है, तो इन सब-एपीआई को प्राथमिकता दें.

माइग्रेशन के चरण

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

  2. अलग-अलग तरीकों को आज़माएं, ताकि आपको ज़्यादा से ज़्यादा मदद मिल सके. हमारा सुझाव है कि बुनियादी टेस्ट करने के लिए, Google APIs Explorer का इस्तेमाल करें.

    Merchant API के लिए अनुरोध वाले यूआरएल का फ़ॉर्मैट यह है

    https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}
    
  3. हमारे कोड के सैंपल और क्लाइंट लाइब्रेरी का फ़ायदा पाएं.

    gRPC का फ़ायदा पाने और इसे लागू करने में लगने वाला समय कम करने के लिए, क्लाइंट लाइब्रेरी और कोड के सैंपल का इस्तेमाल करें.

    हम अपनी गाइड में कोड सैंपल स्निपेट भी एम्बेड करते हैं. उदाहरण के लिए, कोई प्रॉडक्ट जोड़ना लेख पढ़ें.

  4. उपयोगकर्ता के सामान्य टास्क पूरे करने की जांच करें.

    उपयोगकर्ता के अनुभव की जांच, उन सभी सब-एपीआई और फ़ंक्शन पर करें जिन्हें आपको माइग्रेट करना है. इसके लिए, इन लक्ष्यों को पूरा करें:

    • माइग्रेट किए गए संसाधनों और कॉल के जवाब के नतीजे सही हों.
    • गड़बड़ी का अनुपात कम रहता है.

रोल आउट करने का प्लान बनाना

हमारा सुझाव है कि आप यह तरीका अपनाएं:

  • एक बार में, एक सब-एपीआई या तरीके को लागू करें.
  • इसे एक बार में, कारोबार के सिर्फ़ एक छोटे हिस्से में लागू करें.
  • हमेशा समस्याओं पर नज़र रखें.

माइग्रेशन लागू करना

  1. नए संसाधनों और एंडपॉइंट का इस्तेमाल करके कोडिंग करें.

    रिलीज़ प्लान की शुरुआती टेस्टिंग और डेवलपमेंट के बाद, Merchant API को अपने वर्कफ़्लो में इंटिग्रेट करें.

  2. मॉनिटर करें.

    संभावित समस्याओं को ठीक करने के लिए तैयार रहें.