बोर्डिंग पास अपने-आप जुड़ने की सुविधा

बैकग्राउंड

इस सुविधा की मदद से एयरलाइन, किसी व्यक्ति के Google Wallet में अपने-आप बोर्डिंग पास भेज सकती हैं. इससे उन लोगों को खास तौर पर फ़ायदा होगा जो अक्सर फ़्लाइट से यात्रा करते हैं. वे अब आसानी से और बिना किसी रुकावट के, अपने बोर्डिंग पास को Wallet में जोड़ पाएंगे.

यह अपने-आप होता है.इससे कोई फ़र्क़ नहीं पड़ता कि चेक-इन किस चैनल से किया गया है. जैसे, वेब, ऐप्लिकेशन या एयरपोर्ट किओस्क. एयरलाइन पार्टनर, उपयोगकर्ता के लॉयल्टी खाते के नंबर का इस्तेमाल करके, पास को उसके Wallet में भेज सकते हैं.

यह सुविधा कैसे काम करती है

पहला चरण: बार-बार यात्रा करने वाले व्यक्ति को, फ़्रीक्वेंट फ़्लायर लॉयल्टी पास को Wallet में जोड़ने की अनुमति दें.

दूसरा चरण: बार-बार फ़्लाइट से सफ़र करने वाले लोगों के लिए, नए बोर्डिंग पास अपने-आप जुड़ जाते हैं. इसके लिए, उन्हें Wallet में मौजूद लॉयल्टी पास से लिंक करना होता है.

सबसे सही तरीके

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

ध्यान दें: यह सुविधा, पास अपने-आप लिंक होने की सुविधा का एक खास वर्शन है. इस संदर्भ में, प्राइमरी पास का मतलब लॉयल्टी कार्ड से है. वहीं, लिंक किए गए पास का मतलब बोर्डिंग पास से है. इस दस्तावेज़ के बाकी हिस्से में, इस सुविधा के बारे में बताने के लिए, ज़्यादा सामान्य शब्दों का इस्तेमाल किया गया है. जैसे, अपने-आप लिंक होने वाले पास, मुख्य पास, और लिंक किया गया पास.

ऑटो लिंक किए गए पास का इस्तेमाल करते समय ध्यान रखने वाली कुछ बातें

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