'जगह की जानकारी अपने-आप भर जाने वाली सुविधा', बिलिंग के मकसद से, अलग-अलग सेशन में उपयोगकर्ता की अपने-आप पूरे होने वाली खोज की क्वेरी और चुने गए चरणों को ग्रुप करने के लिए, सेशन टोकन का इस्तेमाल करती है. सेशन तब शुरू होता है, जब उपयोगकर्ता टाइप करना शुरू करता है. जगह चुनने के बाद
जगह की जानकारी को कॉल करते समय यह सेशन खत्म होता है. हर सेशन में एक से ज़्यादा ऑटोकंप्लीट क्वेरी हो सकती हैं, जिनके बाद एक ही जगह चुनी जा सकती है. किसी सेशन में हर अनुरोध के लिए इस्तेमाल की जाने वाली एपीआई पासकोड, उसी Google Cloud Console प्रोजेक्ट से जुड़े होने चाहिए. सेशन खत्म होने के बाद, टोकन मान्य नहीं रहता. आपके ऐप्लिकेशन को हर सेशन के लिए नया टोकन जनरेट करना होगा. अगर sessiontoken पैरामीटर को शामिल नहीं किया जाता है या किसी सेशन टोकन का फिर से इस्तेमाल किया जाता है, तो सेशन से इस तरह शुल्क लिया जाता है कि कोई सेशन टोकन नहीं दिया गया है. हर अनुरोध का बिल अलग से भेजा जाता है.
हमारा सुझाव है कि आप नीचे दिए गए दिशा-निर्देशों का पालन करें:
- अपने-आप पूरा होने वाले सभी सेशन के लिए, सेशन टोकन का इस्तेमाल करें.
- हर सेशन के लिए नया टोकन जनरेट करें.
- पक्का करें कि किसी सेशन में 'जगह की जानकारी अपने-आप पूरी होने की सुविधा' और 'जगह की जानकारी' के सभी अनुरोध के लिए इस्तेमाल की गई एपीआई पासकोड, एक ही Google Cloud Console प्रोजेक्ट से जुड़े हों.
- हर नए सेशन के लिए एक यूनीक सेशन टोकन पास करना न भूलें. एक से ज़्यादा सेशन के लिए एक ही टोकन का इस्तेमाल करने से, हर अनुरोध की बिलिंग अलग से की जाएगी.
आपके पास किसी अनुरोध से ऑटोकंप्लीट सेशन टोकन को हटाने का विकल्प भी होता है. अगर सेशन टोकन हटाया जाता है, तो हर अनुरोध की बिलिंग अलग-अलग होती है. इससे अपने-आप पूरा होने की सुविधा - हर अनुरोध SKU ट्रिगर होता है. अगर किसी सेशन टोकन का फिर से इस्तेमाल किया जाता है, तो सेशन को अमान्य माना जाता है. साथ ही, अनुरोधों के लिए इस तरह शुल्क लिया जाता है जैसे कोई सेशन टोकन नहीं दिया गया हो.
उदाहरण
जब उपयोगकर्ता कोई क्वेरी टाइप करता है, तो अपने-आप पूरा होने वाले अनुरोध को हर कुछ कीस्ट्रोक (हर वर्ण के हिसाब से नहीं) कहा जाता है. साथ ही, संभावित नतीजों की सूची दिखती है. जब उपयोगकर्ता, नतीजों की सूची में से किसी विकल्प को चुनता है, तो उस विकल्प को एक अनुरोध के तौर पर गिना जाता है. साथ ही, खोज के दौरान किए गए सभी अनुरोधों को बंडल किया जाता है और उन्हें एक अनुरोध के तौर पर गिना जाता है. अगर कोई व्यक्ति किसी जगह को चुनता है, तो उसकी खोज क्वेरी बिना किसी शुल्क के उपलब्ध हो जाती है. साथ ही, सिर्फ़ जगह से जुड़े डेटा के अनुरोध से शुल्क लिया जाता है. अगर उपयोगकर्ता, सेशन शुरू होने के कुछ मिनटों के अंदर कोई विकल्प नहीं चुनता है, तो सिर्फ़ खोज क्वेरी से शुल्क लिया जाता है.
आइए, ऐप्लिकेशन के नज़रिए से इवेंट के इस फ़्लो की जांच करें.
- एक उपयोगकर्ता, "Paris, France" को खोजने के लिए क्वेरी टाइप करना शुरू करता है.
- उपयोगकर्ता के इनपुट का पता लगाने के बाद, यह ऐप्लिकेशन एक नया सेशन टोकन बनाता है. इसका नाम "टोकन A" है.
- उपयोगकर्ता के टाइप करते ही, एपीआई हर कुछ वर्णों के लिए एक ऑटोकंप्लीट
अनुरोध करता है, जिसमें हर एक के लिए संभावित नतीजों की नई सूची दिखती है:
"P"
"Par"
"Paris,"
"Paris, Fr"
- जब उपयोगकर्ता यह विकल्प चुनता है:
- क्वेरी से मिलने वाले सभी अनुरोधों को ग्रुप किया जाता है और उन्हें "टोकन A" से दिखाए गए सेशन में एक अनुरोध के तौर पर जोड़ दिया जाता है.
- उपयोगकर्ता के चुने गए विकल्प को जगह की जानकारी के अनुरोध के तौर पर गिना जाता है और उसे "टोकन A" से दिखाए जाने वाले सेशन में जोड़ दिया जाता है.
- सेशन खत्म होने के बाद ऐप्लिकेशन, "टोकन A" को खारिज कर देता है.
इस बारे में ज़्यादा जानकारी के लिए कि अपने-आप पूरे होने वाले अनुरोधों का बिल कैसे भेजा जाता है, इस्तेमाल और बिलिंग देखें.
सेशन के टोकन बनाएं
सेशन टोकन बनाने के लिए, GMSAutocompleteSessionToken.init() को कॉल करें.