ক্লায়েন্ট আইডি মাইগ্রেশন গাইড

এক নজরে

গুরুত্বপূর্ণ: যাচাইকরণের নিরাপত্তা ও নির্ভরযোগ্যতা বাড়াতে, Maps Platform ক্লায়েন্ট আইডি ২৬ মে, ২০২৫ থেকে আর ব্যবহার করা হচ্ছে না এবং ৩১ মে, ২০২৬-এর পরে আর ব্যবহার করা যাবে না।
ক্লায়েন্ট আইডি ব্যবহার করার পরিবর্তে, আপনার Google Maps API পরিষেবা ট্রাফিক যাচাই করতে আপনাকে API কী ক্রেডেনশিয়াল ব্যবহার করতে হবে। এই গাইড আপনাকে দেখায় যে কীভাবে ক্লায়েন্ট আইডি ব্যবহার করা থেকে API কী ব্যবহার করার জন্য মাইগ্রেট করতে হয়।

শুরু করতে এই ধাপগুলি অনুসরণ করুন:

1. বর্তমান ক্লায়েন্ট আইডি ব্যবহার চেক করুন
2. API কী প্রস্তুত করা
3. কোটা সেটিংস পর্যালোচনা করুন
4. আপনার কোড আপডেট করুন
5. আপনার ক্লায়েন্ট আইডি ট্রাফিক মনিটর করা
6. আপনার ক্লায়েন্ট আইডি পজ করা
7. ক্লায়েন্ট আইডি সেল্ফ-সার্ভিস সাময়িক রিঅ্যাক্টিভেশন

বর্তমান ক্লায়েন্ট আইডি ব্যবহার চেক করা

মাইগ্রেশন প্রসেস শুরু করার আগে, নিম্নলিখিত বিষয়গুলি তালিকাভুক্ত করুন:

• Maps Platform পরিষেবা যার সাথে আপনি নিজের ক্লায়েন্ট আইডি ব্যবহার করছেন।
• আপনি যে অ্যাপ্লিকেশন, সাইট বা সিস্টেমের সাথে আপনার ক্লায়েন্ট আইডি ব্যবহার করছেন।

Google, ২০২৫ সালের মে মাসে ক্লায়েন্ট আইডি বন্ধ করে দেওয়ার ব্যাপারে প্রভাবিত গ্রাহকদের বিজ্ঞপ্তি সংক্রান্ত ইমেল পাঠিয়েছে। এছাড়াও, আপনি বিজ্ঞপ্তি ইমেলে এই তথ্য দেখতে পাবেন।

Cloud Console-এ, আপনি Google Maps মেট্রিক পৃষ্ঠা থেকে আপনার ক্লায়েন্ট আইডি ব্যবহারের লেটেস্ট স্ট্যাটাস চেক করতে পারবেন

Maps Platform পরিষেবার তালিকার জন্য:

1. Cloud Console-এ মেট্রিক পৃষ্ঠা খুলুন।
2. নিম্নলিখিত সেটিংসের মাধ্যমে আপনার ব্যবহার ফিল্টার করুন:
   • ক্রেডেনশিয়াল: শুধুমাত্র "project_number:<numerical identifier>" বেছে নিন।
3. নিম্নলিখিত ফিল্টার সেট করুন।
   • এইভাবে গ্রুপ করা হয়েছে: API

অ্যাপ্লিকেশন, সাইট বা সিস্টেমের ব্যাপারে ইঙ্গিত পেতে:

Cloud Console আপনার অ্যাপ্লিকেশন, সাইট বা সিস্টেমের বিবরণ দেখায় না। তবে, আপনার ক্লায়েন্ট আইডি ট্রাফিকের সোর্স সম্পর্কে কিছু ইঙ্গিত পেতে পারেন। এইসব ধাপ অনুসরণ করুন:

1. Cloud Console-এ মেট্রিক্স পৃষ্ঠা খুলুন।
2. ড্রপ-ডাউন থেকে Maps Platform পরিষেবা বেছে নিন।
3. নিম্নলিখিত সেটিংসের মাধ্যমে আপনার ব্যবহার ফিল্টার করুন:
   • ক্রেডেনশিয়াল: শুধুমাত্র "project_number:<numerical identifier>" বেছে নিন।
4. নিচের ফিল্টার সেট করুন।
   • এইভাবে গ্রুপ করুন: প্ল্যাটফর্ম বা ডোমেন
5. আপনি যে Maps Platform পরিষেবার ট্রাফিক চেক করতে চান, সেটির জন্য ২ নম্বর ধাপ থেকে শুরু করে প্রক্রিয়াটি আবার করুন।

API কী প্রস্তুত করা

সব ক্লায়েন্ট আইডি Google Cloud প্রোজেক্টের সাথে যুক্ত থাকে এবং সেই প্রোজেক্ট থেকে API কী ব্যবহার করলে, আপনি সেইসব ফিচার অ্যাক্সেস করতে পারবেন যেগুলি আগে আপনার ক্লায়েন্ট আইডি দিয়ে অ্যাক্সেস করেছেন। কোটা সংক্রান্ত সমস্যা বা ফিচার মিস করা এড়াতে, আমরা সংশ্লিষ্ট প্রোজেক্টে মাইগ্রেট করার সাজেশন দিই।

1. আপনার ক্লায়েন্ট আইডি যে ক্লাউড প্রোজেক্টের সাথে লিঙ্ক করা আছে সেটি খুঁজুন:
   • পোর্টাল মাইগ্রেশন সংক্রান্ত প্রায়শই জিজ্ঞাসিত প্রশ্ন
2. আপনার Cloud Project খোলা বিলিং অ্যাকাউন্টের সাথে লিঙ্ক করা আছে কিনা তা ভালভাবে দেখে নিন।
3. ক্লায়েন্ট আইডি মাইগ্রেশনের জন্য নতুন API কী তৈরি করুন।
   • আপনি Cloud Project-এ আগে থেকে থাকা যেকোনও API কী আবার ব্যবহার করতে পারবেন।
   • আপনি একই Cloud Project থেকে একাধিক API কী ব্যবহার করতে পারেন, যেমন, প্রতিটি Maps Platform পরিষেবার জন্য ট্রাফিক আলাদা করতে অথবা বিভিন্ন প্ল্যাটফর্ম (ব্রাউজার, মোবাইল অ্যাপ ইত্যাদি) থেকে ট্রাফিক আলাদা করতে। API key ম্যানেজমেন্টের পেশাদার পদ্ধতি সম্পর্কে জানতে নিরাপত্তা নির্দেশিকা দেখুন।

আপনার API key সুরক্ষিত করুন

অননুমোদিত অ্যাক্সেস থেকে আপনার API key সুরক্ষিত রাখতে ভুলবেন না।

• আপনার API কী-এর জন্য অ্যাপ্লিকেশন বিধিনিষেধ সেট করুন (যেমন, ওয়েবসাইট, IP অ্যাড্রেস, Android অ্যাপ বা iOS অ্যাপ)।
• আপনার API key-এর জন্য API বিধিনিষেধ সেট করুন।

আরও বিবরণের জন্য Google Maps Platform সুরক্ষা সংক্রান্ত নির্দেশিকা দেখুন।

Maps JavaScript API, Maps Static API এবং Street View Static API-এর জন্য, আপনি API key বিধিনিষেধের ক্ষেত্রে আপনার ক্লায়েন্ট আইডিতে বিশ্বস্ত রেফারার মাইগ্রেট করতে পারবেন। আপনি Cloud Console-এ বিশ্বস্ত রেফারারদের তালিকা দেখতে পাবেন।

কোটা সেটিংস পর্যালোচনা করুন

আপনার Cloud প্রোজেক্টে প্রত্যাশিত কোটা সেটিংস আছে কিনা তা নিশ্চিত করুন। আপনি ক্লায়েন্ট আইডি থেকে Maps JavaScript API ক্লায়েন্ট-সাইড পরিষেবা কল করলে তবেই আপনাকে এটি করতে হবে। আপনি Google Maps কোটা পৃষ্ঠা থেকে কোটা সেটিংস চেক ও অ্যাডজাস্ট করতে পারবেন।

কোটা রিপোর্ট সম্পর্কে আরও জানুন

Maps JavaScript API ক্লায়েন্ট-সাইড পরিষেবার জন্য কোটা বৃদ্ধি

সতর্কতা: Maps JavaScript API ক্লায়েন্ট-সাইড পরিষেবায় ক্লায়েন্ট আইডি ব্যবহার করলে প্রোজেক্ট কোটা খরচ হয় না। API key-তে মাইগ্রেট করার পরে, আপনার ব্যবহার প্রোজেক্ট কোটা ব্যবহার করবে। মাইগ্রেট করার আগে আপনার কাছে পর্যাপ্ত কোটা হেডরুম আছে কিনা তা নিশ্চিত করতে হবে।

আপনি Maps JavaScript API-তে নিম্নলিখিত পরিষেবা ব্যবহার করলে, API কী মাইগ্রেশনের পরে কোটা ব্যবহারের পরিমাণ বৃদ্ধি দেখতে পাবেন।

আপনার বর্তমান কোটা কনফিগারেশন, বর্তমান ব্যবহার পর্যালোচনা করুন এবং সেই অনুযায়ী আপনার কোটা সীমা অ্যাডজাস্ট করুন।

1. আপনি ক্লায়েন্ট আইডি সহ Maps JavaScript API ক্লায়েন্ট-সাইড পরিষেবা ব্যবহার করছেন কিনা তা চেক করুন।
   • Cloud Console-এ মেট্রিক পৃষ্ঠা খুলুন।
   • নিম্নলিখিত সেটিংসের মাধ্যমে আপনার ব্যবহার ফিল্টার করুন:
     • গ্রুপ করা হয়েছে: API পদ্ধতি
     • ক্রেডেনশিয়াল: শুধুমাত্র "project_number:<numerical identifier>" বেছে নিন।
   • তারপরে, আপনি "API পদ্ধতি অনুযায়ী ট্রাফিক" চার্টে পদ্ধতির নামের একটি তালিকা সহ এর ট্রাফিক দেখতে পাবেন।

API পদ্ধতি	ক্লায়েন্ট-সাইড পরিষেবা	কোটা অ্যাডজাস্ট করার পরিষেবা
google.routes.Directions.Javascript	দিকনির্দেশ পরিষেবা	Directions API
google.routes.DistanceMatrix.Javascript	Distance Matrix Service	Distance Matrix API
google.maps.Elevation.Javascript	উচ্চতা সংক্রান্ত পরিষেবা	Elevation API
google.places.Geocoding.Javascript	Geocoding Service	Geocoding API
google.places.*.Javascript, google.places.Geocoding.Javascript ছাড়া অন্য কিছু	জায়গার লাইব্রেরি	Places API

• আপনি যদি সেইসব API পদ্ধতি ব্যবহার না করেন, তাহলে আপনাকে কোটা সেটিংস সম্পর্কে চিন্তা করতে হবে না, কারণ আপনার ক্লায়েন্ট আইডি ট্রাফিক ইতিমধ্যেই আপনার প্রোজেক্ট কোটা ব্যবহার করে।
• আপনার ক্লায়েন্ট আইডি কোটা ব্যবহার অনুমান করা
  • প্রতিটি পরিষেবার জন্য, প্রতি সেকেন্ড এবং প্রতি দিনের গ্র্যানুলারিটি চেক করুন।
  • প্রতি সেকেন্ডের গ্রাফ: অতিরিক্ত কোটা প্রতি মিনিটের প্রয়োজনীয়তার জন্য পিক ট্রাফিককে ৬০ দিয়ে গুণ করুন।
  • প্রতিদিনের গ্রাফ: সর্বাধিক ট্রাফিক প্রতিদিনের অতিরিক্ত কোটার প্রয়োজনীয়তার সমান হতে হবে।
• সংশ্লিষ্ট Maps Platform পরিষেবায় আপনার কোটা অ্যাডজাস্ট করুন
  • ১ম ধাপে আপনি যে পদ্ধতির নাম খুঁজে পাবেন তার ভিত্তিতে, সংশ্লিষ্ট পরিষেবায় কোটা অ্যাডজাস্ট করুন।

আপনার কোড আপডেট করা

কী প্যারামিটারের সাথে ক্লায়েন্ট প্যারামিটার পরিবর্তন করুন

আপনার আউটগোয়িং GMP API কলে URL&client={value} থেকে URL&key={value}-এ যাচাইকরণ ক্রেডেনশিয়াল আপডেট করুন। আপনার অ্যাপ যদি HTTP ব্যবহার করে GMP পরিষেবা অ্যাক্সেস করে, তাহলে HTTPS ব্যবহার করার জন্য সেগুলি আপডেট করুন।

রিপোর্টিংয়ের জন্য চ্যানেল প্যারামিটার আপডেট করা

আপনার API অনুরোধে চ্যানেল প্যারামিটার নির্দিষ্ট করে প্রতিটি চ্যানেলের জন্য আপনার ব্যবহার ট্র্যাক করতে পারবেন। API কী শুধুমাত্র চ্যানেল প্যারামিটারের জন্য সংখ্যাসূচক মান সমর্থন করে। আপনি যদি চ্যানেল প্যারামিটারের জন্য কোনও সংখ্যাসূচক মান ছাড়া আপনার ক্লায়েন্ট আইডি ব্যবহার করেন, তাহলে এটিকে একটি সংখ্যাসূচক মান দিয়ে আপডেট করুন যা কাজ করে।

আরও তথ্যের জন্য Google Maps Platform রিপোর্টিং দেখুন।

ওয়েব পরিষেবার জন্য সিগনেচার প্যারামিটার সরানো

নিম্নলিখিত ওয়েব সার্ভিস API-এর ক্ষেত্রে, আপনি API 'কী' দিয়ে অ্যাক্সেস করলে সিগনেচার প্যারামিটার প্রয়োজন হয় না। আপনার API অনুরোধ থেকে শুধু সিগনেচার প্যারামিটার সরিয়ে দিন।

• Directions API (Legacy)
• Distance Matrix API (Legacy)
• Geocoding API
• Elevation API
• Time Zone API

আরও তথ্যের জন্য Premium প্ল্যানের ওভারভিউ দেখুন।

Imagery API-এর জন্য সাইনিং সিক্রেট

Maps Static API এবং Street View Static API-এর জন্য এখনও সিগনেচার প্যারামিটার প্রয়োজন। পরীক্ষার উদ্দেশ্যে তারা স্বাক্ষর ছাড়া অল্প সংখ্যক অনুরোধ গ্রহণ করে তবে প্রোডাকশনে থ্রেশহোল্ডে পৌঁছে গেলে সেগুলি প্রত্যাখ্যান করা শুরু করে। ক্লায়েন্ট আইডির জন্য ব্যবহৃত সাইনিং সিক্রেটটি API কী-এর জন্য ব্যবহৃত সাইনিং সিক্রেট দিয়ে পরিবর্তন করুন। আপনি একই সাইনিং অ্যালগরিদম ব্যবহার করতে পারবেন, তবে আপনাকে অন্য সাইনিং সিক্রেট ব্যবহার করতে হবে। আরও জানতে, ডিজিটাল স্বাক্ষর ব্যবহার করুন দেখুন।

সতর্কতা: প্রোডাকশনে কোড পরিবর্তন ডিপ্লয় করার আগে, যাচাই করে নিন যে এন্ড-টু-এন্ড কার্যকারিতা প্রভাবিত হয়নি।

আপনার ক্লায়েন্ট আইডি ট্রাফিক মনিটর করা

ডেপ্লয়মেন্টের পরে, Cloud Console ড্যাশবোর্ড ব্যবহার করে আপনার ট্রাফিক সফলভাবে মাইগ্রেট হয়েছে কিনা তা কনফার্ম করুন। আপনি ক্লায়েন্ট আইডি ট্রাফিকে হ্রাস দেখতে পাবেন, যা ক্রেডেনশিয়াল অনুযায়ী গ্রুপ করার সময় ড্যাশবোর্ডে "project_number:123456" ফর্ম্যাটে দেখানো হয়।

আপনার ক্লায়েন্ট আইডি পজ করা

আমরা বিশেষভাবে সাজেস্ট করি যে ডেভেলপাররা মাইগ্রেশনের পরে ক্লায়েন্ট আইডি পজ করে দেবেন। এটি আপনার ক্রেডেনশিয়ালকে কোনও অবাঞ্ছিত ট্রাফিক থেকে রক্ষা করতে এবং এটি নিশ্চিত করতে যে আপনার ক্লায়েন্ট আইডিতে অবশিষ্ট ব্যবহার কোনও গুরুতর বিষয় নয় (যেমন, টেস্টিং, ক্যাশে, বট, …) এবং ব্যবসায়িক প্রভাব না ফেলেই এর ফলে এরর দেখানো যেতে পারে। আপনি Cloud Console-এ ক্লায়েন্ট আইডি পজ করতে পারবেন। আরও বিবরণের জন্য Premium প্ল্যান যাচাইকরণ ওভারভিউ দেখুন।

ক্লায়েন্ট আইডি সেল্ফ-সার্ভিস সাময়িক রিঅ্যাক্টিভেশন

Google Maps Platform ক্লায়েন্ট আইডি মে ২০২৬-এ ফেজড ডেপ্রিকেশন পিরিয়ডে প্রবেশ করার ফলে, পরিষেবা উপলভ্যতার ব্যাপারে আর নিশ্চিত হওয়া যাচ্ছে না। শিডিউল করা পরিষেবা বন্ধ করার প্রসেসের অংশ হিসেবে, অ্যাক্সেস মাঝে মাঝে সীমাবদ্ধ করা হবে। সাধারণত কয়েক ঘণ্টার মধ্যে পরিষেবা অটোমেটিক রিস্টোর হয়ে গেলেও, অবিলম্বে রিস্টোর করার প্রয়োজন হলে, আপনি ম্যানুয়ালি অ্যাক্সেস আবার অ্যাক্টিভেট করার বিকল্প বেছে নিতে পারেন।

জরুরি ভিত্তিতে অ্যাক্সেস ফিরিয়ে আনতে, আপনি Google Cloud Console-এর মাধ্যমে স্ব-পরিষেবা রিয়্যাক্টিভেশন করতে পারেন:

• Google Maps Platform ক্রেডেনশিয়াল পৃষ্ঠায় নেভিগেট করুন।
• আপনার ক্লায়েন্ট আইডির সাথে লিঙ্ক করা নির্দিষ্ট ক্লাউড প্রোজেক্টটি খুঁজে নিন।
• পরিষেবা ফিরিয়ে আনতে এন্ট্রির একদম ডানদিকে থাকা 'আনপজ করুন' আইকনে ক্লিক করুন।

মনে রাখবেন: চূড়ান্ত বন্ধ করার তারিখ যত এগিয়ে আসবে, এই পরিষেবা বাধা পাওয়ার ঘটনা তত বেশি ঘন ঘন এবং দীর্ঘ সময় ধরে ঘটবে। পরিষেবা যাতে নিরবচ্ছিন্নভাবে চলে তা নিশ্চিত করতে, আমরা যত তাড়াতাড়ি সম্ভব API কী যাচাইকরণে মাইগ্রেট করার জন্য জোরালোভাবে সাজেস্ট করি।

আপনি যদি API কী-তে দ্রুত মাইগ্রেট করতে না পারেন এবং সাময়িকভাবে আরও বাধা থেকে অব্যাহতি পেতে চান, তাহলে নিম্নলিখিত বিবরণ সহ Google Maps Platform সহায়তা টিমের সাথে যোগাযোগ করুন:

• ক্লায়েন্ট ID
• নির্দিষ্ট ব্যবহারের উদাহরণ
• মাইগ্রেশনের টার্গেট তারিখ
• ব্যবসার উপর প্রভাবের মূল্যায়ন

ক্লায়েন্ট আইডি ব্যবহার সংক্রান্ত রিপোর্ট - বিলিং রিপোর্ট থেকে

প্রোজেক্ট মেট্রিক্সের পরিবর্তে বিলিং রিপোর্ট চেক করা সেইসব ব্যবহারকারীর জন্য উপযোগী হতে পারে যাদের প্রোজেক্ট মেট্রিক্সে অ্যাক্সেস নেই—যেমন, বিলিং অ্যাডমিনিস্ট্রেটর (বিশেষ করে Maps Platform পার্টনার)। বিলিং রিপোর্টে ১-২ দিনের লেটেন্সি থাকলেও, এতে ৩০ দিনের বেশি সময়ের ব্যবহার ও খরচ সংক্রান্ত ইনসাইট দেখানোর সুবিধা আছে।

আপনি Google Cloud Console-এর মাধ্যমে ক্লায়েন্ট আইডি ব্যবহার মনিটর করতে পারবেন। এর জন্য এইসব ধাপ অনুসরণ করুন:

1. Google Cloud Console-এ বিলিং > রিপোর্ট পৃষ্ঠায় যান।
2. (ঐচ্ছিক, শুধুমাত্র পার্টনারদের জন্য প্রাসঙ্গিক) পছন্দসই সাব-বিলিং অ্যাকাউন্ট বেছে নিতে ফিল্টার প্রয়োগ করুন।
3. লেবেল কী goog-maps-api-key-suffix অনুযায়ী রিপোর্টের ডেটা গ্রুপ করুন। এই লেবেলে API 'কী'-এর ট্রেলিং অক্ষর দেখানো হয়।
4. যেসব এন্ট্রিতে goog-maps-api-key-suffix লেবেল নেই বা খালি আছে সেগুলি খুঁজে ক্লায়েন্ট আইডি ট্রাফিক শনাক্ত করুন, কারণ ক্লায়েন্ট আইডি অনুরোধের জন্য এই লেবেল পূরণ করা হয় না।
5. API অনুরোধের সাথে যুক্ত করার জন্য নয় এমন SKU উপেক্ষা করুন—যেমন, সাবস্ক্রিপশন SKU।

সমস্যার সমাধান

আমাদের অনুরোধ ব্যর্থ হচ্ছে কিনা তা আমরা কীভাবে দেখতে পারি?

আপনি রেসপন্স কোড গ্রাফ থেকে আপনার সমস্যার পরিসংখ্যান চেক করতে পারবেন

ApiNotActivatedMapError বা REQUEST_DENIED সমস্যা

আপনি Cloud প্রোজেক্টে পরিষেবা চালু না করলে, ApiNotActivatedMapError বা REQUEST_DENIED সমস্যা দেখতে পাবেন। পরিষেবা চালু করতে নির্দেশাবলী অনুসরণ করুন।

RefererNotAllowedMapErrorটি সমস্যা

আপনার সোর্স ডোমেন API কী-তে যোগ করা না থাকলে, আপনি RefererNotAllowedMapError দেখতে পাবেন। "আপনার API key সুরক্ষিত করুন" বিভাগটি চেক করুন এবং API key-তে আপনার ডোমেন যোগ করুন।

OverQuotaMapError বা OVER_QUERY_LIMIT সমস্যা

আপনার কনফিগার করা কোটা ট্রাফিক কভার করার জন্য যথেষ্ট না হলে, আপনি OverQuotaMapError বা OVER_QUERY_LIMIT দেখতে পাবেন। "কোটা সেটিংস পর্যালোচনা করুন" বিভাগ চেক করে সেই অনুযায়ী কোটা অ্যাডজাস্ট করুন।

"এই API-তে করা অনুরোধ SSL-এর মাধ্যমে হতে হবে" সমস্যা

আপনি যদি নিম্নলিখিত সমস্যার মেসেজ পান, তাহলে আপনার API অনুরোধগুলি "http://" থেকে "https://"-এ আপডেট করুন।

{
  "error_message" : "Requests to this API must be over SSL. Load the API with
  \"https://\" instead of \"http://\".",

  "results" : [],

  "status" : "REQUEST_DENIED"
}