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 प्रोजेक्ट की ज़रूरत होती है. इससे 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 इस ईमेल पते का इस्तेमाल, एपीआई से जुड़े कम्यूनिकेशन के लिए प्राइमरी संपर्क के तौर पर करता है.
- किसका ईमेल पता: यह किसी डेवलपर या एपीआई इंटिग्रेशन के लिए ज़िम्मेदार मुख्य तकनीकी संपर्क का ईमेल पता होना चाहिए.
- सबसे सही तरीके:
- DO: किसी व्यक्ति के कॉर्पोरेट ईमेल पते का इस्तेमाल करें.
- इनका इस्तेमाल न करें: सामान्य ग्रुप के उपनाम या सेवा खाते के ईमेल पते. हमारा मकसद, लोगों को जानकारी देना है.
संपर्क मैनेज करने के लिए users संसाधन
रजिस्ट्रेशन कॉल में मौजूद ईमेल पते से शुरुआती संपर्क सेट किया जाता है. हालांकि, संपर्कों और अनुमतियों को मैनेज करने का बेहतर तरीका यह है कि Merchant API accounts.users संसाधन या Merchant Center UI में उपयोगकर्ता मैनेजमेंट की सेटिंग का इस्तेमाल किया जाए. Merchant Center का इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, अपने खाते का ऐक्सेस रखने वाले लोगों को मैनेज करना लेख पढ़ें.
इन सुविधाओं का इस तरह फ़ायदा लें:
- सभी डेवलपर जोड़ें: एपीआई इंटिग्रेशन पर काम करने वाले डेवलपर को Merchant Center खाते के उपयोगकर्ताओं के तौर पर जोड़ें.
API_DEVELOPERकी भूमिका असाइन करना: स्टैंडर्ड भूमिकाओं (एडमिन, स्टैंडर्ड) के अलावा, उपयोगकर्ताओं कोAPI_DEVELOPERकी भूमिका असाइन की जा सकती है. खास तौर पर, यह भूमिका उन उपयोगकर्ताओं को असाइन करें जिन्हें एपीआई से जुड़ी सूचनाएं मिलनी चाहिए. इसे अन्य भूमिकाओं के साथ जोड़ा जा सकता है.- फ़ायदे:
- अलग-अलग सुविधाएं: इससे एपीआई के ज़रिए संपर्क मैनेज करने की सुविधा, एक बार किए जाने वाले रजिस्ट्रेशन से अलग हो जाती है.
- सुविधा: टीम के सदस्यों के बदलने पर, संपर्कों की जानकारी अपडेट करें.
- टारगेट करके बातचीत करना: इससे यह पक्का होता है कि एपीआई से जुड़ी खबरें, काम के लोगों तक पहुंचें.
रजिस्ट्रेशन के दौरान ईमेल पता देने के बावजूद, हमारा सुझाव है कि आप API_DEVELOPER भूमिका वाले उपयोगकर्ताओं को जोड़कर, एपीआई से जुड़े संपर्कों को मैनेज करें.
रेफ़रंस
ज़्यादा जानकारी के लिए, यह लेख पढ़ें: