पुश नोटिफ़िकेशन ट्रिगर करें

सूचना के टाइप

मैसेज जोड़ें और सूचना दें

बैकग्राउंड

अगर कोई उपयोगकर्ता, पास की जानकारी जोड़ता है, तो आपको उसे पास से जुड़ा मैसेज भेजना चाहिए. साथ ही, यह भी पक्का करना चाहिए कि उसे इसकी सूचना दी जाए. TEXT_AND_NOTIFY के बराबर message_type के साथ Add Message API अनुरोध का इस्तेमाल करने पर ये चीज़ें होती हैं:

  1. "मैसेज" आइटम को "पास के पिछले हिस्से" (यानी जानकारी का टेंप्लेट) में जोड़ा जाता है और सेव किए गए पास की जानकारी के साथ, उपयोगकर्ताओं को एक पुश नोटिफ़िकेशन भेजा जाता है.
  2. जब उपयोगकर्ता इस सूचना पर टैप करता है, तो पास के सामने Google Wallet खुल जाता है (यानी कार्ड व्यू). इसके बाद, उपयोगकर्ता को स्क्रीन पर सबसे ऊपर "मैसेज देखें" बटन के साथ एक कॉलआउट दिखेगा.
  3. कॉलआउट पर क्लिक करने पर, उपयोगकर्ता पास के पिछले हिस्से पर पहुंच जाएंगे, जहां वे नए मैसेज हाइलाइट किए जाएंगे.

उपयोगकर्ताओं को सूचनाओं वाले मैसेज भेजते समय कुछ बातों का ध्यान रखना

  • उपयोगकर्ताओं को मैसेज से जुड़े पुश नोटिफ़िकेशन पाने के लिए, अपने पास से जुड़ी सूचनाएं पाने की सुविधा चालू करनी होगी.
  • मैसेज में आपकी वेबसाइट या ऐप्लिकेशन के यूआरआई शामिल हो सकते हैं. हाइपरलिंक, पास से जुड़ी कोई वेबसाइट या ऐप्लिकेशन होने चाहिए. लोगों को ऐसे लिंक भेजना जो पास से नहीं जुड़े हैं, उचित इस्तेमाल की नीति का उल्लंघन होता है.
  • 24 घंटे में, पुश नोटिफ़िकेशन ट्रिगर करने वाले ज़्यादा से ज़्यादा तीन मैसेज भेजे जा सकते हैं. अगर Google को लगता है कि आपकी तरफ़ से उपयोगकर्ताओं को स्पैम किया जा रहा है, तो वह आपके पुश नोटिफ़िकेशन डिलीवरी कोटा को थ्रॉटल कर सकता है.
  • उपयोगकर्ताओं को उनकी लॉक स्क्रीन पर दिखने वाले पुश नोटिफ़िकेशन को Google Wallet से कंट्रोल किया जाता है.
  • रेगुलर क्लास या ऑब्जेक्ट एंडपॉइंट का इस्तेमाल करके, मैसेज के डेटा में बदलाव करने या उसे हटाने के लिए, अपडेट करें या PATCH तरीकों का इस्तेमाल किया जा सकता है.

इंटिग्रेशन का तरीका

जब आप उपयोगकर्ताओं को AddMessage API की मदद से जोड़े गए नए मैसेज जारी करने वाले व्यक्ति के बारे में बताना चाहें, तो AddMessageRequest को अपडेट करना होगा, ताकि आपके नए टेक्स्ट वाले Message में TEXT_AND_NOTIFY की जगह TEXT_AND_NOTIFY दिखे.MessageType

पास की क्लास में मैसेज जोड़ने और सूचना देने के लिए, 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" का इस्तेमाल करके सेट किया जा सकता है, जैसा कि इंटिग्रेशन के चरणों में बताया गया है.