Merchant API का बेहतर तरीके से इस्तेमाल करने के लिए, रजिस्ट्रेशन, पुष्टि करने, और अनुमति देने के कॉन्सेप्ट को समझना ज़रूरी है. Merchant Center के डेटा को सुरक्षित और सही तरीके से ऐक्सेस करने के लिए, ये अलग-अलग काम करते हैं.
शब्दावली
रजिस्ट्रेशन, पुष्टि, और अनुमति आपस में जुड़े हुए हैं. हालांकि, हर एक का अलग मतलब और मकसद होता है.
- पुष्टि करना: इस प्रोसेस में, सेवा उस उपयोगकर्ता या ऐप्लिकेशन की पहचान की पुष्टि करती है जो एपीआई अनुरोध कर रहा है. Merchant API, OAuth 2.0 जैसे स्टैंडर्ड Google सिस्टम का इस्तेमाल करता है. पुष्टि करने के लिए, एपीआई पासकोड का इस्तेमाल नहीं किया जा सकता. ऐसा करने पर, पुष्टि करने से जुड़ी गड़बड़ियां होती हैं. ज़्यादा जानकारी के लिए, अनुरोधों की पुष्टि करना और अपने खाते के तौर पर पुष्टि करना लेख पढ़ें.
- अनुमति: इस प्रोसेस से यह तय होता है कि पुष्टि किए गए उपयोगकर्ता या ऐप्लिकेशन को Merchant Center खाते का इस्तेमाल करके, कौनसी कार्रवाइयां करने की अनुमति है. इससे इस सवाल का जवाब मिलता है: "आपके पास कौन-कौनसी कार्रवाइयां करने की अनुमति है?" यह अनुमति, Merchant Center खाते में पुष्टि किए गए उपयोगकर्ता को दी गई भूमिकाओं और अनुमतियों के आधार पर तय होती है. उदाहरण के लिए, हो सकता है कि किसी उपयोगकर्ता को प्रॉडक्ट डेटा पढ़ने की अनुमति हो, लेकिन खाते की सेटिंग में बदलाव करने की अनुमति न हो.
- रजिस्ट्रेशन: Merchant API के लिए, यह एक बार किया जाने वाला सेटअप प्रोसेस है. इसकी मदद से, Google आपको उन कारोबारी खातों के लिए सेवा में हुए अहम बदलावों के एलान भेज सकता है जिन्हें मैनेज किया जाता है. रजिस्ट्रेशन करने पर, आपके डेवलपर ईमेल पते आपके मुख्य Merchant Center खाते में जुड़ जाते हैं. साथ ही, यह आपके खाते को उन Google Cloud प्रोजेक्ट आईडी से लिंक कर देता है जिनका इस्तेमाल पुष्टि करने के लिए किया जाता है. इस लिंक की मदद से, आपके ऐप्लिकेशन को उन सभी कारोबारी खातों के लिए सेवा में हुए अहम बदलावों के एलान मिल सकते हैं जिन्हें मैनेज किया जाता है. ज़्यादा जानकारी के लिए, Google Cloud प्रोजेक्ट बनाना लेख पढ़ें.
रजिस्ट्रेशन
Merchant API का इस्तेमाल करने के लिए, अपने ऐप्लिकेशन को रजिस्टर करना ज़रूरी है. यहां कुछ ज़रूरी जानकारी दी गई है:
ज़रूरी शर्तें
Merchant API का इस्तेमाल करने के लिए, आपको ये काम करने होंगे:
- Merchant Center खाता: आपके पास पहले से कोई Merchant Center खाता होना चाहिए.
- एडमिन ऐक्सेस: रजिस्ट्रेशन कॉल शुरू करने के लिए इस्तेमाल किए जाने वाले Google उपयोगकर्ता खाते के पास, उस Merchant Center खाते के एडमिन के खास अधिकार होने चाहिए जिसे रजिस्टर किया जा रहा है.
- Google Cloud प्रोजेक्ट: आपका ऐप्लिकेशन, किसी Google Cloud प्रोजेक्ट से जुड़ा होना चाहिए. यह प्रोजेक्ट, आपके ऐप्लिकेशन की पुष्टि करने के लिए ज़रूरी क्रेडेंशियल उपलब्ध कराता है. जैसे, OAuth 2.0 क्लाइंट आईडी.
शेयर किए गए Google क्लाउड प्रोजेक्ट को रजिस्टर न कर पाने की वजह
Google OAuth Playground और APIs Explorer जैसे टूल, Google के मालिकाना हक वाले शेयर किए गए Google Cloud प्रोजेक्ट का इस्तेमाल करते हैं. शेयर किए गए प्रोजेक्ट के साथ रजिस्टर नहीं किया जा सकता, क्योंकि:
- इनका इस्तेमाल, टेस्टिंग और एक्सप्लोरेशन के लिए किया जाता है, न कि प्रोडक्शन ऐप्लिकेशन की पहचान के लिए.
- इन्हें रजिस्टर करने का मतलब है कि शेयर किए गए टूल और आपके Merchant Center डेटा के बीच एक लिंक बन जाएगा. इससे आपको अनचाहे ईमेल मिल सकते हैं.
आपके ऐप्लिकेशन के लिए, एक अलग Google Cloud प्रोजेक्ट होना चाहिए. इससे Google, Merchant API के बारे में आपको जो भी जानकारी भेजेगा वह आपके असल इस्तेमाल के हिसाब से काम की होगी.
हालांकि, Merchant API का इस्तेमाल करके एक्सपेरिमेंट करने और प्रोडक्शन से जुड़े मामलों के अलावा अन्य मामलों में, OAuth Playground और API Explorer वेब ऐप्लिकेशन का इस्तेमाल किया जा सकता है.
अपना Google Cloud प्रोजेक्ट आईडी ढूंढना
Google Cloud Console में, अपना प्रोजेक्ट आईडी और प्रोजेक्ट नंबर देखा जा सकता है. ज़्यादा जानकारी के लिए, प्रोजेक्ट का नाम, नंबर, और आईडी ढूंढना लेख पढ़ें.
रजिस्ट्रेशन के लिए कॉल करना
Accounts सब-एपीआई में, registerGcp तरीके का इस्तेमाल करके रजिस्टर करें. इस कॉल से, आपके Google Cloud प्रोजेक्ट नंबर को Merchant Center खाते से जोड़ा जाता है.
इस प्रोसेस के दौरान, आपको एपीआई को कॉल करने के लिए इस्तेमाल किए जाने वाले किसी उपयोगकर्ता का ईमेल पता देना होगा. यह ईमेल पता, Merchant Center खाते के एडमिन ऐक्सेस वाले उपयोगकर्ता का होना चाहिए.
ईमेल फ़ील्ड के बारे में जानकारी
असरदार तरीके से बातचीत करना सबसे अहम है. Google, Merchant API से जुड़े अहम अपडेट, सेवा में हुए अहम बदलावों के बारे में ज़रूरी एलान (एमएसए), डेवलपर सर्वे, और अन्य अवसरों के बारे में जानकारी भेजता है. संपर्कों को सही तरीके से मैनेज करने पर, यह पक्का होता है कि ये सही लोगों तक पहुंचें.
- मकसद: Google इस ईमेल पते का इस्तेमाल, एपीआई से जुड़ी बातचीत के लिए प्राइमरी कॉन्टैक्ट के तौर पर करता है.
- किसका ईमेल पता: यह किसी डेवलपर या एपीआई इंटिग्रेशन के लिए ज़िम्मेदार मुख्य तकनीकी संपर्क का ईमेल पता होना चाहिए.
- सबसे सही तरीके:
- क्या करें: किसी व्यक्ति के कॉर्पोरेट ईमेल पते का इस्तेमाल करें.
- यह काम न करें: सामान्य ग्रुप के उपनामों या सेवा खाते के ईमेल पतों का इस्तेमाल न करें. हमारा मकसद, इंसानों को ईमेल भेजना है.
संपर्क मैनेज करने के लिए users संसाधन
रजिस्ट्रेशन कॉल में दिया गया ईमेल पता, शुरुआती संपर्क के तौर पर सेट होता है. हालांकि, संपर्कों और अनुमतियों को मैनेज करने का सबसे बेहतर तरीका, Merchant API accounts.users रिसॉर्स या Merchant Center के यूज़र इंटरफ़ेस (यूआई) में उपयोगकर्ता मैनेजमेंट की सेटिंग का इस्तेमाल करना है. Merchant Center का इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, अपने खाते में लोगों को मैनेज करना लेख पढ़ें.
इन सुविधाओं का फ़ायदा इस तरह लें:
- सभी डेवलपर जोड़ें: एपीआई इंटिग्रेशन पर काम करने वाले डेवलपर को Merchant Center खाते के उपयोगकर्ताओं के तौर पर जोड़ें.
API_DEVELOPERकी भूमिका असाइन करना: उपयोगकर्ताओं को स्टैंडर्ड भूमिकाओं (एडमिन, स्टैंडर्ड) के अलावा,API_DEVELOPERकी भूमिका भी असाइन की जा सकती है. खास तौर पर, यह भूमिका उन उपयोगकर्ताओं को असाइन करें जिन्हें एपीआई से जुड़ी ज़रूरी जानकारी मिलनी चाहिए. इसे अन्य भूमिकाओं के साथ जोड़ा जा सकता है.- फ़ायदे:
- अलग-अलग सेक्शन: एपीआई संपर्क मैनेजमेंट को एक बार होने वाले रजिस्ट्रेशन से अलग करता है.
- सुविधा: टीम के सदस्यों में बदलाव होने पर, संपर्कों को अपडेट करें.
- टारगेट करके जानकारी देना: इससे यह पक्का होता है कि एपीआई से जुड़ी खबरें, सही लोगों तक पहुंचें.
भले ही आपने रजिस्ट्रेशन के दौरान कोई ईमेल पता दिया हो, लेकिन हमारा सुझाव है कि आप API_DEVELOPER की भूमिका वाले उपयोगकर्ताओं को जोड़कर, एपीआई संपर्कों को मैनेज करें.
रेफ़रंस
ज़्यादा जानकारी के लिए, ये लेख पढ़ें: