सेशन के टोकन

'जगह की जानकारी अपने-आप पूरी होने वाली सुविधा', बिलिंग के मकसद से अलग सेशन में उपयोगकर्ता की अपने-आप पूरी होने वाली खोज की क्वेरी और चुने गए चरणों को ग्रुप करने के लिए सेशन टोकन का इस्तेमाल करती है. सेशन की शुरुआत, उपयोगकर्ता के क्वेरी टाइप करने के बाद होती है. जब कोई जगह चुनी जाती है और जगह की जानकारी को कॉल किया जाता है, तब सेशन खत्म होता है. हर सेशन में कई ऑटोकंप्लीट क्वेरी हो सकती हैं और इनके बाद एक जगह को चुना जा सकता है. किसी सेशन में हर अनुरोध के लिए इस्तेमाल की जाने वाली एपीआई कुंजियां, एक ही Google Cloud Console प्रोजेक्ट से जुड़ी होनी चाहिए. सेशन खत्म होने के बाद, टोकन मान्य नहीं रहता; आपके ऐप्लिकेशन को हर सेशन के लिए एक नया टोकन जनरेट करना होगा. अगर sessiontoken पैरामीटर हटाया जाता है या किसी सेशन टोकन का फिर से इस्तेमाल किया जाता है, तो सेशन से इस तरह शुल्क लिया जाता है कि कोई सेशन टोकन नहीं दिया गया है. हर अनुरोध का बिल अलग से भेजा जाता है.

हमारा सुझाव है कि आप नीचे दिए गए दिशा-निर्देशों का पालन करें:

• अपने-आप पूरा होने वाले सभी सेशन के लिए, सेशन टोकन का इस्तेमाल करें.
• हर सेशन के लिए नया टोकन जनरेट करें.
• पक्का करें कि किसी सेशन में 'जगह की जानकारी अपने-आप पूरी होने की सुविधा' और 'जगह की जानकारी' के सभी अनुरोधों के लिए इस्तेमाल की गई एपीआई पासकोड एक ही Google Cloud Console प्रोजेक्ट से जुड़े हों.
• हर नए सेशन के लिए, यूनीक सेशन टोकन पास करना न भूलें. एक से ज़्यादा सेशन के लिए एक ही टोकन का इस्तेमाल करने पर, हर अनुरोध की बिलिंग अलग से की जाएगी.

आपके पास किसी अनुरोध से ऑटोकंप्लीट सेशन टोकन को हटाने का विकल्प भी होता है. अगर सेशन टोकन हटाया जाता है, तो हर अनुरोध को अलग से बिल किया जाता है. इससे ऑटोकंप्लीट - हर अनुरोध SKU ट्रिगर होता है. किसी सेशन टोकन का फिर से इस्तेमाल करने पर, सेशन को अमान्य माना जाता है. साथ ही, अनुरोधों के लिए इस तरह शुल्क लिया जाता है जैसे कोई सेशन टोकन न दिया गया हो.

उदाहरण

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

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

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

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

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

सेशन टोकन बनाने के लिए, AutocompleteSessionToken.newInstance() पर कॉल करें.