منسوخ شدن و پایان کار

با انتشار نسخه جدید، برای نسخه منسوخ‌شده تاریخ پایانی تعیین می‌شود که پس‌از آن تاریخ، آن نسخه دیگر دردسترس نخواهد بود. در اینجا چند دستورالعمل دیگر برای به‌خاطر سپردن آورده شده است:

• تلاش می‌کنیم در هر زمان حداکثر پنج نسخه عمده را دردسترس نگه داریم.
• نسخه‌های اصلی حدود ۱۲ ماه عمر می‌کنند—نسخه‌های فرعی: ۱۰ ماه.
• باید حداکثر دو ارتقا در سال انجام دهید و لازم نیست به‌ترتیب متوالی دقیق ارتقا دهید — برای مثال، می‌توانید از نسخه (N) مستقیماً به نسخه (N+2) ارتقا دهید.

کتابخانه‌های کارخواه ما از هر نسخه دردسترس سرویس پشتیبانی می‌کنند، بنابراین می‌توانید با مشخص کردن نسخه‌های مختلف سرویس‌های استفاده‌شده، به‌تدریج ارتقا دهید.

جدول زمانی

جدول زیر تاریخ‌های مشخص منسوخ شدن و برچیده شدن هر نسخه دردسترس و تاریخ‌های انتشار پیش‌بینی‌شده برای نسخه‌های آینده را فهرست می‌کند. توصیه می‌کنیم در اولین فرصت پس‌از انتشار نسخه جدید، به آن ارتقا دهید. تاریخ احتمالی به این معنی است که توقف عرضه ممکن است در هر زمانی در آن ماه اتفاق بیفتد و تاریخ‌ها ممکن است تغییر کنند. در وبلاگ مشترک شوید تا یادآوری‌های مربوط به اعلام توقف پشتیبانی از نسخه میانای برنامه‌سازی کاربردی را دریافت کنید.

نسخه API	تاریخ اکران	تاریخ برچیدن	تغییرات ناگهانی و ارتقا	ویژگی‌ها و به‌روزرسانی‌ها	جدول تفاوت Proto
نسخه‌های منتشرشده
v23	‫۲۸ ژانویه ۲۰۲۶	فوریه ۲۰۲۷	تغییرات اساسی نسخه ۲۳ (راهنمای ارتقا)	ویژگی‌ها و به‌روزرسانی‌های نسخه ۲۳	تفاوت‌های نمونه اولیه v22 درمقابل v23
v23.1	‫۲۵ فوریه ۲۰۲۶	فوریه ۲۰۲۷	هیچ‌کدام (انتشار جزئی)	ویژگی‌ها و به‌روزرسانی‌های نسخه ۲۳.۱	تفاوت‌های نمونه اولیه v22 درمقابل v23
v23.2	‫۲۵ مارس ۲۰۲۶	فوریه ۲۰۲۷	هیچ‌کدام (انتشار جزئی)	ویژگی‌ها و به‌روزرسانی‌های نسخه ۲۳.۲	تفاوت‌های نمونه اولیه v22 درمقابل v23
v23.3	‫۲۴ ژوئن ۲۰۲۶	فوریه ۲۰۲۷	هیچ‌کدام (انتشار جزئی)	ویژگی‌ها و به‌روزرسانی‌های نسخه ۲۳.۳	تفاوت‌های نمونه اولیه v22 درمقابل v23
v24	‫۲۲ آوریل ۲۰۲۶	مه ۲۰۲۷	تغییرات ناسازگار نسخه ۲۴ (راهنمای ارتقا)	ویژگی‌ها و به‌روزرسانی‌های نسخه ۲۴	تفاوت‌های نمونه اولیه نسخه ۲۳ درمقابل نسخه ۲۴
v24.1	‫۱۳ مه ۲۰۲۶	مه ۲۰۲۷	هیچ‌کدام (انتشار جزئی)	ویژگی‌ها و به‌روزرسانی‌های نسخه ۲۴.۱	تفاوت‌های نمونه اولیه نسخه ۲۳ درمقابل نسخه ۲۴
v24.2	‫۲۴ ژوئن ۲۰۲۶	ژوئن ۲۰۲۷	هیچ‌کدام (انتشار جزئی)	ویژگی‌ها و به‌روزرسانی‌های نسخه ۲۴.۲	تفاوت‌های نمونه اولیه نسخه ۲۳ درمقابل نسخه ۲۴
v25	‫۲۲ ژوئیه ۲۰۲۶	اوت ۲۰۲۷	تغییرات ناسازگار نسخه ۲۵ (راهنمای ارتقا)	ویژگی‌ها و به‌روزرسانی‌های نسخه ۲۵	تفاوت‌های نمونه اولیه v24 درمقابل v25
v25.1	‫۱۹ اوت ۲۰۲۶	اوت ۲۰۲۷	هیچ‌کدام (انتشار جزئی)	ویژگی‌ها و به‌روزرسانی‌های نسخه ۲۵.۱	تفاوت‌های نمونه اولیه v24 درمقابل v25
v25.2	‫۲۳ سپتامبر ۲۰۲۶	اوت ۲۰۲۷	هیچ‌کدام (انتشار جزئی)	ویژگی‌ها و به‌روزرسانی‌های نسخه ۲۵.۲	تفاوت‌های نمونه اولیه v24 درمقابل v25
v26 (جدیدترین)	‫۱۴ اکتبر ۲۰۲۶	نوامبر ۲۰۲۷	تغییرات ناسازگار نسخه ۲۶ (راهنمای ارتقا)	ویژگی‌ها و به‌روزرسانی‌های نسخه ۲۶	تفاوت‌های نمونه اولیه نسخه ۲۵ درمقابل نسخه ۲۶
v26.1	‫۲۸ اکتبر ۲۰۲۶	نوامبر ۲۰۲۷	هیچ‌کدام (انتشار جزئی)	ویژگی‌ها و به‌روزرسانی‌های نسخه ۲۶.۱	تفاوت‌های نمونه اولیه نسخه ۲۵ درمقابل نسخه ۲۶
نسخه‌های آتی
v26.2	نوامبر ۲۰۲۶	نوامبر ۲۰۲۷
نسخه ۲۶.۳*	دسامبر ۲۰۲۶	نوامبر ۲۰۲۷
v27	ژانویه ۲۰۲۷	فوریه ۲۰۲۸
v27.1	فوریه ۲۰۲۷	فوریه ۲۰۲۸
v27.2	فوریه ۲۰۲۷	فوریه ۲۰۲۸
v27.3	مارس ۲۰۲۷	فوریه ۲۰۲۸
v27.4	مارس ۲۰۲۷	فوریه ۲۰۲۸
v28	آوریل ۲۰۲۷	مه ۲۰۲۸
v28.1	آوریل ۲۰۲۷	مه ۲۰۲۸
v28.2	مه ۲۰۲۷	مه ۲۰۲۸
v28.3	مه ۲۰۲۷	مه ۲۰۲۸
v28.4	ژوئن ۲۰۲۷	مه ۲۰۲۸
v28.5	ژوئن ۲۰۲۷	مه ۲۰۲۸
v29	ژوئیه ۲۰۲۷	اوت ۲۰۲۸
v29.1	ژوئیه ۲۰۲۷	اوت ۲۰۲۸
v29.2	اوت ۲۰۲۷	اوت ۲۰۲۸
v29.3	اوت ۲۰۲۷	اوت ۲۰۲۸
v29.4	سپتامبر ۲۰۲۷	اوت ۲۰۲۸
v29.5	سپتامبر ۲۰۲۷	اوت ۲۰۲۸
v30	اکتبر ۲۰۲۷	نوامبر ۲۰۲۸
v30.1	اکتبر ۲۰۲۷	نوامبر ۲۰۲۸
v30.2	نوامبر ۲۰۲۷	نوامبر ۲۰۲۸
v30.3*	دسامبر ۲۰۲۷	نوامبر ۲۰۲۸

* نسخه‌های v26.3 و v30.3 به‌دلیل هم‌پوشانی با فصل تعطیلات به‌عنوان نسخه‌های اختیاری تعیین شده‌اند.

مشاهده نسخه‌هایی که پروژه‌تان استفاده می‌کند

می‌توانید فهرست روش‌ها و سرویس‌هایی را که پروژه‌تان اخیراً فراخوانی کرده است بااستفاده از Google Cloud Console مشاهده کنید:

1. میاناهای برنامه‌سازی کاربردی و سرویس‌ها را در «کنسول Google Cloud» باز کنید.
2. روی Google Ads API در جدول کلیک کنید.
3. در فرعی‌برگه سنجه‌ها، باید درخواست‌های اخیرتان را که روی هر نمودار رسم شده است ببینید. می‌توانید روش‌هایی را که برای آن‌ها درخواست ارسال کرده‌اید در جدول روش‌ها ببینید. نام روش شامل نسخه Google Ads API، سرویس، و نام روش است، مثل google.ads.googleads.v26.services.GoogleAdsService.Mutate.
4. (اختیاری) چارچوب زمانی موردنظرتان را برای مشاهده درخواست‌هایتان انتخاب کنید.

تفاوت‌های بین منسوخ شدن و پایان پشتیبانی

مدت	منسوخ شدن	غروب
تعریف	نسخه منسوخ‌شده نسخه‌ای است که جدیدترین نسخه نیست. وقتی نسخه جدیدی منتشر می‌شود، همه نسخه‌های قبلی به‌عنوان منسوخ‌شده علامت‌گذاری می‌شوند.	نسخه منسوخ‌شده دیگر قابل‌استفاده نیست. درخواست‌های ارسال‌شده به این نسخه در تاریخ برچیده شدن یا پس‌از آن ناموفق خواهد بود.
پیامد	همچنان می‌توانید از نسخه‌های منسوخ‌شده تا زمانی که منقضی شوند استفاده کنید، اما ارجاع‌های نسخه‌های منسوخ‌شده برجسته نمی‌شوند تا نشان داده شود که دیگر جدیدترین نسخه نیستند. توصیه می‌کنیم در اسرع وقت به جدیدترین نسخه ارتقا دهید تا از ویژگی‌های جدید بهره‌مند شوید.	برای استفاده از Google Ads API، باید فوراً از نسخه‌های منسوخ‌شده ارتقا دهید. اکیداً توصیه می‌کنیم که بااستفاده از راهنمای ارتقا، به جدیدترین نسخه ارتقا دهید.
زمان‌بندی	به‌طور میانگین، هر ۳ تا ۴ ماه یک نسخه جدید منتشر می‌کنیم، بنابراین نسخه ارائه‌شده پس‌از تقریباً ۳ تا ۴ ماه منسوخ خواهد شد.	هدف ما این است که یک نسخه را ۱ سال پس‌از انتشار آن از رده خارج کنیم.
API	نقطه‌های پایانی میانای برنامه‌سازی کاربردی برای نسخه‌های منسوخ‌شده همچنان مثل معمول کار می‌کنند. می‌توانید بااستفاده از کتابخانه‌های کارخواه ما و REST به نقاط پایانی میانای برنامه‌سازی کاربردی ما دسترسی پیدا کنید. بااین‌حال، ویژگی‌های جدید به نسخه‌های منسوخ‌شده اضافه نمی‌شود.	نقاط پایانی میانای برنامه‌سازی کاربردی برای نسخه‌های منسوخ‌شده پس‌از تاریخ‌های منسوخ شدن ازکار می‌افتند. اگر بخواهید به نقاط پایانی میانای برنامه‌سازی کاربردی نسخه‌های منسوخ‌شده دسترسی پیدا کنید، Google Ads API خطا می‌دهد.
کتابخانه‌های کارخواه	برای ارائه کتابخانه‌های مشتری فشرده، دیگر نسخه‌های منسوخ‌شده API را در نسخه جدید کتابخانه مشتری پس‌از تاریخ منسوخ شدن اضافه نخواهیم کرد. این کار به شما کمک می‌کند هنگام گنجاندن کتابخانه‌های مشتری ما در پروژه‌هایتان، در فضا صرفه‌جویی کنید.	کتابخانه‌های کارخواه دیگر از نسخه‌های میانای برنامه‌سازی کاربردی منسوخ‌شده در هیچ‌یک از نسخه‌های جدید کتابخانه کارخواه پس‌از تاریخ‌های منسوخ شدن پشتیبانی نمی‌کنند.
پشتیبانی	ما پشتیبانی منظمی برای نسخه‌های منسوخ‌شده ارائه می‌دهیم.	نسخه‌های منسوخ‌شده پس‌از تاریخ منسوخ شدن دیگر پشتیبانی نمی‌شوند.

نسخه‌های پشتیبانی‌شده کتابخانه کارخواه

این جدول نشان می‌دهد کدام کتابخانه‌های کارخواه با کدام نسخه‌های میانای برنامه‌سازی کاربردی کار می‌کنند.

حداقل نسخه فهرست‌شده کتابخانه کارخواه برای نسخه اصلی Google Ads API (مانند v26) کافی است. برای دیدن نسخه کتابخانه مشتری موردنیاز برای نسخه‌های جزئی، به «گزارش تغییرات» پیوندشده مراجعه کنید.

تغییرات و منسوخ شدن ویژگی‌ها

درحالی‌که این صفحه بر چرخه‌های حیات سطح نسخه میانای برنامه‌سازی کاربردی تمرکز دارد، منسوخ شدن ویژگی‌های فردی (مانند منسوخ شدن «پویش‌های هوشمند») و تغییرات گردش کار بدون نسخه (مانند الزامات جدید بودجه پویش «تولید تقاضا») به‌طور جداگانه پیگیری می‌شوند.

برای بررسی چرخه‌های حیات ویژگی‌های آتی و تغییرات رفتاری در نسخه‌های فعال، به راهنمای منسوخ شدن ویژگی‌ها و تغییرات بدون نسخه مراجعه کنید.