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

बैकग्राउंड

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

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

झलक देखें: यह सुविधा अभी तक पूरी तरह से लॉन्च नहीं की गई है. एक्सप्रेस एक्सप्रेस की सुविधा का ऐक्सेस पाने के लिए आपकी दिलचस्पी.

नए पास की जानकारी देने के लिए कॉलआउट वाला प्राइमरी पास	मुख्य पास से जुड़ा नया पास

उपयोग के उदाहरण

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

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

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

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

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

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

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

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

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