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