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

पार्टनर की ओर से ट्रिगर की गई सूचनाएं

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

बैकग्राउंड

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

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

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

  • उपयोगकर्ताओं को मैसेज से जुड़ी पुश सूचनाएं पाने के लिए, अपने पास के लिए सूचनाएं पाने की सुविधा चालू करनी होगी.
  • मैसेज में आपकी वेबसाइट या ऐप्लिकेशन के यूआरआई शामिल हो सकते हैं. हाइपरलिंक, पास से जुड़ी वेबसाइट या ऐप्लिकेशन का होना चाहिए. लोगों को ऐसे लिंक पर रीडायरेक्ट करना, स्वीकार्य इस्तेमाल से जुड़ी नीति का उल्लंघन है जो पास से जुड़े नहीं हैं.
  • आपके पास 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" का इस्तेमाल किया जा सकता है. इसके बारे में इंटिग्रेशन के चरणों में बताया गया है.

फ़ील्ड अपडेट करें और सूचना भेजें

बैकग्राउंड

जब कोई उपयोगकर्ता पास जोड़ता है, तो हो सकता है कि आपको कुछ फ़ील्ड अपडेट करने पर पुश नोटिफ़िकेशन ट्रिगर करना हो. यह सूचना, उपयोगकर्ता की लॉक स्क्रीन पर दिखेगी. इससे उन्हें पता चलेगा कि उनके पास में कोई अपडेट है. यह सूचना, सिर्फ़ फ़ील्ड के किसी सबसेट के लिए ट्रिगर होगी. UPDATE और PATCH एपीआई के तरीकों का इस्तेमाल करके, यहां दिए गए फ़ील्ड के सबसेट को तय किया जाता है. पास अपडेट करने के लिए एपीआई कॉल करने पर, ये काम किए जाते हैं:

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

फ़ील्ड अपडेट की सूचनाएं भेजते समय ध्यान रखने वाली कुछ बातें

  • उपयोगकर्ताओं को पास के अपडेट से जुड़ी पुश नोटिफ़िकेशन पाने के लिए, अपने पास के लिए सूचनाएं पाने की सुविधा चालू करनी होगी.
  • आपके पास 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

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 में उनका पास खुल जाएगा. उपयोगकर्ता, स्वाइप करके सूचना को खारिज कर सकते हैं. जब कोई उपयोगकर्ता उस जगह से चला जाता है, तो सूचना दिखनी बंद हो जाएगी.

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:00PM कर दिया है._" सूचना के फ़ॉर्मैट या भाषा को पसंद के मुताबिक नहीं बनाया जा सकता.