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