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

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

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

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

उदाहरण

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

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

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

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