पार्टनर की ओर से ट्रिगर की गई सूचनाएं
मैसेज और सूचना जोड़ें
बैकग्राउंड
जब कोई उपयोगकर्ता पास जोड़ता है, तो आपको उसे पास से जुड़ा मैसेज भेजना पड़ सकता है. साथ ही, यह पक्का करना पड़ सकता है कि उसे इसकी सूचना मिल गई हो. Add Message API का इस्तेमाल करके, message_type के बराबर TEXT_AND_NOTIFY अनुरोध करने पर, यह होता है:
- "पास के पीछे की ओर" (इसे जानकारी वाला टेंप्लेट भी कहा जाता है) में "मैसेज" आइटम जोड़ा जाता है. साथ ही, जिन लोगों ने पास सेव किया है उन्हें पुश नोटिफ़िकेशन भेजा जाता है.
- जब उपयोगकर्ता सूचना पर टैप करता है, तो पास (इसे कार्ड व्यू भी कहा जाता है) के सामने Google Wallet खुल जाता है. इसके बाद, उपयोगकर्ता को स्क्रीन के सबसे ऊपर एक कॉलआउट दिखेगा. इसमें "मैसेज देखें" बटन होगा.
- कॉलआउट पर क्लिक करने से, लोग पास के बैक पर पहुंच जाएंगे. यहां नए और पढ़े नहीं गए मैसेज हाइलाइट किए जाते हैं.
लोगों को सूचनाओं के साथ मैसेज भेजते समय ध्यान रखने वाली कुछ बातें
- उपयोगकर्ताओं को मैसेज से जुड़ी पुश सूचनाएं पाने के लिए, अपने पास के लिए सूचनाएं पाने की सुविधा चालू करनी होगी.
- मैसेज में आपकी वेबसाइट या ऐप्लिकेशन के यूआरआई शामिल हो सकते हैं. हाइपरलिंक, पास से जुड़ी वेबसाइट या ऐप्लिकेशन का होना चाहिए. लोगों को ऐसे लिंक पर रीडायरेक्ट करना, स्वीकार्य इस्तेमाल से जुड़ी नीति का उल्लंघन है जो पास से जुड़े नहीं हैं.
- आपके पास 24 घंटे में ज़्यादा से ज़्यादा तीन ऐसे मैसेज भेजने का विकल्प होता है जिनसे पुश सूचना ट्रिगर होती है. अगर Google को लगता है कि आपने उपयोगकर्ताओं को स्पैम किया है, तो वह पुश नोटिफ़िकेशन भेजने के आपके कोटे को कम कर सकता है.
- उपयोगकर्ताओं को उनकी लॉक स्क्रीन पर दिखने वाली पुश सूचना को Google Wallet कंट्रोल करता है.
- सामान्य क्लास या ऑब्जेक्ट एंडपॉइंट का इस्तेमाल करके, मैसेज डेटा में बदलाव करने या उसे हटाने के लिए, UPDATE या PATCH तरीकों का इस्तेमाल किया जा सकता है.
इंटिग्रेशन का तरीका
अगर आपको AddMessage API का इस्तेमाल करके जोड़े गए नए मैसेज के बारे में उपयोगकर्ताओं को सूचना देनी है, तो आपको AddMessageRequest को अपडेट करना होगा. इससे, आपके नए टेक्स्ट वाले Message में 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" }, …
पास ऑब्जेक्ट में मैसेज जोड़ने और सूचना भेजने का 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" का इस्तेमाल किया जा सकता है. इसके बारे में इंटिग्रेशन के चरणों में बताया गया है.
Nearby नोटिफ़िकेशन
इस सुविधा के तहत, उन लोगों को पुश नोटिफ़िकेशन दिखाया जाएगा जिन्होंने सूचनाएं पाने की सुविधा चालू की है. साथ ही, Google Wallet ऐप्लिकेशन को जगह की सटीक जानकारी हमेशा ऐक्सेस करने की अनुमति दी है. इस नोटिफ़िकेशन में उन्हें याद दिलाया जाएगा कि उन्होंने अपनी मौजूदा जगह के हिसाब से कोई पास सेव किया है.इंटिग्रेशन का तरीका
कैसे इस्तेमाल करें
इस सुविधा का इस्तेमाल करने के लिए, आपको अपनी क्लास और ऑब्जेक्ट में जगह की जानकारी जोड़नी होगी. हर क्लास और हर ऑब्जेक्ट के लिए, ज़्यादा से ज़्यादा 10 जगहें जोड़ी जा सकती हैं. अपनी क्लास या ऑब्जेक्ट की परिभाषा में MerchantLocations का इस्तेमाल करें. insert, patch या update तरीकों का इस्तेमाल करते समय, इन जगहों को जोड़ा जा सकता है.
किसी क्लास या ऑब्जेक्ट में जगह की जानकारी जोड़ने के बाद, Google उन उपयोगकर्ताओं को सूचनाएं भेजेगा जो आस-पास मौजूद हैं. Google यह तय करता है कि सूचना भेजने से पहले, उपयोगकर्ता को कितनी देर तक और कितनी दूरी तक उस जगह पर रहना होगा. सूचना के टेक्स्ट को भी Google कंट्रोल करता है.
MerchantLocations सेट किए गए LoyaltyClass का उदाहरण:{
"kind": "walletobjects#loyaltyClass",
"programLogo": {
"kind": "walletobjects#image",
"sourceUri": {
"uri":
...
}
},
"localizedProgramName": {
"kind": "walletobjects#localizedString",
"defaultValue": {
"kind": "walletobjects#translatedString",
"language": "en",
"value": "Program Name",
}
},
"id": Id1234,
"version": "1",
"allowMultipleUsersPerObject": true,
"reviewStatus": "underReview",
"enableSmartTap": false,
"localizedIssuerName": {
"kind": "walletobjects#localizedString",
"defaultValue": {
"kind": "walletobjects#translatedString",
"language": "en",
"value": "Issuer Name"
}
},
"multipleDevicesAndHoldersAllowedStatus": "multipleHolders",
"merchantLocations": [
{
"latitude": 37.79020867928078,
"longitude": -122.39004
},
{
"latitude": 37.42587,
"longitude": -122.08620
},
]
}अनुमानित व्यवहार
जब उपयोगकर्ता, कारोबारी या कंपनी की बताई गई किसी जगह पर हों, तब उन्हें पास के बारे में स्टिकी सूचनाएं मिलनी चाहिए. सूचना पर क्लिक करने से, Google Wallet में उनका पास खुल जाएगा. उपयोगकर्ता, स्वाइप करके सूचना को खारिज कर सकते हैं. जब कोई उपयोगकर्ता उस जगह से चला जाता है, तो सूचना दिखनी बंद हो जाएगी.