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