मुख्य सिद्धांत और शब्दावली

इस दस्तावेज़ में वे सामान्य शब्दावली और सिद्धांत दिए गए हैं जिनके बारे में आपको Google Wallet API का इस्तेमाल करते समय पता होना चाहिए.

पास

पास करें

पास, पास ऑब्जेक्ट का एक इंस्टेंस है, जिसे उपयोगकर्ता को अपने Google Wallet में सेव करने के लिए जारी किया जाता है. Google Wallet API से, कई तरह के पास की सुविधा मिलती है. इनमें बोर्डिंग पास, इवेंट के टिकट, आईडी कार्ड वगैरह शामिल हैं. Google Wallet API एक जेनरिक पास टाइप भी उपलब्ध कराता है. इसका इस्तेमाल ऐसे पास बनाने के लिए किया जा सकता है जो किसी दूसरे तरीके से काम नहीं करते.

ज़्यादातर मामलों में, पास क्लास और पास ऑब्जेक्ट, दोनों का इस्तेमाल करके पास बनाया जाता है.

पास जारी करने वाला

पास जारी करने वाली इकाई ऐसी इकाई है जो पास बनाती है और उन्हें Google Wallet में सेव करने के लिए, उपयोगकर्ताओं को जारी करती है. पास जारी करने वाले के पास पास होते हैं. वे पास बना सकते हैं, उन्हें जारी कर सकते हैं, और उन्हें अपडेट कर सकते हैं. पास जारी करने वाले व्यक्ति, व्यक्तिगत डेवलपर, कंपनियां, और संगठन हो सकते हैं. साथ ही, वे एग्रीगेटर भी हो सकते हैं जो दूसरों के लिए पास बनाते और जारी करते हैं. उदाहरण के लिए, एक ऐसी कंपनी जो खुदरा दुकानदारों के इवेंट या कूपन लागू करने में माहिर होती है.

ज़्यादा जानें

पास की कैटगरी

पास क्लास को शेयर किया गया ऐसा टेंप्लेट माना जा सकता है जिसका इस्तेमाल करके पास बनाए जाते हैं. पास क्लास से कुछ प्रॉपर्टी के बारे में पता चलता है. इन्हें इस्तेमाल करने वाले सभी पास में शामिल किया जाएगा. पास जारी करने वाला व्यक्ति, कई क्लास बना सकता है. हर क्लास में प्रॉपर्टी का ऐसा खास सेट होता है जो स्टाइल और लुक जैसे एट्रिब्यूट के बारे में बताता है. साथ ही, इसमें स्मार्ट टैप, रजिस्ट्रेशन, और साइन इन जैसी अतिरिक्त सुविधाएं भी मिलती हैं.

ज़्यादातर मामलों में, पास का टेंप्लेट तय करने के लिए पास क्लास दी जाती है. साथ ही, जारी किए जा रहे पास की खास जानकारी देने के लिए पास ऑब्जेक्ट बनाया जाता है.

ज़्यादा जानें

पास ऑब्जेक्ट

पास ऑब्जेक्ट, उस पास के बारे में जानकारी देता है जिसे उपयोगकर्ता को Google Wallet में सेव करने के लिए जारी किया जाता है. पास ऑब्जेक्ट में अक्सर उपयोगकर्ता की खास जानकारी होती है. उदाहरण के लिए, पास की कैटगरी यह बता सकती है कि किसी दुकान के लिए उपहार कार्ड का पास कैसा दिखेगा. वहीं, पास ऑब्जेक्ट, बैलेंस या उसकी समयसीमा खत्म होने की तारीख जैसी खास जानकारी देता है.

पास को जारी किए जाने वाले हर पास के लिए, पास ऑब्जेक्ट बनाया जाना चाहिए. यह उन पास क्लास से अलग होता है जिन्हें कई पास के लिए शेयर किया जा सकता है.

ज़्यादा जानें

निजी पास

Google Wallet API की मदद से बनाए गए कुछ पास में, उपयोगकर्ता का संवेदनशील डेटा हो सकता है. इन पास के लिए, ज़्यादा सुरक्षा की ज़रूरत होती है. इससे आपके उपयोगकर्ताओं का डेटा सुरक्षित रहता है. साथ ही, Google Wallet API में सामान्य निजी पास टाइप का इस्तेमाल करके, इन्हें अलग-अलग तरीके से मैनेज किया जाता है. जेनरिक निजी पास का इस्तेमाल ऐसे मामलों में किया जाना चाहिए जहां आपके पास में संवेदनशील जानकारी (जैसा कि Google Wallet API के उचित इस्तेमाल की नीति में बताया गया है) शामिल है. साथ ही, ऑनबोर्डिंग के दौरान, उस पर अतिरिक्त निजता सेटिंग और समीक्षा लागू हो सकती है.

ज़्यादा जानें

स्मार्ट टैप

स्मार्ट टैप, Google के मालिकाना हक वाला नियर-फ़ील्ड कम्यूनिकेशन प्रोटोकॉल है. यह मोबाइल डिवाइस और एनएफ़सी टर्मिनल के बीच डेटा उपलब्ध कराता है. स्मार्ट टैप टेक्नोलॉजी की मदद से उपयोगकर्ता, Google Wallet में सेव किए गए पास को रिडीम कर सकते हैं. इसके लिए, उन्हें अपना फ़ोन, इस सुविधा के साथ काम करने वाले एनएफ़सी टर्मिनल के पास रखना होगा.

अपने पास के साथ स्मार्ट टैप प्रोटोकॉल का इस्तेमाल करने के लिए, आपको स्मार्ट टैप की सुविधा वाले टर्मिनल प्रोवाइडर से जुड़ना होगा.

ज़्यादा जानें

एपीआई और SDK टूल

Google Wallet एपीआई

Google Wallet API, Google की सेवा है. इसकी मदद से, लोगों को Google Wallet में पास बनाने और उन्हें जारी करने की सुविधा मिलती है, ताकि इनकी जानकारी अपने Google Wallet में सेव की जा सके. इस एपीआई का इस्तेमाल कई अलग-अलग तरीकों से किया जा सकता है, जिनमें Google Wallet REST API, Google Wallet Android SDK, और Google Wallet कंसोल शामिल हैं.

Google Wallet REST API

Google Wallet का REST API, Google Wallet API को एचटीटीपी अनुरोध भेजकर, प्रोग्राम के हिसाब से पास बनाने और उन्हें मैनेज करने का इंटरफ़ेस है.

Google Wallet REST API का इस्तेमाल करने के लिए, सेवा खाता बनाने के लिए आपको Google क्लाउड खाते की भी ज़रूरत होगी. इसका इस्तेमाल Google Wallet REST API के अनुरोधों की पुष्टि करने के लिए किया जाएगा.

Google Wallet का Android SDK

Google Wallet का Android SDK टूल, आपके Android ऐप्लिकेशन में Google Wallet API के साथ काम करने के आसान तरीके उपलब्ध कराता है. जैसे, पास बनाना और जारी करना.

Google Wallet में जोड़ें

'Google Wallet में जोड़ें' बटन

'Google Wallet में जोड़ें' बटन ऐसी ऐसेट होती है जिसे Google की मंज़ूरी मिली होती है. इससे उपयोगकर्ता को पास की जानकारी दी जा सकती है. जब कोई उपयोगकर्ता बटन पर क्लिक या टैप करता है, तो 'Google Wallet में जोड़ें' लिंक ट्रिगर होना चाहिए, ताकि जारी किए गए पास को उपयोगकर्ता के Google Wallet में जोड़ने की प्रोसेस शुरू हो सके.

यह सुझाव दिया जाता है कि आप जब भी संभव हो, 'Google वॉलेट में जोड़ें' बटन का इस्तेमाल करें, क्योंकि यह एक जाना-पहचाना यूज़र इंटरफ़ेस (यूआई) एलिमेंट है, जिससे आपके उपयोगकर्ता पहले से ही जानते हैं कि कैसे इंटरैक्ट करना है.

बटन का इस्तेमाल करने से जुड़ी एसेट और दिशा-निर्देश, Google Wallet API के ब्रैंड से जुड़े दिशा-निर्देशों में उपलब्ध हैं.

'Google Wallet में जोड़ें' लिंक की मदद से, किसी उपयोगकर्ता को सामान्य हाइपरलिंक के साथ पास जारी किया जा सकता है. इसका इस्तेमाल ईमेल, एसएमएस, वेबसाइटों, और मोबाइल ऐप्लिकेशन जैसी किसी भी जगह पर किया जा सकता है जहां हाइपरलिंक का इस्तेमाल किया जा सकता है.

'Google Wallet में जोड़ें' लिंक, यूआरएल https://pay.google.com/gp/v/save/ में साइन किया गया JWT जोड़कर बनाए जाते हैं.

जारी करने वाले का खाता

डेमो मोड

जारी करने वाला खाता बनाते समय, वह 'डेमो मोड' में रहेगा. ऐसा तब तक होगा, जब तक आपको पब्लिश करने के ऐक्सेस की अनुमति नहीं मिल जाती. डेमो मोड में पास बनाए जा सकते हैं. हालांकि, उन्हें सिर्फ़ उन उपयोगकर्ताओं को जारी किया जा सकता है जिनके पास आपके पास जारी करने वाले खाते के 'एडमिन' या 'डेवलपर' की भूमिका है. इसके अलावा, ऐसे उपयोगकर्ताओं को भी पास जारी किया जा सकता है जिन्हें Google Wallet कंसोल में टेस्ट खातों के तौर पर जोड़ा गया है.

'डेमो मोड' में होने पर, आपकी जारी की गई किसी भी पास का टाइटल '[सिर्फ़ टेस्ट के लिए]' शब्दों से अपने-आप शुरू हो जाएगा. इससे यह पता चलेगा कि पास को सिर्फ़ टेस्ट करने के लिए बनाया गया है.

टेस्ट खाते

जारी करने वाला खाता 'डेमो मोड' में होने पर, अगर आपको किसी ऐसे उपयोगकर्ता को पास जारी करना है जिसके पास आपके खाते के लिए 'एडमिन' या 'डेवलपर' की भूमिका नहीं है, तो आपको उन्हें Google Wallet कंसोल में टेस्ट खातों के तौर पर जोड़ना होगा. टेस्ट खातों के तौर पर रजिस्टर किए गए उपयोगकर्ता, आपके जारी किए गए पास की जानकारी अपने Google Wallet में जोड़ पाएंगे. 'डेमो मोड' में, ज़्यादा दर्शकों के साथ अपने पास की जांच करने के लिए इससे मदद मिलती है.

कारोबार की प्रोफ़ाइल

Google Wallet API को जारी करने वाला खाता बनाने के लिए, आपको Google Pay और Wallet Console में रजिस्टर करते समय कारोबारी प्रोफ़ाइल सेट अप करनी होगी. कारोबारी प्रोफ़ाइल की मदद से, Google को आपकी कंपनी या संगठन के बारे में बुनियादी जानकारी मिलती है. पब्लिश करने के ऐक्सेस के लिए इसका मंज़ूरी लेना ज़रूरी है.

ज़्यादा जानें

पब्लिश करने का ऐक्सेस

कोई भी व्यक्ति अपने Google Wallet में पास सेव कर सकता है. इससे पहले आपको उसे पब्लिश करने की अनुमति लेनी होगी. पब्लिश करने के ऐक्सेस की मंज़ूरी पाने के लिए, यह ज़रूरी है कि आपने कम से कम एक पास की क्लास बनाई हो और आपके पास पूरी कारोबारी प्रोफ़ाइल हो. ऐसे जारी करने वाले जो Google Wallet के Android SDK टूल का इस्तेमाल करके, पास जारी करना चाहते हैं उन्हें अपने ऐप्लिकेशन के लिए SHA-1 फ़िंगरप्रिंट भी सबमिट करना होगा.

पब्लिश करने के ऐक्सेस का अनुरोध करने के लिए, Google Wallet कंसोल पर जाएं और 'पब्लिश करने के ऐक्सेस का अनुरोध करें' बटन पर क्लिक करें. Google Wallet टीम आपके अनुरोध की समीक्षा करेगी और पब्लिश करने का ऐक्सेस मिलने पर आपको सूचना देगी.

ज़्यादा जानें

पुष्टि करना

JSON वेब टोकन (JWT)

JSON वेब टोकन, आम तौर पर इस्तेमाल किए जाने वाले इंडस्ट्री स्टैंडर्ड हैं. इनकी मदद से, जानकारी को JSON ऑब्जेक्ट के तौर पर सुरक्षित तरीके से ट्रांसफ़र किया जा सकता है. Google Wallet API का इस्तेमाल करते समय, आपको उस पास ऑब्जेक्ट की जानकारी को कोड में बदलना होता है जिसका इस्तेमाल आपको JWT (इसे "जोट") फ़ॉर्मैट में पास इंस्टेंस बनाने के लिए करना है. इसके बाद, उस JWT को Google Wallet API को अनुरोध करके भेजें.

JWT को Google Wallet API पर भेजे जाने से पहले, एक शेयर किए गए सीक्रेट के साथ साइन करके सुरक्षित रखा जाता है. अगर Google Wallet REST API का इस्तेमाल किया जा रहा है, तो साइन करने का सीक्रेट, आपकी Google Cloud सेवा खाता कुंजी है. अगर Google Wallet के Android SDK टूल का इस्तेमाल किया जा रहा है, तो आपके Android ऐप्लिकेशन के लिए SHA-1 फ़िंगरप्रिंट, साइनिंग सीक्रेट होता है.

सेवा खाता

Google Cloud सेवा खाता एक खास तरह का खाता होता है. आम तौर पर, इसका इस्तेमाल किसी व्यक्ति के बजाय, ऐप्लिकेशन या कंप्यूट वर्कलोड के लिए किया जाता है. Google Wallet API के मामले में, सेवा खाता वह खाता है जिसका इस्तेमाल, Google Wallet REST API को भेजे गए अनुरोधों की पुष्टि करने के लिए किया जाएगा.

सेवा खाते, Google Cloud Console में बनाए जाते हैं. किसी सेवा खाते का इस्तेमाल करने के लिए, आपको Cloud Console में Google Wallet API को चालू करना होगा, ताकि सेवा खाते को Google Wallet REST API को अनुरोध करने की अनुमति दी जा सके.

ज़्यादा जानें

सुविधा के खाते की कुंजी

सेवा खाता कुंजी ऐसा क्रेडेंशियल है जिसका इस्तेमाल Google Wallet REST API पर कॉल की पुष्टि करने के लिए किया जाएगा. सेवा खाता कुंजी को बेहद संवेदनशील माना जाता है और इसे निजी रखा जाना चाहिए, क्योंकि इससे Google Wallet REST API का इस्तेमाल करके, आपके खाते की पास जारी करने वाली कई सुविधाओं को ऐक्सेस मिलता है, जिसमें पास क्लास और पास ऑब्जेक्ट बनाना भी शामिल है.

ज़्यादा जानें

SHA-1 फ़िंगरप्रिंट

आपके Android ऐप्लिकेशन साइनिंग सर्टिफ़िकेट का SHA-1 फ़िंगरप्रिंट ऐसा क्रेडेंशियल है जिसका इस्तेमाल, Google Wallet Android SDK का इस्तेमाल करते समय, Google Wallet API पर कॉल की पुष्टि करने के लिए किया जाएगा. आपके सर्टिफ़िकेट का SHA-1 फ़िंगरप्रिंट, Gradle या कीटूल का इस्तेमाल करके जनरेट किया जाता है. अपने अनुरोधों की पुष्टि करने के लिए फ़िंगरप्रिंट का इस्तेमाल करने के लिए, आपको इसे Google Wallet कंसोल में रजिस्टर करना होगा.

ज़्यादा जानें