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

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

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

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

جدول زمانی

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

نسخه 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) کافی است. برای دیدن نسخه کتابخانه مشتری موردنیاز برای نسخه‌های فرعی، به «گزارش تغییرات» پیوندشده مراجعه کنید.

جاوا

گزارش تغییرات

کتابخانه کارخواه برای جاوا
v26 Min: 48.0.0
Max: -
v25 Min: 44.0.0
Max: -
v24 Min: 43.0.0
Max: -
v23 Min: 42.0.0
Max: -

C#‎

گزارش تغییرات

کتابخانه مشتری برای .NET
v26 Min: 27.5.0
Max: -
v25 Min: 26.1.0
Max: -
v24 Min: 25.3.0
Max: -
v23 Min: 25.1.0
Max: -

PHP

گزارش تغییرات

کتابخانه مشتری برای PHP
v26 Min: 35.2.0
Max: -
v25 Min: 33.6.0
Max: -
v24 Min: 33.3.0
Max: -
v23 Min: 32.2.0
Max: -

Python

گزارش تغییرات

کتابخانه کارخواه برای Python
v26 Min: 34.0.0
Max: -
v25 Min: 31.2.0
Max: -
v24 Min: 30.1.0
Max: -
v23 Min: 29.2.0
Max: -

Ruby

گزارش تغییرات

کتابخانه کارخواه برای Ruby
v26 Min: 46.0.0
Max: -
v25 Min: 43.0.0
Max: -
v24 Min: 40.0.0
Max: -
v23 Min: 38.0.0
Max: -

پرل

گزارش تغییرات

کتابخانه مشتری برای Perl
v26 Min: 36.0.0
Max: -
v25 Min: 33.0.0
Max: -
v24 Min: 32.0.0
Max: -
v23 Min: 31.0.0
Max: -

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

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

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