उपहार कार्ड के लिए रजिस्टर करने (साइन इन करने) की सुविधा की मदद से, उपयोगकर्ता किसी उपहार कार्ड को खोज सकते हैं और उसे Google Wallet में जोड़ सकते हैं. प्रोसेस पूरी करने के लिए, उपयोगकर्ताओं को आपकी मोबाइल-फ़्रेंडली वेबसाइट पर रीडायरेक्ट किया जाएगा. इसके बाद, वे Google Wallet में अपना कार्ड जोड़ सकते हैं.
इस गाइड में, इस सुविधा के लिए उपहार कार्ड प्रोग्राम को चालू करने के लिए, ज़रूरी चरणों के बारे में खास जानकारी दी गई है.
खास जानकारी
शुरू करने से पहले, पक्का करें कि आपने पहले ही अपना प्रोजेक्ट सेट अप कर लिया हो और आपके पास Google Wallet API का ऐक्सेस हो.
अपने उपहार कार्ड प्रोग्राम के लिए, साइन इन करने की सुविधा लागू करने के लिए, आपको ये चार चरण पूरे करने होंगे:
- साइन इन फ़्लो की जांच करने के लिए, Google Wallet में टेस्ट क्लास सेट अप करें.
- Google Wallet
SharedDataTypeका इस्तेमाल करने वाले साइन इन पेज बनाएं. - साइन इन करने के बाद, Google Wallet में उपहार कार्ड की जानकारी को पुश बैक करें.
- पुष्टि और चालू करने का अनुरोध करें.
Google Wallet में टेस्ट क्लास सेट अप करना
साइन इन करने के लिए यूआरएल और अपने कार्यक्रम का लोगो तय करें. इसके बाद, सही वैल्यू सेट करने के लिए, giftcardclass में discoverableProgram नेस्ट किए गए फ़ील्ड का इस्तेमाल करें.
साइन इन की सुविधा वाले उपहार कार्ड प्रोग्राम का ड्राफ़्ट वर्शन बनाने के लिए, discoverableProgram में वैल्यू सेट करें. यह पक्का करने के लिए कि यह टेस्टर को दिखे, पुष्टि करें कि
टेस्टर के पास आपके Google Pay और Wallet Console का ऐक्सेस हो. अपने Google Pay और Wallet Console का ऐक्सेस, दूसरे लोगों के साथ शेयर करने का तरीका जानने के लिए, उपयोगकर्ता पेज के बारे में जानें लेख पढ़ें.
डेवलपमेंट प्रोसेस के दौरान, लागू किए गए फ़ंक्शन की पुष्टि करने के लिए, Google Pay और Wallet Console में सहायता टीम से संपर्क करने वाले विजेट का इस्तेमाल करके हमसे संपर्क करें. कंसोल में, विषय में Google Wallet API चुनें और उपविषय में उपहार कार्ड से साइन इन करना चुनें.
Google Wallet के उपयोगकर्ता के डेटा का इस्तेमाल करने वाला साइन इन पेज बनाना
जब कोई उपयोगकर्ता आपका उपहार कार्ड जोड़ने का विकल्प चुनता है, तो उसे साइन इन करने की प्रोसेस पूरी करने के लिए, आपकी वेबसाइट पर बनाए गए पेज पर भेजा जाता है.
आपको साइन-इन करने के लिए एक यूआरएल देना होगा, जहां उपयोगकर्ता किसी मौजूदा खाते में साइन इन कर सके.
आपका साइन इन पेज इन शर्तों के मुताबिक होना चाहिए:
- मोबाइल पर अच्छा उपयोगकर्ता अनुभव दें.
- उपयोगकर्ता को एक ही पेज पर साइन इन करने की अनुमति दें.
- उपयोगकर्ता का डेटा सुरक्षित तरीके से ट्रांसफ़र किया जाए, यह पक्का करने के लिए किसी मान्य सर्टिफ़िकेट के साथ
HTTPSएन्क्रिप्शन का इस्तेमाल करें. - पक्का करें कि आपके साइन-इन पेज का अपटाइम कम से कम 99.9% हो.
साइन इन पेज दिखाते समय, Google Wallet एक Android वेबव्यू बनाएगा और आपके दिए गए यूआरएल पर POST अनुरोध किया जाएगा. उपयोगकर्ता का डेटा, SharedDataType पैरामीटर में दिया जाता है. इसे POST अनुरोध में शामिल किया जाता है. इसके लिए,
application/x-www-form-urlencoded कॉन्टेंट टाइप और
UTF-8 कोडिंग का इस्तेमाल किया जाता है. SharedDataType
पैरामीटर की वैल्यू, Base64 कोड में बदला गया JSON ऑब्जेक्ट होता है.
Google Wallet में उपहार कार्ड की जानकारी तुरंत भेजने की सुविधा लागू करना
पुष्टि (साइन इन) हो जाने के बाद, आपका पेज उपयोगकर्ता के उपहार कार्ड को तुरंत Google Wallet में वापस भेज देगा.
उपहार कार्ड को Google Wallet में वापस भेजने के लिए, उस लिंक पर रीडायरेक्ट करें जो इस स्ट्रक्चर का पालन करता हो
https://pay.google.com/gp/v/save/{jwt_generated}
यूआरएल में ज़्यादा से ज़्यादा 2,000 वर्ण होने चाहिए. आपके लिंक, इस सीमा के अंदर होने चाहिए. JWT में एन्क्रिप्ट (सुरक्षित) किए गए ऑब्जेक्ट छोटे होने चाहिए. इनमें सिर्फ़ उपयोगकर्ता से जुड़ा डेटा होना चाहिए. ज़्यादातर डेटा को ऑब्जेक्ट की क्लास में रखने की कोशिश करें. इसके लिए, JWT बनाने से पहले उसे बनाएं. बड़े ऑब्जेक्ट के लिए, पहले Google Wallet API में ऑब्जेक्ट बनाएं और JWT में सिर्फ़ ऑब्जेक्ट आईडी भेजें.
कम्यूनिकेशन का सामान्य फ़्लो
साइन इन करने वाले उपयोगकर्ता के लिए, कम्यूनिकेशन फ़्लो की जानकारी नीचे दी गई इमेज में दी गई है. "आपके सर्वर" के बीच की सभी कार्रवाइयों को लागू करने की ज़िम्मेदारी आपकी है.
पुष्टि और चालू करने का अनुरोध करना
डेवलपमेंट का काम पूरा करने और साइन-इन फ़्लो की जांच करने के बाद, Google Pay और Wallet Console के सहायता विजेट की मदद से अनुरोध सबमिट करें.
आपके उपहार कार्ड प्रोग्राम में इस सुविधा को लागू करने के बाद, इसकी पूरी समीक्षा की जाएगी. इसमें यह पक्का किया जाएगा कि Google Wallet ऐप्लिकेशन के साथ यह सुविधा सही तरीके से काम कर रही है या नहीं. समीक्षा पूरी होने के बाद, उपहार कार्ड प्रोग्राम के लिए उपहार कार्ड में साइन इन करने की सुविधा को सार्वजनिक तौर पर लॉन्च किया जाएगा. इससे, कोई भी उपयोगकर्ता प्रोग्राम देख सकता है और इस सुविधा का इस्तेमाल कर सकता है.
उपयोगकर्ताओं को बेहतर अनुभव देने के लिए, साइन इन करने की सुविधा के लागू होने की जांच बार-बार की जाएगी. इससे यह पक्का किया जा सकेगा कि इस सुविधा की ज़रूरी शर्तों का लगातार पालन किया जा रहा है. अंतर होने पर, आपको इसकी सूचना दी जाएगी. साथ ही, समस्या हल होने तक साइन इन करने की सुविधा बंद की जा सकती है.
अक्सर पूछे जाने वाले सवाल
- क्या उपहार कार्ड प्रोग्राम में इस्तेमाल की जाने वाली इमेज के लिए कोई ज़रूरी शर्त है?
- हां, आपकी इमेज
HTTPSकी जगह पर होस्ट की जानी चाहिए क्योंकि ऐसा न करने पर, वे Google Wallet में नहीं दिखेंगी.
- हां, आपकी इमेज
- क्या ऐसे कोई टूल हैं जिनसे JWT लागू करने और डीबग करने की प्रोसेस आसान हो जाती है?
- हां, www.jwt.io जैसे प्लैटफ़ॉर्म की मदद से, डेवलपमेंट प्रोसेस के दौरान अपने टोकन को डिकोड और डीबग किया जा सकता है. इससे, सबमिट किए जा रहे कॉन्टेंट की पुष्टि की जा सकती है. ध्यान रखें कि Google का इनसे कोई संबंध नहीं है और वह इनमें से किसी भी तीसरे पक्ष का खास तौर पर सुझाव नहीं देता.
- हम Base64 कोड में बदले गए SharedDataType डेटा को सही तरीके से कैसे मैनेज करते हैं?
- पक्का करें कि प्रोसेस के दौरान, UTF-8 एन्कोडिंग का इस्तेमाल किया जा रहा हो. जेएसओएन स्ट्रिंग को सबसे पहले UTF-8 में कोड में बदला जाता है. इसके बाद, NO_WRAP और URL_SAFE विकल्पों के साथ android.util.Base64 का इस्तेमाल करके कोड में बदला जाता है. यह आरएफ़सी 3548 सेक्शन 4 के मुताबिक है.