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

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

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

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

उदाहरण

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

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

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

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

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