বিলিংয়ের উদ্দেশ্যে, ব্যবহারকারীর অটোকমপ্লিট সার্চের কোয়েরি ও বেছে নেওয়ার পর্যায়কে
একটি পৃথক সেশনে গ্রুপ করতে, Place Autocomplete (Legacy) সেশন টোকেন
ব্যবহার করে। ব্যবহারকারী কোয়েরি টাইপ করা শুরু করলে সেশন শুরু হয় এবং
তিনি কোনও জায়গা বেছে নিলে এবং Place Details (Legacy)-এ কল করা হলে সেশন শেষ হয়। প্রতিটি সেশনে
একাধিক অটোফিল কোয়েরি থাকতে পারে, তারপরে একটি জায়গা বেছে নেওয়া হয়। সেশনের মধ্যে প্রতিটি অনুরোধের জন্য ব্যবহৃত API
কী একই
Google Cloud কনসোল প্রোজেক্টের হতে হবে। সেশন শেষ হয়ে গেলে, টোকেন আর
বৈধ থাকে না; প্রতিটি সেশনের জন্য আপনার অ্যাপকে নতুন টোকেন তৈরি করতে হবে। sessiontoken প্যারামিটার বাদ দেওয়া হলে অথবা আপনি সেশন টোকেন আবার ব্যবহার করলে, সেশন টোকেন না দেওয়ার মতোই সেশনের জন্য চার্জ করা হয় (প্রতিটি অনুরোধের জন্য আলাদাভাবে বিল করা হয়)।
আমরা নিম্নলিখিত নির্দেশিকা সাজেস্ট করি:
- সব অটোমেটিক সম্পূর্ণ হওয়া সেশনের জন্য সেশন টোকেন ব্যবহার করুন।
- প্রতিটি সেশনের জন্য নতুন টোকেন জেনারেট করুন।
- নিশ্চিত করুন যে একটি সেশনের মধ্যে সমস্ত 'প্লেস অটোকমপ্লিট (Legacy)' এবং 'প্লেস বিবরণ (Legacy)' অনুরোধের জন্য ব্যবহৃত API কী একই Google Cloud কনসোল প্রোজেক্টের অন্তর্গত।
- প্রতিটি নতুন সেশনের জন্য একটি অনন্য সেশন টোকেন পাস করতে ভুলবেন না। একাধিক সেশনের জন্য একই টোকেন ব্যবহার করলে, প্রতিটি অনুরোধের জন্য আলাদাভাবে বিল করা হবে।
আপনি চাইলে অনুরোধ থেকে অটোমেটিক সম্পূর্ণ হওয়া সেশন টোকেন বাদ দিতে পারেন। সেশন টোকেন বাদ দেওয়া হলে, প্রতিটি অনুরোধের জন্য আলাদাভাবে বিল করা হয়, এর ফলে অটোফিল - প্রতি অনুরোধ SKU ট্রিগার হয়। আপনি কোনও সেশন টোকেন আবার ব্যবহার করলে, সেশনটি ভুল বলে বিবেচিত হবে এবং কোনও সেশন টোকেন প্রদান করা না হলে যেভাবে চার্জ করা হত, সেইভাবে অনুরোধের জন্য চার্জ করা হবে।
উদাহরণ
ব্যবহারকারী কোনও কোয়েরি টাইপ করার সময়, প্রতিটি কয়েক কীস্ট্রোক (প্রতিটি অক্ষরের জন্য নয়) পরে একটি অটোকমপ্লিট অনুরোধ কল করা হয় এবং সম্ভাব্য ফলাফলের একটি তালিকা রিটার্ন করা হয়। ব্যবহারকারী ফলাফল তালিকা থেকে কোনও বিকল্প বেছে নিলে, সেটি একটি অনুরোধ হিসেবে গণনা করা হয় এবং সার্চ করার সময় করা সব অনুরোধ একসাথে করে একটি অনুরোধ হিসেবে গণনা করা হয়। ব্যবহারকারী কোনও জায়গা বেছে নিলে, সার্চ কোয়েরি বিনা খরচে উপলভ্য হয় এবং শুধু জায়গার ডেটার জন্য চার্জ করা হয়। সেশন শুরু হওয়ার কয়েক মিনিটের মধ্যে ব্যবহারকারী কোনও নির্বাচন না করলে, শুধুমাত্র সার্চ কোয়েরির জন্য চার্জ করা হয়।
আসুন, অ্যাপের দৃষ্টিকোণ থেকে ইভেন্টের এই ফ্লো পরীক্ষা করে দেখা যাক।
- একজন ব্যবহারকারী "ফ্রান্সের প্যারিস" সার্চ করার জন্য কোয়েরি টাইপ করা শুরু করেছেন।
- ব্যবহারকারীর ইনপুট শনাক্ত করার পরে, অ্যাপ একটি নতুন সেশন টোকেন, "টোকেন A" তৈরি করে।
- ব্যবহারকারী টাইপ করার সাথে সাথে, API প্রতি কয়েক
টি অক্ষরের পরে একটি করে অটোফিল অনুরোধ করে এবং প্রতিটি অক্ষরের জন্য সম্ভাব্য ফলাফলের একটি নতুন তালিকা দেখায়:
"প"
"পার"
"প্যারিস,"
"প্যারিস, ফ্র"
- ব্যবহারকারী কোনও বিকল্প বেছে নিলে:
- কোয়েরির ফলে পাওয়া সব অনুরোধকে গ্রুপ করা হয় এবং "Token A"-এর মাধ্যমে দেখানো সেশনে একটি অনুরোধ হিসেবে যোগ করা হয়।
- ব্যবহারকারীর বেছে নেওয়াকে 'স্থান সম্পর্কিত বিবরণ' অনুরোধ হিসেবে গণ্য করা হয় এবং "Token A" দ্বারা প্রতিনিধিত্ব করা সেশনে যোগ করা হয়।
- সেশন শেষ হয়ে গেছে এবং অ্যাপ "Token A" বাতিল করে দেয়।
জায়গা অটোমেটিক সম্পূর্ণ করা (লিগ্যাসি) অনুরোধের জন্য কীভাবে বিল করা হয় সে সম্পর্কে আরও তথ্যের জন্য, দেখুন ব্যবহার এবং বিলিং।
সেশন টোকেন তৈরি করা
সেশন টোকেন তৈরি করতে, AutocompleteSessionToken.newInstance() কল করুন।