सेशन टोकन, उपयोगकर्ता की ऑटोमैटिक तरीके से पूरी होने वाली खोज की क्वेरी और चुनने के चरणों को बिलिंग के मकसद से अलग सेशन में ग्रुप करते हैं.
सेशन टोकन बनाना
हर सेशन के लिए यूनीक सेशन टोकन जनरेट करने की ज़िम्मेदारी उपयोगकर्ताओं की होती है. Google का सुझाव है कि वर्शन 4 के यूयूआईडी का इस्तेमाल करें.
उदाहरण
जब उपयोगकर्ता कोई क्वेरी टाइप करता है, तो हर कुछ समय के बाद (हर वर्ण के बाद नहीं) ऑटोकंप्लीट का अनुरोध किया जाता है. साथ ही, संभावित नतीजों की सूची दिखाई जाती है. जब उपयोगकर्ता नतीजों की सूची से कोई विकल्प चुनता है, तो उसे एक अनुरोध के तौर पर गिना जाता है. साथ ही, खोज के दौरान किए गए सभी अनुरोधों को एक साथ गिना जाता है. अगर उपयोगकर्ता कोई जगह चुनता है, तो खोज क्वेरी के लिए कोई शुल्क नहीं लिया जाता. सिर्फ़ जगह के डेटा के अनुरोध के लिए शुल्क लिया जाता है. अगर उपयोगकर्ता सेशन शुरू होने के कुछ मिनटों के अंदर कोई विकल्प नहीं चुनता है, तो सिर्फ़ खोज क्वेरी के लिए शुल्क लिया जाता है.
आइए, किसी ऐप्लिकेशन के नज़रिए से इवेंट के इस फ़्लो की जांच करें.
कोई उपयोगकर्ता "पेरिस, फ़्रांस" खोजने के लिए क्वेरी टाइप करना शुरू करता है.
उपयोगकर्ता के इनपुट का पता चलने पर, ऐप्लिकेशन एक नया सेशन टोकन, "टोकन A" बनाता है.
उपयोगकर्ता कुछ लिखते ही, एपीआई कुछ वर्ण लिखने के बाद अपने-आप भरने की सुविधा का अनुरोध करता है. साथ ही, हर वर्ण के लिए संभावित नतीजों की एक नई सूची दिखाता है:
"P"
"Par"
"Paris,"
"Paris, Fr"
जब उपयोगकर्ता कोई विकल्प चुनता है, तो:
क्वेरी से मिले सभी अनुरोधों को एक साथ ग्रुप किया जाता है और "टोकन A" से दिखाए गए सेशन में, एक अनुरोध के तौर पर जोड़ा जाता है.
उपयोगकर्ता के चुने गए विकल्प को जगह की जानकारी के अनुरोध के तौर पर गिना जाता है और "टोकन A" से दिखाए गए सेशन में जोड़ा जाता है.
सेशन खत्म हो जाता है और ऐप्लिकेशन "टोकन A" को खारिज कर देता है.
ऑटोकंप्लीट के अनुरोधों के लिए बिलिंग के तरीके के बारे में ज़्यादा जानने के लिए, इस्तेमाल और बिलिंग देखें.
[null,null,["आखिरी बार 2025-02-28 (UTC) को अपडेट किया गया."],[[["Session tokens are used to group autocomplete search queries and selections for billing purposes."],["Each session requires a unique token, ideally a version 4 UUID."],["Autocomplete requests are bundled and billed as a single request when a user makes a selection."],["If no selection is made, only the search query is charged after a few minutes."],["Session tokens can be shared across different Google Cloud projects, but must be unique within a single project."]]],["This document details the use of session tokens with the Places API. A session token groups a user's autocomplete search into a single session for billing. Users must create unique session tokens (version 4 UUIDs recommended) for each session, ensuring uniqueness within a project. Requests are bundled into a session. If a user selects a place, only the place details are charged; otherwise, only the search query is charged. Each session ends after a user's selection or inactivity, at which point the token is discarded.\n"]]