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

बैकग्राउंड

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

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

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

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

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

दूसरा चरण: फ़्रीक्वेंट फ़्लायर के लिए, नए बोर्डिंग पास अपने-आप जुड़ जाते हैं. इसके लिए, उन्हें 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"
  }
  …

आम तौर पर, यह कैसा दिखना चाहिए

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

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

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