पार्टनर की ओर से ट्रिगर की गई सूचनाएं
मैसेज जोड़ना और सूचनाएं पाना
बैकग्राउंड
जब कोई उपयोगकर्ता पास जोड़ता है, तो हो सकता है कि आप उसे पास से जुड़ा मैसेज भेजना चाहें. इससे यह पक्का किया जा सकता है कि उसे पास के बारे में सूचना मिल जाए. Add Message API के अनुरोध का इस्तेमाल करके, message_type को TEXT_AND_NOTIFY के बराबर करने पर, यह होता है:
- "पास के पीछे" (जिसे जानकारी टेंप्लेट भी कहा जाता है) में "मैसेज" आइटम जोड़ा जाता है. साथ ही, पास सेव करने वाले उपयोगकर्ताओं को एक पुश नोटिफ़िकेशन भेजा जाता है.
- जब उपयोगकर्ता इस सूचना पर टैप करता है, तो Google Wallet, पास के सामने (जिसे कार्ड व्यू भी कहा जाता है) खुल जाता है. साथ ही, उपयोगकर्ता को स्क्रीन पर सबसे ऊपर एक कॉलआउट दिखेगा, जिसमें "मैसेज देखें" बटन होगा.
- कॉलआउट पर क्लिक करने से, उपयोगकर्ता पास के पिछले पेज पर पहुंच जाएंगे. यहां नए और बिना पढ़े मैसेज हाइलाइट किए गए होते हैं.
उपयोगकर्ताओं को सूचनाओं के साथ मैसेज भेजते समय ध्यान रखने वाली कुछ बातें
- मैसेज से जुड़ी पुश सूचनाएं पाने के लिए, उपयोगकर्ताओं को अपने पास के लिए सूचनाएं चालू करनी होंगी.
- मैसेज में आपकी वेबसाइट या ऐप्लिकेशन के यूआरआई शामिल हो सकते हैं. हाइपरलिंक, पास से जुड़ी वेबसाइट या ऐप्लिकेशन के होने चाहिए. लोगों को पास से जुड़े लिंक के बजाय, दूसरे लिंक पर भेजना, स्वीकार किए जाने वाले इस्तेमाल की नीति का उल्लंघन है.
- 24 घंटे में, ज़्यादा से ज़्यादा तीन ऐसे मैसेज भेजे जा सकते हैं जिनसे पुश नोटिफ़िकेशन ट्रिगर होता है. अगर Google को लगता है कि आपके ऐप्लिकेशन से उपयोगकर्ताओं को स्पैम मैसेज भेजे जा रहे हैं, तो वह पुश नोटिफ़िकेशन डिलीवरी के कोटे को कम कर सकता है.
- उपयोगकर्ताओं को लॉक स्क्रीन पर दिखने वाली पुश सूचना को Google Wallet कंट्रोल करता है.
- सामान्य क्लास या ऑब्जेक्ट एंडपॉइंट का इस्तेमाल करके, मैसेज डेटा में बदलाव करने या उसे हटाने के लिए, UPDATE या PATCH तरीकों का इस्तेमाल किया जा सकता है.
इंटिग्रेशन का तरीका
अगर आपको AddMessage API का इस्तेमाल करके, जारीकर्ता के जोड़े गए नए मैसेज के बारे में उपयोगकर्ताओं को सूचना देनी है, तो आपको AddMessageRequest को अपडेट करना होगा. ऐसा इसलिए, ताकि आपके नए टेक्स्ट वाले मैसेज में MessageType के तौर पर TEXT_AND_NOTIFY के बजाय TEXT_AND_NOTIFY हो.
पास की क्लास में मैसेज जोड़ने और सूचना देने के लिए, JSON अनुरोध का उदाहरण
… "id": ISSUER_ID.CLASS_ID", "message": { "header":"My Class message header", "body": "My Class message body with a <a href="https://wallet.google">Hyperlink<\a>", "id": "message_id", "message_type": "TEXT_AND_NOTIFY" }, …
Passes ऑब्जेक्ट में मैसेज जोड़ने और सूचना देने के लिए JSON अनुरोध का उदाहरण
… "id": OBJECT_ID", "classId": "ISSUER_ID.CLASS_ID", "message": { "header":"My Object message header", "body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>", "id": "message_id", "message_type": "TEXT_AND_NOTIFY" }, …
पास क्लास के लिए मैसेज जोड़ने और सूचना देने के रिस्पॉन्स का उदाहरण
// The updated resource … { "kind": "walletobjects#walletObjectMessage", "header": "My Object message header", "body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>", "id": "message_id", "messageType": "textAndNotify" }, …
अपवाद मैनेज करना
तीन बार से ज़्यादा सूचना देने की कोशिश करने पर, आपको QuotaExceededException कोड वाला जवाब मिलेगा. पास में कोई और अपडेट करने के लिए, "TEXT_AND_NOTIFY" के बजाय "TEXT" का इस्तेमाल किया जा सकता है. इस बारे में इंटिग्रेशन के चरणों में बताया गया है.
फ़ील्ड अपडेट करना और सूचना देना
बैकग्राउंड
जब कोई उपयोगकर्ता पास जोड़ता है, तो हो सकता है कि आप कुछ फ़ील्ड अपडेट करने पर पुश नोटिफ़िकेशन ट्रिगर करना चाहें. यह सूचना, उपयोगकर्ता की लॉक स्क्रीन पर दिखेगी. इसमें उन्हें बताया जाएगा कि उनके पासपोर्ट में बदलाव हुआ है. यह सूचना, सिर्फ़ उन फ़ील्ड के किसी खास सबसेट के लिए ट्रिगर होगी जिन्हें यहां बताया गया है. इसके लिए, UPDATE और PATCH एपीआई के तरीकों का इस्तेमाल किया जाएगा. पास को अपडेट करने के लिए एपीआई कॉल करने के बाद, ये काम किए जाते हैं:
- पुश नोटिफ़िकेशन ट्रिगर हो जाता है और उपयोगकर्ता की लॉक स्क्रीन पर दिखता है. इससे उन्हें पास के अपडेट के बारे में जानकारी मिलती है.
- जब उपयोगकर्ता सूचना पर टैप करता है, तो Google Wallet, पास के सामने (जिसे कार्ड व्यू भी कहा जाता है) खुल जाता है. साथ ही, उपयोगकर्ता को स्क्रीन पर सबसे ऊपर एक कॉलआउट दिखेगा, जिसमें "अपडेट की समीक्षा करें" बटन होगा.
- बटन पर क्लिक करने से, उपयोगकर्ता को एक स्क्रीन दिखती है. इस स्क्रीन पर, अपडेट की वजह से बदले गए फ़ील्ड दिखते हैं.
फ़ील्ड अपडेट की सूचनाएं भेजते समय ध्यान रखने वाली कुछ बातें
- अपडेट से जुड़े पुश नोटिफ़िकेशन पाने के लिए, उपयोगकर्ताओं को अपने पास के लिए सूचनाएं चालू करनी होंगी.
- 24 घंटे में, पुश नोटिफ़िकेशन ट्रिगर करने वाले ज़्यादा से ज़्यादा तीन अपडेट भेजे जा सकते हैं. अगर Google को लगता है कि आपके ऐप्लिकेशन से उपयोगकर्ताओं को स्पैम भेजा जा रहा है, तो वह पुश नोटिफ़िकेशन डिलीवरी के कोटे को कम कर सकता है.
- उपयोगकर्ताओं को लॉक स्क्रीन पर दिखने वाली पुश सूचना को Google Wallet कंट्रोल करता है.
notifyPreferenceफ़ील्ड, ट्रांज़िशन फ़ील्ड है, जो सिर्फ़ इस अनुरोध के लिए मौजूद होता है. आने वाले समय में सूचना ट्रिगर करने के लिए, आपको क्लास या ऑब्जेक्ट के अनुरोध पर इस फ़ील्ड को रीसेट करना होगा.
इंटिग्रेशन का तरीका
इन सूचनाओं को ट्रिगर करने के लिए, आपको मौजूदा UPDATE या PATCH कॉल का इस्तेमाल करना होगा और notifyPreference की जानकारी देनी होगी. किसी क्लास या ऑब्जेक्ट पर फ़ील्ड अपडेट करते समय, सूचना को ट्रिगर करने के लिए, क्लास या ऑब्जेक्ट के अनुरोध में नया फ़ील्ड, notifyPreference जोड़ा जा सकता है.
क्लास में अपडेट करने और सूचना देने के लिए JSON अनुरोध का उदाहरण
…
"dateTime":
{
"kind": "walletobjects#eventDateTime",
"doorsOpen": "2024-09-23T19:20:50.00"
},
"multipleDevicesAndHoldersAllowedStatus": "multipleHolders",
"notifyPreference": "notifyOnUpdate",
…
notifyPreference को notifyOnUpdate पर सेट करने पर, एक सूचना ट्रिगर होगी. हालांकि, ऐसा तब ही होगा, जब अपडेट किया गया फ़ील्ड फ़िलहाल काम कर रहा हो.
इस्तेमाल किए जा सकने वाले फ़ील्ड
FlightObject
- boardingAndSeatingInfo.seatNumber
- boardingAndSeatingInfo.seatAssignment
Google Wallet से अपने-आप मिलने वाली सूचनाएं
आने वाली सूचना
Google Wallet, फ़्लाइट से तीन घंटे पहले उपयोगकर्ता को सूचना भेजता है. फ़्लाइट में लगने वाला समय,
class.localScheduledDepartureDateTime से तय होता है.
यह सूचना पाने के लिए, उपयोगकर्ता के पास सूचनाएं पाने की सुविधा चालू होनी चाहिए. यह देखने के लिए, वे सेटिंग > सूचनाएं पर जाकर देखें कि आपके पास के बारे में अपडेट चालू है या नहीं.
सूचना, सूचनाओं वाले सेक्शन में दिखती है. साथ ही, अगर उपयोगकर्ता ने लॉक स्क्रीन पर सूचनाएं पाने की सुविधा चालू की है, तो यह लॉक स्क्रीन पर भी दिखती है.
सूचना का फ़ॉर्मैट ऐसा होता है जिसमें बदलाव नहीं किया जा सकता:
Boarding pass for your flight to class.destination.airportIataCode
अगर वे सूचना पर टैप करके अपने डिवाइस को अनलॉक करते हैं, तो उनका पास Google Wallet ऐप्लिकेशन में दिखता है.
अगर उपयोगकर्ता के पास एक से ज़्यादा पास हैं, तो सिर्फ़ वह पास दिखता है जिसे जल्द से जल्द इस्तेमाल किया जा सकता है. अगर उन्होंने एक से ज़्यादा बोर्डिंग पास को ग्रुप में जोड़ें के मुताबिक, ग्रुप किए गए पास जोड़े हैं, तो सूचना में ग्रुप में से सिर्फ़ एक पास दिखता है. हालांकि, उस पर टैप करने पर, उपयोगकर्ता उस ग्रुप में मौजूद अन्य पास देखने के लिए, बाईं और दाईं ओर स्वाइप कर सकता है.
सूचना पिन हो जाती है और उपयोगकर्ता के इसे खोलने के बाद, यह अपने-आप खारिज नहीं होगी. class.localScheduledDepartureDateTime के 60
मिनट बाद, सूचना अपने-आप बंद हो जाती है.
फ़्लाइट के बारे में अपडेट की सूचना
जब फ़्लाइट के कुछ फ़ील्ड में बदलाव किए जाते हैं, तो जिन उपयोगकर्ताओं ने एक या उससे ज़्यादा बोर्डिंग पास जोड़े हैं उन्हें अपने डिवाइसों पर पुश नोटिफ़िकेशन मिलता है. ऐसा सिर्फ़ कुछ खास शर्तें पूरी होने पर होता है.
ऑरिजिन टर्मिनल और गेट
अगर class.origin.terminal या class.origin.gate में बदलाव किया जाता है और यहां दी गई शर्त पूरी होती है, तो फ़ील्ड में बदलाव होने की सूचना भेजी जाती है.
class.localScheduledDepartureDateTimeसे पहले, तीन घंटे से भी कम समय बचा है.
सूचना इस फ़ॉर्मैट में होती है: "Sample Airlines ने आपके गेट को A1 पर अपडेट किया है." फ़ॉर्मैट को बदला नहीं जा सकता.
बोर्डिंग का समय और फ़्लाइट के जाने का समय
अगर class.localBoardingDateTime
या class.localEstimatedOrActualDepartureDateTime में बदलाव किया जाता है और नीचे दी गई शर्तें पूरी होती हैं, तो फ़ील्ड में बदलाव होने की सूचना भेजी जाती है.
class.localScheduledDepartureDateTimeसे पहले, 24 घंटे से कम समय बचा है.- उस समय में कम से कम 10 मिनट या उससे ज़्यादा का बदलाव होता है.
सूचना इस फ़ॉर्मैट में होती है: "_Sample Airlines ने आपके बोर्डिंग के समय को बदलकर, शाम 6:00 बजे कर दिया है._" फ़ॉर्मैट या भाषा में अपने हिसाब से बदलाव नहीं किया जा सकता.