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

बैकग्राउंड

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

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

इस्तेमाल के उदाहरण

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

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

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

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

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

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

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

मुख्य पास पर LinkingObjectIds सेट करने के लिए, पेलोड कम से कम होना चाहिए. तीन ज़रूरी पैरामीटर में ये शामिल हैं;

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 पास की सीमा पूरी हो गई है.