অবচয় এবং সূর্যাস্ত

নতুন সংস্করণ প্রকাশের সাথে সাথে, বাতিল করা সংস্করণটির একটি মেয়াদ শেষ হওয়ার তারিখ নির্ধারণ করা হয়, যার পরে সেই সংস্করণটি আর পাওয়া যাবে না। এখানে আরও কিছু নির্দেশিকা রয়েছে যা মনে রাখতে হবে:

  • আমরা যেকোনো সময়ে সর্বাধিক চারটি প্রধান সংস্করণ উপলব্ধ রাখার চেষ্টা করি।
  • প্রধান সংস্করণগুলোর মেয়াদ প্রায় ১২ মাস — অপ্রধান সংস্করণগুলোর মেয়াদ ১০ মাস।
  • আপনাকে প্রতি বছর সর্বোচ্চ দুটি আপগ্রেড করতে হবে, এবং আপনাকে কঠোরভাবে ক্রমানুসারে আপগ্রেড করতে হবে না—উদাহরণস্বরূপ, আপনি সংস্করণ (N) থেকে সরাসরি সংস্করণ (N+2)-এ আপগ্রেড করতে পারেন।
  • সর্বশেষ সংস্করণের জন্য সমস্ত ক্লায়েন্ট লাইব্রেরি প্রকাশের তারিখ এবং যে সংস্করণটি বন্ধ করা হবে, সেই তারিখের মধ্যে ব্যবধান কমপক্ষে ২০ সপ্তাহ।

আমাদের ক্লায়েন্ট লাইব্রেরিগুলো কোনো সার্ভিসের যেকোনো উপলব্ধ সংস্করণ সমর্থন করে, তাই আপনি ব্যবহৃত সার্ভিসগুলোর বিভিন্ন সংস্করণ নির্দিষ্ট করে পর্যায়ক্রমে আপগ্রেড করতে পারেন।

সময়সূচী

নিম্নলিখিত সারণীতে প্রতিটি উপলব্ধ সংস্করণের নির্দিষ্ট অবলুপ্তি এবং সমাপ্তির তারিখ, এবং ভবিষ্যৎ সংস্করণগুলির প্রত্যাশিত প্রকাশের তারিখ তালিকাভুক্ত করা হয়েছে। আমরা আপনাকে সর্বশেষ সংস্করণটি প্রকাশের পর যত তাড়াতাড়ি সম্ভব আপগ্রেড করার জন্য উৎসাহিত করি। অস্থায়ী তারিখটির অর্থ হলো, সমাপ্তিটি সেই মাসের যেকোনো সময় ঘটতে পারে এবং তারিখগুলি পরিবর্তিত হতে পারে। এপিআই সংস্করণ সমাপ্তির ঘোষণার অনুস্মারক পেতে ব্লগে সাবস্ক্রাইব করুন ।

এপিআই সংস্করণ মুক্তির তারিখ সূর্যাস্তের তারিখ আপগ্রেড গাইড
প্রকাশিত সংস্করণ
v20 ৪ জুন, ২০২৫ জুন ২০২৬ (সম্ভাব্য) v19 থেকে v20 তে আপগ্রেড করুন
v20.1 ৬ আগস্ট, ২০২৫ জুন ২০২৬ (সম্ভাব্য) v19 থেকে v20 তে আপগ্রেড করুন
v21 ৬ আগস্ট, ২০২৫ আগস্ট ২০২৬ (সম্ভাব্য) v20 থেকে v21 এ আপগ্রেড করুন
v22 ১৫ অক্টোবর, ২০২৫ অক্টোবর ২০২৬ (সম্ভাব্য) v21 থেকে v22-এ আপগ্রেড করুন
v23 ২৮ জানুয়ারী, ২০২৬ ফেব্রুয়ারী ২০২৭ v22 থেকে v23-এ আপগ্রেড করুন
আসন্ন সংস্করণগুলি
v23.1 ২৫শে ফেব্রুয়ারি, ২০২৬ ফেব্রুয়ারী ২০২৭ v23 থেকে v23.1-এ আপগ্রেড করুন
v23.2 ২৫ মার্চ, ২০২৬ ফেব্রুয়ারী ২০২৭ v23.1 থেকে v23.2-এ আপগ্রেড করুন
v24 এপ্রিল ২০২৬ মে ২০২৭
v24.1 মে ২০২৬ মে ২০২৭
v24.2 জুন ২০২৬ মে ২০২৭
v25 জুলাই ২০২৬ আগস্ট ২০২৭
v25.1 আগস্ট ২০২৬ আগস্ট ২০২৭
v25.2 সেপ্টেম্বর ২০২৬ আগস্ট ২০২৭
v26 অক্টোবর ২০২৬ নভেম্বর ২০২৭
v26.1* নভেম্বর ২০২৬ নভেম্বর ২০২৭

ছুটির মরসুমের সাথে সময়কাল মিলে যাওয়ায় v26.1-কে একটি ঐচ্ছিক রিলিজ হিসেবে চিহ্নিত করা হয়েছে।

আপনার প্রজেক্ট যে সংস্করণগুলো ব্যবহার করছে তা দেখুন

আপনার প্রজেক্ট সম্প্রতি যেসব মেথড ও সার্ভিস কল করেছে, তার একটি তালিকা আপনি গুগল ক্লাউড কনসোল ব্যবহার করে দেখতে পারেন:

  1. গুগল ক্লাউড কনসোলে এপিআই ও সার্ভিসগুলো খুলুন।
  2. টেবিলে থাকা Google Ads API-তে ক্লিক করুন।
  3. METRICS সাবট্যাবে, আপনি প্রতিটি গ্রাফে আপনার সাম্প্রতিক অনুরোধগুলো প্লট করা দেখতে পাবেন। Methods টেবিলে আপনি দেখতে পারেন কোন কোন মেথডে আপনি অনুরোধ পাঠিয়েছেন। মেথডের নামে একটি Google Ads API ভার্সন, একটি সার্ভিস এবং মেথডের নাম অন্তর্ভুক্ত থাকে, যেমন google.ads.googleads.v23.services.GoogleAdsService.Mutate ।
  4. (ঐচ্ছিক) আপনার অনুরোধগুলো দেখার জন্য পছন্দের সময়সীমা বেছে নিন।

অবমূল্যায়ন এবং সূর্যাস্তের মধ্যে পার্থক্য

মেয়াদ অবচয় সূর্যাস্ত
সংজ্ঞা অপ্রচলিত সংস্করণ হলো এমন একটি সংস্করণ যা সর্বশেষ নয় । নতুন কোনো সংস্করণ প্রকাশিত হলে, এর আগের সমস্ত সংস্করণকে অপ্রচলিত হিসেবে চিহ্নিত করা হবে। সানসেট সংস্করণটি আর ব্যবহার করা যাবে না । নির্ধারিত তারিখে বা তার পরে এই সংস্করণে পাঠানো অনুরোধগুলি ব্যর্থ হবে।
প্রভাব আপনি অপ্রচলিত সংস্করণগুলো বাতিল না হওয়া পর্যন্ত ব্যবহার করতে পারবেন, কিন্তু সেগুলো যে আর সর্বশেষ সংস্করণ নয়, তা বোঝানোর জন্য সেগুলোর রেফারেন্সের হাইলাইট তুলে দেওয়া হয়।

নতুন ফিচারগুলোর সুবিধা পেতে আমরা আপনাকে যত তাড়াতাড়ি সম্ভব সর্বশেষ সংস্করণে আপগ্রেড করার জন্য উৎসাহিত করছি।

 Google Ads API ব্যবহার করার জন্য আপনাকে অবিলম্বে সানসেট ভার্সনগুলো থেকে আপগ্রেড করতে হবে।

আমরা আপনাকে আপগ্রেড গাইড ব্যবহার করে সর্বশেষ সংস্করণে আপগ্রেড করার জন্য দৃঢ়ভাবে সুপারিশ করছি ।

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

আপনি আমাদের ক্লায়েন্ট লাইব্রেরি, REST ইত্যাদি ব্যবহার করে আমাদের API এন্ডপয়েন্টগুলো অ্যাক্সেস করতে পারেন; তবে, ডেপ্রিকেটেড ভার্সনগুলোতে নতুন ফিচার যোগ করা হয় না।

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

সমর্থিত ক্লায়েন্ট লাইব্রেরি সংস্করণ

সারণিটি দেখায় কোন ক্লায়েন্ট লাইব্রেরিগুলো কোন এপিআই সংস্করণগুলোর সাথে কাজ করে।

জাভা

জাভার জন্য ক্লায়েন্ট লাইব্রেরি
v23 Min: 42.1.0
Max: -
v22 Min: 41.1.0
Max: -
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: -

সি#

.NET এর জন্য ক্লায়েন্ট লাইব্রেরি
v23 Min: 25.1.0
Max: -
v22 Min: 24.1.0
Max: -
v21 Min: 24.0.0
Max: -
v20 Min: 23.0.0
Max: -

পিএইচপি

পিএইচপি-এর জন্য ক্লায়েন্ট লাইব্রেরি
v23 Min: 32.2.0
Max: -
v22 Min: 31.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 26.1.0
Max: -

পাইথন

পাইথনের জন্য ক্লায়েন্ট লাইব্রেরি
v23 Min: 29.2.0
Max: -
v22 Min: 28.1.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -

রুবি

রুবির জন্য ক্লায়েন্ট লাইব্রেরি
v23 Min: 38.0.0
Max: -
v22 Min: 36.0.0
Max: -
v21 Min: 35.0.0
Max: -
v20 Min: 34.0.0
Max: -

পার্ল

পার্লের জন্য ক্লায়েন্ট লাইব্রেরি
v23 Min: 31.0.0
Max: -
v22 Min: 29.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -

বৈশিষ্ট্য বাতিল

আসন্ন ফিচার বাতিলের খবর সবার আগে জানতে নিয়মিত গুগল অ্যাডস ডেভেলপার ব্লগ পর্যবেক্ষণ করুন।

নিম্নলিখিত সারণীতে গুগল অ্যাডস এপিআই-এর জন্য পরিকল্পিত নির্দিষ্ট ফিচারগুলো বাতিলের তালিকা দেওয়া হয়েছে। প্রতিটি বাতিলের বিষয়ে আরও বিস্তারিত তথ্য সংযুক্ত ব্লগ পোস্টগুলিতে পাওয়া যাবে।

বৈশিষ্ট্য বর্ণনা কার্যকর তারিখ অতিরিক্ত নোট
কাস্টমার ম্যাচ সাপোর্টে পরিবর্তন

১ এপ্রিল, ২০২৬ থেকে, যেসব ডেভেলপার টোকেনে সাম্প্রতিক কোনো কাস্টমার ম্যাচ অনুরোধ নেই, তাদের কাস্টমার ম্যাচ ওয়ার্কফ্লোর জন্য অবশ্যই ডেটা ম্যানেজার এপিআই ব্যবহার করতে হবে।

  • যদি আপনার ডেভেলপার টোকেন ১ অক্টোবর, ২০২৫ থেকে ৩১ মার্চ, ২০২৬-এর মধ্যে কাস্টমার ম্যাচ অডিয়েন্সের জন্য কোনো OfflineUserDataJobService বা UserDataService রিকোয়েস্ট পাঠিয়ে থাকে, তাহলে আপনি কাস্টমার ম্যাচ ওয়ার্কফ্লোর জন্য Google Ads API-এর সাথে আপনার ডেভেলপার টোকেন ব্যবহার করা চালিয়ে যেতে পারবেন। তবে, উন্নত ডেভেলপার অভিজ্ঞতা এবং অতিরিক্ত ফিচার ব্যবহারের সুযোগের জন্য আমরা আপনাকে আপনার কাস্টমার ম্যাচ ওয়ার্কফ্লোকে ডেটা ম্যানেজার API-তে আপগ্রেড করার পরামর্শ দিচ্ছি।
  • অন্যথায়, ১ এপ্রিল, ২০২৬ থেকে, কাস্টমার ম্যাচ অডিয়েন্সের জন্য যেকোনো OfflineUserDataJobService বা UserDataService অনুরোধ CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE ত্রুটির সাথে ব্যর্থ হবে। আপনার কাস্টমার ম্যাচ ওয়ার্কফ্লোর জন্য গুগল অ্যাডস এপিআই-এর পরিবর্তে ডেটা ম্যানেজার এপিআই ব্যবহার করুন ।
 ১ এপ্রিল, ২০২৬ আরও বিস্তারিত জানতে আমাদের ব্লগ পোস্টটি দেখুন।
আইপি ঠিকানা এবং সেশন অ্যাট্রিবিউট সমর্থনে পরিবর্তন ২ ফেব্রুয়ারি, ২০২৬ থেকে, গুগল অ্যাডস এপিআই কনভার্সন ইম্পোর্টের অংশ হিসেবে সেশন অ্যাট্রিবিউট বা আইপি অ্যাড্রেস ডেটার নতুন ব্যবহারকারীদের আর গ্রহণ করবে না। বিদ্যমান ব্যবহারকারীদের ডেটা ম্যানেজার এপিআই-তে স্থানান্তরিত হওয়া উচিত। ২ ফেব্রুয়ারি, ২০২৬ আরও বিস্তারিত জানতে আমাদের ব্লগ পোস্টটি দেখুন।
শুধুমাত্র কল বিজ্ঞাপনের অবচয় ২০২৬ সালের জানুয়ারি থেকে নতুন কল-অনলি বিজ্ঞাপন তৈরি করা যাবে না। বিদ্যমান কল-অনলি বিজ্ঞাপনগুলো ২০২৭ সালের ফেব্রুয়ারি থেকে দেখানো বন্ধ হয়ে যাবে এবং এপিআই (API) সাপোর্ট তুলে নেওয়া হবে। এর পরিবর্তে বিজ্ঞাপনদাতাদের কল অ্যাসেটসহ রেসপন্সিভ সার্চ অ্যাড ব্যবহার করা উচিত। জানুয়ারি ২০২৬ আরও বিস্তারিত জানতে আমাদের ব্লগ পোস্টটি দেখুন।