Merchant API का बेहतर तरीके से इस्तेमाल करने के लिए, रजिस्ट्रेशन, पुष्टि करने की प्रोसेस,और अनुमति देने की प्रोसेस के कॉन्सेप्ट को समझना ज़रूरी है. ये प्रोसेस, Merchant Center के डेटा को सुरक्षित और सही तरीके से ऐक्सेस करने में अलग-अलग मकसद पूरा करती हैं.
शब्दावली
रजिस्ट्रेशन, पुष्टि करने की प्रोसेस, और अनुमति देने की प्रोसेस एक-दूसरे से जुड़ी हैं. हालांकि, हर प्रोसेस का मतलब और मकसद अलग-अलग होता है.
- पुष्टि करने की प्रोसेस: इस प्रोसेस में, सेवा यह पुष्टि करती है कि एपीआई का अनुरोध करने वाला उपयोगकर्ता या ऐप्लिकेशन, वही है जिसका दावा किया जा रहा है. Merchant API, Google के स्टैंडर्ड मैकेनिज़्म का इस्तेमाल करता है. जैसे, OAuth 2.0. ज़्यादा जानकारी के लिए, अनुरोधों की पुष्टि करना और अपने खाते के तौर पर पुष्टि करना लेख पढ़ें.
- अनुमति देने की प्रोसेस: इस प्रोसेस से यह तय किया जाता है कि पुष्टि किया गया उपयोगकर्ता या ऐप्लिकेशन, 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 Cloud प्रोजेक्ट को रजिस्टर क्यों नहीं किया जा सकता
Google OAuth Playground और APIs Explorer जैसे टूल, Google के मालिकाना हक वाले शेयर किए गए Google Cloud प्रोजेक्ट का इस्तेमाल करते हैं. शेयर किए गए प्रोजेक्ट के साथ रजिस्टर नहीं किया जा सकता, क्योंकि:
- इनका इस्तेमाल, टेस्ट करने और एक्सप्लोर करने के लिए किया जाता है. इनका इस्तेमाल, प्रोडक्शन ऐप्लिकेशन की पहचान के लिए नहीं किया जाता.
- इन्हें रजिस्टर करने का मतलब है कि शेयर किए गए टूल और आपके Merchant Center के खास डेटा के बीच लिंक है. इससे अवांछित कम्यूनिकेशन हो सकता है.
आपके ऐप्लिकेशन के लिए, Google Cloud का अपना प्रोजेक्ट होना चाहिए. इससे Merchant API से जुड़े वे कम्यूनिकेशन आपके लिए काम के रहेंगे जो Google आपको भेजता है.
इसके बावजूद, OAuth Playground और API Explorer वेब ऐप्लिकेशन का इस्तेमाल करके, Merchant API को एक्सपेरिमेंट और नॉन-प्रोडक्शन इस्तेमाल के मामलों के लिए इस्तेमाल किया जा सकता है.
अपना 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 की भूमिका वाले उपयोगकर्ताओं को जोड़कर, एपीआई के संपर्कों को मैनेज किया जाए.
रेफ़रंस
ज़्यादा जानकारी के लिए, ये लेख पढ़ें:
- क्विकस्टार्ट गाइड
DeveloperRegistrationके तरीके