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

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

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

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

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 खाते के बीच लिंक बनाना होगा. Merchant API के साथ इस्तेमाल किए जाने वाले हर Google Cloud प्रोजेक्ट के लिए, एक बार रजिस्टर करना ज़रूरी है. पूरी प्रोसेस यहां देखी जा सकती है.

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

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

   https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}…
   

3. हमारे कोड सैंपल और क्लाइंट लाइब्रेरी का फ़ायदा उठाएं.

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

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

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

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

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

रोल-आउट की योजना बनाना

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

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

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

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

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

2. नज़र रखना.

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