खास जानकारी

Google Wallet Passes API की मदद से पार्टनर, बस, मेट्रो वगैरह का टिकट चालू करने में मदद मिलती है. चालू करने की ज़रूरत होने पर, आपको “चालू करें” बटन दिखेगा उपयोगकर्ता के लिए है, जिसे टैप करने पर नीचे बताए गए पैरामीटर के साथ दिए गए एंडपॉइंट को कॉल किया जाएगा. एंडपॉइंट को यह पक्का करना चाहिए कि पास में, ऑफ़र को रिडीम करने के बारे में मान्य जानकारी मौजूद हो. जैसे, बारकोड या विज़ुअल की जांच) के बाद, वापस आने से पहले उपयोगकर्ता के Wallet में पास को अपडेट किया जाएगा ऑफ़र रिडीम करने की जानकारी दिखा सके. ध्यान रखें कि ऐक्टिवेशन से पहले, किसी भी मौजूदा रिडेंप्शन के तहत, यह जानकारी नहीं दिखाई जाएगी.

ऐक्टिवेशन एपीआई

ऐक्टिवेशन एंडपॉइंट, एपीआई में activationOptions का इस्तेमाल करके, ट्रांज़िट क्लास. यह पार्टनर, एक ऐक्टिव ऐक्टिवेशन एंडपॉइंट को बनाए रखने के लिए ज़िम्मेदार है. इंतज़ार का समय तय करना.

  activationOptions: {
    activationUrl: string
  }

फ़ील्ड	ब्यौरा
activationUrl	string पार्टनर एंडपॉइंट का यूआरएल, जिसे चालू करने के अनुरोध के लिए कॉल किया जाएगा. यूआरएल को को एचटीटीपीएस और robots.txt पर होस्ट किया जाना चाहिए. इससे यूआरएल पाथ को UserAgent:Google-Valuables.

ऐक्टिवेशन की स्थिति, activationStatus फ़ील्ड का इस्तेमाल करके ऑब्जेक्ट पर सेव की जाती है. मान्य स्थिति में NOT_ACTIVATED और ACTIVATED शामिल हैं. ऐक्टिवेशन एंडपॉइंट को ऑब्जेक्ट को ACTIVATED स्थिति के साथ अपडेट करना चाहिए. साथ ही, यह पक्का करना चाहिए कि ऑब्जेक्ट में, ऑफ़र को रिडीम करने के बारे में मान्य जानकारी दी गई है. जैसे, बारकोड या विज़ुअल की जांच करने वाले पैरामीटर. कॉन्टेंट बनाने deviceContext फ़ील्ड का इस्तेमाल, डिवाइस को पिन करने के लिए किया जा सकता है.

  activationStatus: enum (ActivationStatus),
  deviceContext: {
    deviceToken: string
  },
  hasLinkedDevice: boolean

फ़ील्ड	ब्यौरा
activationStatus	enum (ActivationStatus) इस ट्रांज़िट ऑब्जेक्ट के लिए ऐक्टिवेशन की स्थिति. इस स्थिति से टिकट खरीदने और उपयोगकर्ताओं को कार्रवाई करने की सुविधा देनी होगी; उदाहरण तो एक चालू करें बटन अगर यह NOT_ACTIVATED के तौर पर सेट है, तो टिकट की जानकारी. ये वैल्यू स्वीकार की जाती हैं: NOT_ACTIVATED ACTIVATED
deviceContext	object (DeviceContext) डिवाइस का वह कॉन्टेक्स्ट जिससे ऑब्जेक्ट को जोड़ना है. अगर यह नीति सेट की जाती है, तो ऑफ़र रिडीम करने की जानकारी सिर्फ़ बताए गए डिवाइस पर लौटाया जा सकता है.
hasLinkedDevice	boolean यह ऑब्जेक्ट फ़िलहाल एक डिवाइस से लिंक है या नहीं.

DeviceContext

फ़ील्ड

ब्यौरा

deviceToken

string अगर यह नीति सेट की जाती है, तो ऑफ़र रिडीम करने की जानकारी सिर्फ़ चालू किए जाने पर ही डिवाइस पर वापस की जाएगी कर सकते हैं. किसी उपयोगकर्ता के डिवाइस को ट्रेस करने के लिए, इसका इस्तेमाल स्टेबल आइडेंटिफ़ायर के तौर पर नहीं किया जा सकता. यह एक ही डिवाइस के लिए अलग-अलग पास या अलग-अलग पास में भी बदल सकते हैं एक ही डिवाइस के लिए ऐक्टिवेशन. इसे सेट करते समय, कॉलर को यह भी सेट करना चाहिए ऑब्जेक्ट को ऐक्टिवेट करने के लिए hasLinkedDevice. ध्यान दें कि deviceToken को इनसे मिला है ऐक्टिवेशन पैरामीटर deviceContext फ़ील्ड

डिवाइस पिन करना

डिवाइस को पिन करने की सुविधा की मदद से, उपयोगकर्ता किसी एक डिवाइस पर टिकट चालू कर सकता है और टिकट रिडीम करने की जानकारी सिर्फ़ उसी डिवाइस पर दिखेगी. यह ONE_USER_ONE_DEVICE का multipleDevicesAndHoldersAllowedStatus, जो इससे टिकट को सिर्फ़ एक डिवाइस पर दिखाया जा सकता है. हमारा सुझाव है कि आप अपने डिवाइस पिन करने की सुविधा के साथ ONE_USER_ALL_DEVICES.

खाता चालू होने से पहले, लोग किसी भी डिवाइस पर टिकट और 'चालू करें' बटन देख सकते हैं मालिकाना हक है. चालू और किसी डिवाइस पर पिन करने के बाद, पिन किया गया डिवाइस, ऑफ़र रिडीम करने की जानकारी दिखाएगा ऐसा करने पर अन्य डिवाइसों पर 'चालू करें' बटन दिखेगा, ताकि उपयोगकर्ता टिकट को दूसरे डिवाइस पर ले जा सके डिवाइस. अगर टिकट को ट्रांसफ़र करना ज़रूरी नहीं है, लेकिन किसी भी डिवाइस पर इसे चालू करना है, तो ऐक्टिवेशन के दौरान, टिकट को अपडेट करके ONE_USER_ONE_DEVICE का इस्तेमाल किया जा सकता है पिन करने की ज़रूरत नहीं है.

डिवाइस को पिन करने की सुविधा लागू करने के लिए, ऑब्जेक्ट को deviceToken फ़ील्ड की मदद से अपडेट करना ज़रूरी है यह डेटा, ऐक्टिवेशन पैरामीटर और उसी एपीआई कॉल में hasLinkedDevice को 'सही' पर सेट करें. अगर ज़रूरत हो, तो टिकट इसे किसी डिवाइस से अनलिंक किया जा सकता है. ऐसा करने के लिए, hasLinkedDevice को 'गलत है' पर सेट करें.

ऐक्टिवेशन पैरामीटर

ऐक्टिवेशन एंडपॉइंट के अनुरोध में ये पैरामीटर शामिल होंगे.

JSON का उदाहरण:

  {
    classId: “123.classId”,
    objectIds: [ “123.objectId” ],
    expTimeMillis: 1669671940735,
    eventType: “activate”,
    nonce: “1c6fccce-6f66-11ed-a1eb-0242ac120002”,
    deviceContext: “6fba937a-6f6e-11ed-a1eb-0242ac120002”
  }

पहचानकर्ता	ब्यौरा
classId	पूरी तरह क्वालिफ़ाइड क्लास आईडी. इस फ़ॉर्मैट का इस्तेमाल करता है: <issuer_id.class_id>
objectIds	नीचे दिए गए फ़ॉर्मैट का इस्तेमाल करने वाले ऑब्जेक्ट आईडी की पूरी तरह क्वालिफ़ाइड अरे: <issuer_id.object_id>
expTimeMillis	EPOCH के बाद से मिलीसेकंड में समयसीमा. समयसीमा खत्म होने के बाद, यह ज़रूरी है कि मैसेज अमान्य हो.
eventType	हमेशा "activate".
nonce	डुप्लीकेट डिलीवरी ट्रैक करने के लिए नॉन्स.
deviceContext	Google से जनरेट किया गया एक यूनीक आईडी, जो उस डिवाइस के बारे में बताता है जिस पर उपयोगकर्ता कार्रवाई कर रहा है. इस आईडी का इस्तेमाल, किसी ऑब्जेक्ट को डिवाइस से जोड़ने वाले अपडेट करते समय किया जाना चाहिए. ऐसा हो सकता है कि किसी डिवाइस से, आने वाले समय में अनुरोध करने के लिए, यह आईडी एक ही न रहे.