सेशन टोकन इस्तेमाल करना

सेशन टोकन, बिलिंग के मकसद से, उपयोगकर्ता के अपने-आप पूरी होने वाली खोज की क्वेरी और चुनने के चरणों को अलग-अलग सेशन में ग्रुप करते हैं.

सेशन टोकन बनाना

हर सेशन के लिए यूनीक सेशन टोकन जनरेट करने की ज़िम्मेदारी उपयोगकर्ताओं की होती है. Google, वर्शन 4 के UUID इस्तेमाल करने का सुझाव देता है.

उदाहरण

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

आइए, किसी ऐप्लिकेशन के नज़रिए से, इवेंट के इस फ़्लो की जांच करें.

1. कोई उपयोगकर्ता, "पेरिस, फ़्रांस" को खोजने के लिए क्वेरी टाइप करना शुरू करता है.
2. उपयोगकर्ता के इनपुट का पता चलने पर, ऐप्लिकेशन एक नया सेशन टोकन "टोकन A" बनाता है.
3. जब उपयोगकर्ता टाइप करता है, तो एपीआई हर कुछ वर्णों के बाद, अपने-आप पूरी होने वाली क्वेरी का अनुरोध करता है. साथ ही, हर वर्ण के लिए संभावित नतीजों की नई सूची दिखाता है:
   "P"
   "Par"
   "Paris,"
   "Paris, Fr"
   
4. जब उपयोगकर्ता कोई विकल्प चुनता है, तो:
• क्वेरी से मिले सभी अनुरोधों को ग्रुप किया जाता है और "टोकन A" से दिखाए गए सेशन में, एक अनुरोध के तौर पर जोड़ा जाता है.
• उपयोगकर्ता के चुने गए विकल्प को, Place Details अनुरोध के तौर पर गिना जाता है और "टोकन A" से दिखाए गए सेशन में जोड़ा जाता है.
5. सेशन खत्म हो जाता है और ऐप्लिकेशन "टोकन A" को हटा देता है.

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