अपने-आप लिंक होने वाले पास

बैकग्राउंड

अपने-आप लिंक होने वाले पास की सुविधा की मदद से, किसी ऐसे उपयोगकर्ता को अतिरिक्त पास भेजे जा सकते हैं जिसके Google Wallet में आपका मौजूदा पास पहले से मौजूद है. जब कोई उपयोगकर्ता प्राइमरी (मुख्य) पास सेव करता है, तो पास को प्राइमरी पास से पहले से लिंक भी किया जा सकता है. अपने-आप लिंक होने वाला पास, प्राइमरी पास के साथ ग्रुप किया जाता है. साथ ही, प्राइमरी पास के ऊपर एक कॉलआउट होता है, जिसमें उपयोगकर्ता को बताया जाता है कि एक नया पास लिंक किया गया है. प्राइमरी या लिंक किए गए पास के तौर पर, ये पास टाइप काम करते हैं;

• इवेंट टिकट
• बोर्डिंग पास
• सार्वजनिक परिवहन से यात्रा का पास
• ऑफ़र
• उपहार कार्ड
• लॉयल्टी पास
• सामान्य पास

प्राइमरी पास, जिसमें यह जानकारी देने वाला कॉलआउट है कि एक नया पास जोड़ा गया है	प्राइमरी पास से लिंक किया गया नया पास

उपयोग के उदाहरण

किसी मौजूदा पास से पास लिंक करने के लिए, आपके पास इस्तेमाल के अलग-अलग उदाहरण हो सकते हैं. इसके कुछ उदाहरण यहां दिए गए हैं:

• किसी मौजूदा लॉयल्टी कार्ड से ऑफ़र लिंक करें.
• मील वाउचर को बोर्डिंग पास या इवेंट के टिकट से लिंक करें.
• पार्किंग पास को इवेंट के टिकट से लिंक करना.

अपने-आप लिंक होने वाले पास का इस्तेमाल करते समय ध्यान देने वाली बातें

• प्राइमरी ऑब्जेक्ट और लिंक किए गए ऑब्जेक्ट में एक ही issuerId का इस्तेमाल किया जाना चाहिए.
• हर प्राइमरी ऑब्जेक्ट में 50 लिंक किए गए ऑब्जेक्ट हो सकते हैं.
• लिंक किए गए पास अपने-आप पुश होने की कोई गारंटी नहीं है. हालांकि, ऐसा करने की पूरी कोशिश की जाती है. उपयोगकर्ता, अपने-आप लिंक होने वाले पास पाने की सुविधा से ऑप्ट आउट कर सकते हैं. अगर इस्तेमाल का उदाहरण ज़रूरी है और उपयोगकर्ता को लिंक किया गया पास चाहिए, तो हमारा सुझाव है कि आप किसी दूसरे चैनल से संपर्क करें. इससे यह पक्का किया जा सकेगा कि उपयोगकर्ता पास जोड़ ले.
• Google Wallet के उपयोगकर्ता समझौते में किए गए अपडेट में, अपने-आप लिंक होने वाले पास के इस्तेमाल से जुड़े दिशा-निर्देश शामिल हैं. इनका पालन करना ज़रूरी है.

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

अगर आपने पहले से ही प्राइमरी ऑब्जेक्ट बना लिया है, तो पहला चरण छोड़ा जा सकता है.

1. ज़रूरी पैरामीटर के साथ, सूची में दिए गए किसी भी पास टाइप का ऑब्जेक्ट बनाएं. यह प्राइमरी ऑब्जेक्ट है.
2. सूची में दिए गए किसी भी टाइप का दूसरा ऑब्जेक्ट बनाएं. यह लिंक किया गया ऑब्जेक्ट होगा.
3. प्राइमरी ऑब्जेक्ट के सेव होने से पहले या बाद में, linkedObjectIds पैरामीटर में लिंक किए गए ऑब्जेक्ट के आईडी से प्राइमरी ऑब्जेक्ट को अपडेट करें.

प्राइमरी पास पर linkedObjectIds सेट करने के लिए, कम से कम पेलोड की ज़रूरत होती है. तीन ज़रूरी पैरामीटर में ये शामिल हैं:

1. ISSUERID.PRIMARY_OBJECT_ID
2. ISSUERID.PRIMARY_CLASS_ID
3. ISSUERID.LINKED_OBJECT_ID

पास ऑब्जेक्ट में लिंक किया गया ऑब्जेक्ट जोड़ने के लिए, JSON अनुरोध का उदाहरण

  …
  {
    "id": "ISSUERID.PASS_OBJECTID",
    "classId": "ISSUERID.PASS_CLASSID",
    "barcode": {
      "type": "qrCode",
      "value": "QR code"
    },
    "linkedObjectIds": {"ISSUERID.LINKED_PASS_OBJECTID"}
  }
  …

किसी ऑब्जेक्ट को पास ऑब्जेक्ट से लिंक करने के बाद, JSON रिस्पॉन्स का उदाहरण

  …
  "state": "active",
  "linkedObjectIds": {
    "ISSUERID.LINKED_PASS_OBJECTID"
  }
  …

उम्मीद के मुताबिक व्यवहार

जवाब मिलने के बाद, जिन डिवाइसों पर आपने पास अपडेट किया है उन्हें लिंक किया गया पास मिल जाना चाहिए. लिंक किए गए इस पास को प्राइमरी पास के साथ ग्रुप किया जाएगा. उपयोगकर्ता, दाईं ओर स्वाइप करके लिंक किया गया पास देख सकते हैं.

अपवाद मैनेज करना

एपीआई के गलत इस्तेमाल से संभावित गड़बड़ियां हो सकती हैं. इनमें ये शामिल हैं:

मैसेज	वजह
मुख्य ऑब्जेक्ट और लिंक किए गए ऑब्जेक्ट का जारीकर्ता आईडी एक ही नहीं है.	लिंक किए गए ऑब्जेक्ट को, किसी दूसरे जारीकर्ता के ऑब्जेक्ट से अटैच नहीं किया जा सकता.
प्राइमरी ऑब्जेक्ट और लिंक किए गए ऑब्जेक्ट, एक ही ऑब्जेक्ट को रेफ़र करते हैं.	लिंक किए गए ऑब्जेक्ट के तौर पर, उसी ऑब्जेक्ट को अटैच नहीं किया जा सकता.
लिंक किया गया ऑब्जेक्ट मौजूद नहीं है.	लिंक किया गया ऑब्जेक्ट, Wallet API में पहले से मौजूद होना चाहिए.
लिंक किए गए ऑब्जेक्ट में पहले से ही कोई दूसरा लिंक किया गया ऑब्जेक्ट मौजूद है. नेस्ट किए गए लिंक किए गए ऑब्जेक्ट नहीं जोड़े जा सकते.	लिंक किए गए ऑब्जेक्ट में कोई दूसरा लिंक किया गया ऑब्जेक्ट नहीं हो सकता.
ऑब्जेक्ट पहले से ही किसी दूसरे ऑब्जेक्ट से जुड़ा हुआ है. नेस्ट किए गए लिंक किए गए ऑब्जेक्ट नहीं जोड़े जा सकते.	प्राइमरी ऑब्जेक्ट, खुद से लिंक किया गया ऑब्जेक्ट नहीं हो सकता.
लिंक किए गए कोई और ऑब्जेक्ट नहीं जोड़ा जा सकता. सीमा पार हो गई है.	प्राइमरी पास के लिए, लिंक किए गए 50 पास की सीमा पूरी हो गई है.