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

बैकग्राउंड

पास अपने-आप लिंक होने की सुविधा की मदद से, किसी ऐसे व्यक्ति को अतिरिक्त पास भेजे जा सकते हैं जिसके पास पहले से ही 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 पास की सीमा पूरी हो गई है.