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

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

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

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

उदाहरण

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

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

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

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

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