استهلاک و غروب آفتاب

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

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

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

جدول زمانی

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

نسخه API تاریخ انتشار تاریخ غروب آفتاب راهنمای ارتقا
نسخه‌های منتشر شده
وی۲۱ ۶ آگوست ۲۰۲۵ اوت ۲۰۲۶ (آزمایشی) ارتقا از نسخه ۲۰ به نسخه ۲۱
وی۲۲ ۱۵ اکتبر ۲۰۲۵ اکتبر ۲۰۲۶ (احتمالی) ارتقا از نسخه ۲۱ به نسخه ۲۲
نسخه ۲۳ ۲۸ ژانویه ۲۰۲۶ فوریه ۲۰۲۷ ارتقا از نسخه ۲۲ به نسخه ۲۳
نسخه ۲۳.۱ ۲۵ فوریه ۲۰۲۶ فوریه ۲۰۲۷ ارتقا از نسخه ۲۳ به نسخه ۲۳.۱
نسخه ۲۳.۲ ۲۵ مارس ۲۰۲۶ فوریه ۲۰۲۷ ارتقا از نسخه ۲۳.۱ به نسخه ۲۳.۲
وی۲۴ ۲۲ آوریل ۲۰۲۶ مه ۲۰۲۷ ارتقا از نسخه ۲۳.۲ به نسخه ۲۴
نسخه ۲۴.۱ ۱۳ مه ۲۰۲۶ مه ۲۰۲۷ ارتقا از نسخه ۲۴ به نسخه ۲۴.۱
نسخه ۲۴.۲ ۲۴ ژوئن ۲۰۲۶ ژوئن ۲۰۲۷ ارتقا از نسخه ۲۴.۱ به نسخه ۲۴.۲
نسخه‌های آینده
وی۲۵ ژوئیه ۲۰۲۶ اوت ۲۰۲۷
نسخه ۲۵.۱ اوت ۲۰۲۶ اوت ۲۰۲۷
نسخه ۲۵.۲ سپتامبر ۲۰۲۶ اوت ۲۰۲۷
نسخه ۲۶ اکتبر ۲۰۲۶ نوامبر ۲۰۲۷
نسخه ۲۶.۱* نوامبر ۲۰۲۶ نوامبر ۲۰۲۷

* نسخه ۲۶.۱ به دلیل همپوشانی با فصل تعطیلات، به عنوان یک نسخه اختیاری تعیین شده است.

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

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

  1. APIها و خدمات را در کنسول Google Cloud باز کنید.
  2. روی API تبلیغات گوگل در جدول کلیک کنید.
  3. در زیرشاخه‌ی METRICS ، باید درخواست‌های اخیر خود را که روی هر نمودار رسم شده‌اند، مشاهده کنید. می‌توانید در جدول Methods ببینید که به کدام متدها درخواست ارسال کرده‌اید. نام متد شامل یک نسخه API گوگل ادز، یک سرویس و یک نام متد مانند google.ads.googleads.v24.services.GoogleAdsService.Mutate است.
  4. (اختیاری) بازه زمانی مورد نظر برای مشاهده درخواست‌هایتان را انتخاب کنید.

تفاوت‌های بین منسوخ شدن و غروب آفتاب

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

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

 برای استفاده از API گوگل ادز، باید فوراً از نسخه‌های قدیمی (sunset version) ارتقا دهید.

اکیداً توصیه می‌کنیم با استفاده از راهنمای ارتقا ، به آخرین نسخه ارتقا دهید.

زمان‌بندی به طور متوسط، ما هر ۳ تا ۴ ماه یک نسخه جدید منتشر می‌کنیم، بنابراین نسخه ارائه شده تقریباً پس از ۳ تا ۴ ماه منسوخ می‌شود. هدف ما این است که یک نسخه را یک سال پس از انتشار، از رده خارج کنیم.
رابط برنامه‌نویسی کاربردی نقاط پایانی API برای نسخه‌های منسوخ‌شده هنوز طبق معمول عمل می‌کنند .

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

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

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

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

حداقل نسخه کتابخانه کلاینت ذکر شده برای نسخه اصلی API تبلیغات گوگل (مانند نسخه ۲۴) کافی است. برای مشاهده نسخه کتابخانه کلاینت مورد نیاز برای نسخه‌های فرعی، به گزارش تغییرات (Changelog) لینک شده مراجعه کنید.

جاوا

تغییرات

کتابخانه کلاینت برای جاوا
v24 Min: 43.0.0
Max: -
v23 Min: 42.0.0
Max: -
v22 Min: 41.0.0
Max: -
v21 Min: 39.0.0
Max: -

سی شارپ

تغییرات

کتابخانه کلاینت برای .NET
v24 Min: 25.3.0
Max: -
v23 Min: 25.1.0
Max: -
v22 Min: 24.1.0
Max: -
v21 Min: 24.0.0
Max: -

پی اچ پی

تغییرات

کتابخانه کلاینت برای PHP
v24 Min: 33.3.0
Max: -
v23 Min: 32.2.0
Max: -
v22 Min: 31.0.0
Max: -
v21 Min: 28.0.0
Max: -

پایتون

تغییرات

کتابخانه کلاینت برای پایتون
v24 Min: 30.1.0
Max: -
v23 Min: 29.2.0
Max: -
v22 Min: 28.1.0
Max: -
v21 Min: 28.0.0
Max: -

روبی

تغییرات

کتابخانه کلاینت برای روبی
v24 Min: 40.0.0
Max: -
v23 Min: 38.0.0
Max: -
v22 Min: 36.0.0
Max: -
v21 Min: 35.0.0
Max: -

پرل

تغییرات

کتابخانه کلاینت برای پرل
v24 Min: 32.0.0
Max: -
v23 Min: 31.0.0
Max: -
v22 Min: 29.0.0
Max: -
v21 Min: 28.0.0
Max: -

حذف ویژگی‌ها و تغییرات

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

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