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

इस पेज पर, एपीआई माइग्रेशन की योजना बनाने के बारे में दिशा-निर्देश दिए गए हैं. साथ ही, इसमें ज़रूरी चरणों के बारे में बताया गया है.

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

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. मॉनिटर करें.

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