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

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

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

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

جدول زمانی

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

نسخه API	تاریخ اکران	تاریخ توقف	راهنمای ارتقا
نسخه‌های منتشرشده
v23	‫۲۸ ژانویه ۲۰۲۶	فوریه ۲۰۲۷	ارتقا از نسخه ۲۲ به نسخه ۲۳
v23.1	‫۲۵ فوریه ۲۰۲۶	فوریه ۲۰۲۷	ارتقا از نسخه ۲۳ به نسخه ۲۳.۱
v23.2	۲۵ مارس ۲۰۲۶	فوریه ۲۰۲۷	ارتقا از نسخه ۲۳.۱ به نسخه ۲۳.۲
v24	‫۲۲ آوریل ۲۰۲۶	مه ۲۰۲۷	ارتقا از نسخه ۲۳.۲ به نسخه ۲۴
v24.1	‫۱۳ مه ۲۰۲۶	مه ۲۰۲۷	ارتقا از نسخه ۲۴ به نسخه ۲۴.۱
v24.2	‫۲۴ ژوئن ۲۰۲۶	ژوئن ۲۰۲۷	ارتقا از نسخه ۲۴.۱ به نسخه ۲۴.۲
v25	‫۲۲ ژوئیه ۲۰۲۶	اوت ۲۰۲۷	ارتقا از نسخه ۲۴.۲ به نسخه ۲۵
v25.1	‫۱۹ اوت ۲۰۲۶	اوت ۲۰۲۷	ارتقا از نسخه ۲۵ به نسخه ۲۵.۱
v25.2	‫۲۳ سپتامبر ۲۰۲۶	اوت ۲۰۲۷	ارتقا از نسخه ۲۵.۱ به نسخه ۲۵.۲
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	نوامبر ۲۰۲۷	نوامبر ۲۰۲۸
نسخه ۳۰.۳*	دسامبر ۲۰۲۷	نوامبر ۲۰۲۸

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

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

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

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

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

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

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