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

बैकग्राउंड

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