मुख्य सिद्धांत और शब्दावली

पास जारी करने वाली कंपनी

पास जारी करने वाली कंपनी वह इकाई होती है जिसके पास पास होता है. साथ ही, यह अपने ग्राहकों को पास जारी करने की ज़िम्मेदारी भी लेता है. यह आप, डेवलपर या वह संगठन हो सकता है जिसके आप प्रतिनिधि हैं.

पास जारी करने के लिए, आपको सबसे पहले पास जारी करने वाले के तौर पर रजिस्टर करना होगा.

इवेंट के टिकट की क्लास

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

इसके अलावा, EventClass का इस्तेमाल स्मार्ट टैप जैसी अन्य सुविधाओं को चालू करने के लिए भी किया जा सकता है.

इवेंट का टिकट ऑब्जेक्ट

इवेंट का टिकट ऑब्जेक्ट, EventClass का इंस्टेंस होता है. इवेंट के टिकट के साथ डिस्ट्रिब्यूट किए गए हर ग्राहक के लिए, एक नया EventObject इंस्टेंस बनाया जाना चाहिए.

पास क्लास

EventClass एक तरह की पास क्लास है. पास क्लास, उनसे जुड़े पास ऑब्जेक्ट (जैसे कि स्टाइल और दिखने का तरीका) के लिए सामान्य जानकारी बताती हैं. इनमें ग्राहक की जानकारी शामिल नहीं होती.

ऑब्जेक्ट पास करें

EventObject एक तरह का पास ऑब्जेक्ट है. EventObjects की तरह, पास ऑब्जेक्ट, इससे जुड़ी पास क्लास का इंस्टेंस होता है. हर उस ग्राहक के लिए पास ऑब्जेक्ट बनाया जाना चाहिए जिसे इवेंट का टिकट जारी किया गया है.

पास ऑब्जेक्ट में, ग्राहक के बारे में खास जानकारी होती है. उदाहरण के लिए, इस सुविधा का इस्तेमाल यह पता लगाने के लिए भी किया जा सकता है कि ग्राहक के पास न सिर्फ़ इवेंट का टिकट है, बल्कि यह भी पता चलता है कि इवेंट में उसे कौनसी सीट दी गई है.

सेवा खाता

Google Wallet API को कॉल करने के लिए, सेवा खाते का इस्तेमाल किया जाता है. Passes API को ऐक्सेस करने की अनुमति, इस सेवा खाते से दी जानी चाहिए.

सुविधा के खाते की कुंजी

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