নতুন সংস্করণ প্রকাশের সাথে সাথে, বাতিল করা সংস্করণটির একটি মেয়াদ শেষ হওয়ার তারিখ নির্ধারণ করা হয়, যার পরে সেই সংস্করণটি আর পাওয়া যাবে না। এখানে আরও কিছু নির্দেশিকা রয়েছে যা মনে রাখতে হবে:
- আমরা যেকোনো সময়ে সর্বাধিক পাঁচটি প্রধান সংস্করণ উপলব্ধ রাখার চেষ্টা করি।
- প্রধান সংস্করণগুলোর মেয়াদ প্রায় ১২ মাস — অপ্রধান সংস্করণগুলোর মেয়াদ ১০ মাস।
- আপনাকে প্রতি বছর সর্বোচ্চ দুটি আপগ্রেড করতে হবে, এবং আপনাকে কঠোরভাবে ক্রমানুসারে আপগ্রেড করতে হবে না — উদাহরণস্বরূপ, আপনি সংস্করণ (N) থেকে সরাসরি সংস্করণ (N+2)-এ আপগ্রেড করতে পারেন।
আমাদের ক্লায়েন্ট লাইব্রেরিগুলো কোনো সার্ভিসের যেকোনো উপলব্ধ সংস্করণ সমর্থন করে, তাই আপনি ব্যবহৃত সার্ভিসগুলোর বিভিন্ন সংস্করণ নির্দিষ্ট করে পর্যায়ক্রমে আপগ্রেড করতে পারেন।
সময়সূচী
নিম্নলিখিত সারণীতে প্রতিটি উপলব্ধ সংস্করণের নির্দিষ্ট অবলুপ্তি এবং সমাপ্তির তারিখ, এবং ভবিষ্যৎ সংস্করণগুলির প্রত্যাশিত প্রকাশের তারিখ তালিকাভুক্ত করা হয়েছে। আমরা আপনাকে সর্বশেষ সংস্করণটি প্রকাশের পর যত তাড়াতাড়ি সম্ভব আপগ্রেড করার জন্য উৎসাহিত করি। অস্থায়ী তারিখটির অর্থ হলো, সমাপ্তিটি সেই মাসের যেকোনো সময় ঘটতে পারে এবং তারিখগুলি পরিবর্তিত হতে পারে। এপিআই সংস্করণ সমাপ্তির ঘোষণার অনুস্মারক পেতে ব্লগে সাবস্ক্রাইব করুন ।
| API version | মুক্তির তারিখ | Sunset date | Upgrade guide |
|---|---|---|---|
| প্রকাশিত সংস্করণ | |||
| v22 | ১৫ অক্টোবর, ২০২৫ | October 2026 (tentative) | v21 থেকে v22-এ আপগ্রেড করুন |
| v23 | ২৮ জানুয়ারী, ২০২৬ | ফেব্রুয়ারী ২০২৭ | v22 থেকে v23-এ আপগ্রেড করুন |
| v23.1 | ২৫শে ফেব্রুয়ারি, ২০২৬ | ফেব্রুয়ারী ২০২৭ | v23 থেকে v23.1-এ আপগ্রেড করুন |
| v23.2 | ২৫ মার্চ, ২০২৬ | ফেব্রুয়ারী ২০২৭ | Upgrade from v23.1 to v23.2 |
| v24 | ২২ এপ্রিল, ২০২৬ | মে ২০২৭ | Upgrade from v23.2 to v24 |
| v24.1 | May 13, 2026 | মে ২০২৭ | v24 থেকে v24.1-এ আপগ্রেড করুন |
| v24.2 | ২৪ জুন, ২০২৬ | জুন ২০২৭ | Upgrade from v24.1 to v24.2 |
| v25 | ২২ জুলাই, ২০২৬ | আগস্ট ২০২৭ | v24.2 থেকে v25 এ আপগ্রেড করুন |
| আসন্ন সংস্করণগুলি | |||
| v25.1 | আগস্ট ২০২৬ | আগস্ট ২০২৭ | |
| v25.2 | সেপ্টেম্বর ২০২৬ | আগস্ট ২০২৭ | |
| v26 | অক্টোবর ২০২৬ | নভেম্বর ২০২৭ | |
| v26.1* | নভেম্বর ২০২৬ | নভেম্বর ২০২৭ | |
ছুটির মরসুমের সাথে সময়কাল মিলে যাওয়ায় v26.1-কে একটি ঐচ্ছিক রিলিজ হিসেবে চিহ্নিত করা হয়েছে।
আপনার প্রজেক্ট যে সংস্করণগুলো ব্যবহার করছে তা দেখুন
আপনার প্রজেক্ট সম্প্রতি যেসব মেথড ও সার্ভিস কল করেছে, তার একটি তালিকা আপনি গুগল ক্লাউড কনসোল ব্যবহার করে দেখতে পারেন:
- গুগল ক্লাউড কনসোলে এপিআই ও সার্ভিসগুলো খুলুন।
- টেবিলে থাকা Google Ads API-তে ক্লিক করুন।
- METRICS সাবট্যাবে, আপনি প্রতিটি গ্রাফে আপনার সাম্প্রতিক অনুরোধগুলো প্লট করা দেখতে পাবেন। Methods টেবিলে আপনি দেখতে পারেন কোন কোন মেথডে আপনি অনুরোধ পাঠিয়েছেন। মেথডের নামে একটি Google Ads API ভার্সন, একটি সার্ভিস এবং মেথডের নাম অন্তর্ভুক্ত থাকে, যেমন
google.ads.googleads.v25.services.GoogleAdsService.Mutate। - (ঐচ্ছিক) আপনার অনুরোধগুলো দেখার জন্য পছন্দের সময়সীমা বেছে নিন।
অবমূল্যায়ন এবং সূর্যাস্তের মধ্যে পার্থক্য
| মেয়াদ | অবচয় | সূর্যাস্ত |
|---|---|---|
| সংজ্ঞা | অপ্রচলিত সংস্করণ হলো এমন একটি সংস্করণ যা সর্বশেষ নয় । নতুন কোনো সংস্করণ প্রকাশিত হলে, এর আগের সমস্ত সংস্করণকে অপ্রচলিত হিসেবে চিহ্নিত করা হবে। | সানসেট সংস্করণটি আর ব্যবহার করা যাবে না । নির্ধারিত তারিখে বা তার পরে এই সংস্করণে পাঠানো অনুরোধগুলি ব্যর্থ হবে। |
| প্রভাব | আপনি অপ্রচলিত সংস্করণগুলো বাতিল না হওয়া পর্যন্ত ব্যবহার করতে পারবেন, কিন্তু সেগুলো যে আর সর্বশেষ সংস্করণ নয়, তা বোঝানোর জন্য সেগুলোর রেফারেন্সের হাইলাইট তুলে দেওয়া হয়। নতুন ফিচারগুলোর সুবিধা পেতে আমরা আপনাকে যত তাড়াতাড়ি সম্ভব সর্বশেষ সংস্করণে আপগ্রেড করার জন্য উৎসাহিত করছি। | Google Ads API ব্যবহার করার জন্য আপনাকে অবিলম্বে সানসেট ভার্সনগুলো থেকে আপগ্রেড করতে হবে। আমরা আপনাকে আপগ্রেড গাইড ব্যবহার করে সর্বশেষ সংস্করণে আপগ্রেড করার জন্য দৃঢ়ভাবে সুপারিশ করছি । |
| সময় | গড়ে আমরা প্রতি ৩ থেকে ৪ মাস অন্তর একটি নতুন সংস্করণ প্রকাশ করি, তাই প্রদত্ত সংস্করণটি আনুমানিক ৩ থেকে ৪ মাস পর অপ্রচলিত হয়ে যাবে। | আমাদের লক্ষ্য হলো কোনো সংস্করণ প্রকাশের এক বছর পর সেটির কার্যক্রম বন্ধ করে দেওয়া। |
| এপিআই | বাতিল করা সংস্করণগুলির এপিআই এন্ডপয়েন্টগুলি এখনও যথারীতি কাজ করছে । আপনি আমাদের ক্লায়েন্ট লাইব্রেরি এবং REST ব্যবহার করে আমাদের API এন্ডপয়েন্টগুলো অ্যাক্সেস করতে পারেন। তবে, ডেপ্রিকেটেড ভার্সনগুলোতে নতুন ফিচার যোগ করা হয় না। | সানসেট ভার্সনগুলোর এপিআই এন্ডপয়েন্টগুলো নির্দিষ্ট তারিখের পর কাজ করা বন্ধ করে দেয় । আপনি যদি সানসেট ভার্সনগুলোর এপিআই এন্ডপয়েন্টগুলো অ্যাক্সেস করার চেষ্টা করেন, তাহলে গুগল অ্যাডস এপিআই একটি এরর দেখাবে। |
| ক্লায়েন্ট লাইব্রেরি | কমপ্যাক্ট ক্লায়েন্ট লাইব্রেরি প্রদানের উদ্দেশ্যে, আমরা বাতিলের তারিখের পর নতুন ক্লায়েন্ট লাইব্রেরি সংস্করণে অপ্রচলিত API সংস্করণগুলো অন্তর্ভুক্ত করা বন্ধ করে দেব । এটি আপনার প্রোজেক্টে আমাদের ক্লায়েন্ট লাইব্রেরিগুলো অন্তর্ভুক্ত করার সময় স্থান বাঁচাতে সাহায্য করে। | নির্ধারিত তারিখের পর ক্লায়েন্ট লাইব্রেরির কোনো নতুন সংস্করণে, সেই বাতিল হওয়া এপিআই সংস্করণগুলো আর সমর্থিত হবে না । |
| সমর্থন | আমরা অপ্রচলিত সংস্করণগুলোর জন্য নিয়মিত সহায়তা প্রদান করে থাকি। | নির্ধারিত তারিখের পর সানসেট সংস্করণগুলো আর সমর্থিত হবে না । |
সমর্থিত ক্লায়েন্ট লাইব্রেরি সংস্করণ
সারণিটি দেখায় কোন ক্লায়েন্ট লাইব্রেরিগুলো কোন এপিআই সংস্করণগুলোর সাথে কাজ করে।
তালিকাভুক্ত সর্বনিম্ন ক্লায়েন্ট লাইব্রেরি সংস্করণটি গুগল অ্যাডস এপিআই-এর প্রধান রিলিজের (যেমন v25) জন্য যথেষ্ট। ছোটখাটো রিলিজগুলোর জন্য প্রয়োজনীয় ক্লায়েন্ট লাইব্রেরি সংস্করণ জানতে, লিঙ্ক করা চেঞ্জলগটি দেখুন।
জাভা
গুগল অ্যাডস এপিআই | জাভার জন্য ক্লায়েন্ট লাইব্রেরি |
v25 | Min: 44.0.0Max: - |
v24 | Min: 43.0.0Max: - |
v23 | Min: 42.0.0Max: - |
v22 | Min: 41.0.0Max: - |
সি#
গুগল অ্যাডস এপিআই | .NET এর জন্য ক্লায়েন্ট লাইব্রেরি |
v25 | Min: 26.1.0Max: - |
v24 | Min: 25.3.0Max: - |
v23 | Min: 25.1.0Max: - |
v22 | Min: 24.1.0Max: - |
পিএইচপি
গুগল অ্যাডস এপিআই | পিএইচপি-এর জন্য ক্লায়েন্ট লাইব্রেরি |
v25 | Min: 33.6.0Max: - |
v24 | Min: 33.3.0Max: - |
v23 | Min: 32.2.0Max: - |
v22 | Min: 31.0.0Max: - |
পাইথন
গুগল অ্যাডস এপিআই | পাইথনের জন্য ক্লায়েন্ট লাইব্রেরি |
v25 | Min: 31.2.0Max: - |
v24 | Min: 30.1.0Max: - |
v23 | Min: 29.2.0Max: - |
v22 | Min: 28.1.0Max: - |
রুবি
গুগল অ্যাডস এপিআই | রুবির জন্য ক্লায়েন্ট লাইব্রেরি |
v25 | Min: 43.0.0Max: - |
v24 | Min: 40.0.0Max: - |
v23 | Min: 38.0.0Max: - |
v22 | Min: 36.0.0Max: - |
পার্ল
গুগল অ্যাডস এপিআই | পার্লের জন্য ক্লায়েন্ট লাইব্রেরি |
v25 | Min: 33.0.0Max: - |
v24 | Min: 32.0.0Max: - |
v23 | Min: 31.0.0Max: - |
v22 | Min: 29.0.0Max: - |
বৈশিষ্ট্য বাতিল এবং পরিবর্তন
যদিও এই পৃষ্ঠাটি এপিআই ভার্সন-ভিত্তিক জীবনচক্রের উপর আলোকপাত করে, স্বতন্ত্র ফিচারের অবলুপ্তি (যেমন স্মার্ট ক্যাম্পেইনের অবলুপ্তি) এবং ভার্সনবিহীন ওয়ার্কফ্লো পরিবর্তন (যেমন নতুন ডিমান্ড জেন ক্যাম্পেইনের বাজেট সংক্রান্ত প্রয়োজনীয়তা) আলাদাভাবে ট্র্যাক করা হয়।
সক্রিয় সংস্করণগুলোতে আসন্ন ফিচারের জীবনচক্র এবং আচরণগত পরিবর্তনগুলো যাচাই করতে, ‘ ফিচার বাতিলকরণ এবং সংস্করণবিহীন পরিবর্তন’ নির্দেশিকাটি দেখুন।