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 भूमिका वाले उपयोगकर्ताओं को जोड़ें.
रेफ़रंस
ज़्यादा जानकारी के लिए, यह लेख पढ़ें: