सूचना के टाइप
मैसेज जोड़ना और सूचनाएं पाना
बैकग्राउंड
जब कोई उपयोगकर्ता पास जोड़ता है, तो हो सकता है कि आप उसे पास से जुड़ा मैसेज भेजना चाहें. इससे यह पक्का किया जा सकता है कि उसे पास के बारे में सूचना मिल जाए. TEXT_AND_NOTIFY के बराबर message_type वाले Add Message API अनुरोध का इस्तेमाल करने से, ये चीज़ें होती हैं:
- "मैसेज" आइटम को "पास के पीछे" (यानी ब्यौरा टेंप्लेट) में जोड़ा जाता है और सेव किए गए पास के साथ उपयोगकर्ताओं को पुश नोटिफ़िकेशन भेजा जाता है.
- जब उपयोगकर्ता इस सूचना पर टैप करता है, तो Google Wallet, पास के सामने (जिसे कार्ड व्यू भी कहा जाता है) खुल जाता है. साथ ही, उपयोगकर्ता को स्क्रीन पर सबसे ऊपर एक कॉलआउट दिखेगा, जिसमें "मैसेज देखें" बटन होगा.
- कॉलआउट पर क्लिक करने से, उपयोगकर्ता पास के पिछले पेज पर पहुंच जाएंगे. यहां नए और बिना पढ़े मैसेज हाइलाइट किए गए होते हैं.
उपयोगकर्ताओं को सूचनाओं के साथ मैसेज भेजते समय ध्यान रखने वाली कुछ बातें
- मैसेज से जुड़ी पुश सूचनाएं पाने के लिए, उपयोगकर्ताओं को अपने पास के लिए सूचनाएं चालू करनी होंगी.
- मैसेज में आपकी वेबसाइट या ऐप्लिकेशन के यूआरआई शामिल हो सकते हैं. हाइपरलिंक, पास से जुड़ी वेबसाइट या ऐप्लिकेशन के होने चाहिए. लोगों को पास से जुड़े लिंक के बजाय, दूसरे लिंक पर भेजना, स्वीकार किए जाने वाले इस्तेमाल की नीति का उल्लंघन है.
- 24 घंटे में, ज़्यादा से ज़्यादा तीन ऐसे मैसेज भेजे जा सकते हैं जिनसे पुश नोटिफ़िकेशन ट्रिगर होता है. अगर आपको लगता है कि आप अपने उपयोगकर्ताओं को स्पैम भेज रहे हैं, तो Google आपके पुश नोटिफ़िकेशन डिलीवरी कोटा को कम कर सकता है.
- उपयोगकर्ताओं को लॉक स्क्रीन पर दिखने वाली पुश सूचना को Google Wallet कंट्रोल करता है.
- सामान्य क्लास या ऑब्जेक्ट एंडपॉइंट का इस्तेमाल करके, मैसेज डेटा में बदलाव करने या उसे हटाने के लिए, UPDATE या PATCH तरीकों का इस्तेमाल किया जा सकता है.
इंटिग्रेशन का तरीका
अगर आपको AddMessage API का इस्तेमाल करके, जारीकर्ता के जोड़े गए नए मैसेज के बारे में उपयोगकर्ताओं को सूचना देनी है, तो आपको AddMessageRequest को अपडेट करना होगा. इससे, आपके नए टेक्स्ट वाले मैसेज में MessageType के तौर पर TEXT के बजाय 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" का इस्तेमाल करके सेट किया जा सकता है. जैसा कि इंटिग्रेशन के चरणों में बताया गया है.