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