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