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

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

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

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

جدول زمانی

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

نسخه API تاریخ انتشار تاریخ انقضا تاریخ غروب آفتاب راهنمای ارتقا
وی۲۱ ۶ آگوست ۲۰۲۵ اوت ۲۰۲۶ (آزمایشی) ارتقا از نسخه ۲۰ به نسخه ۲۱
نسخه ۲۰.۱ ۶ آگوست ۲۰۲۵ ژوئن ۲۰۲۶ (آزمایشی) ارتقا از نسخه ۱۹ به نسخه ۲۰
وی۲۰ ۴ ژوئن ۲۰۲۵ ژوئن ۲۰۲۶ (آزمایشی) ارتقا از نسخه ۱۹ به نسخه ۲۰
نسخه ۱۹.۲ ۶ آگوست ۲۰۲۵ فوریه ۲۰۲۶ (احتمالی) ارتقا از نسخه ۱۸ به نسخه ۱۹
نسخه ۱۹.۱ ۱۶ آوریل ۲۰۲۵ فوریه ۲۰۲۶ (احتمالی) ارتقا از نسخه ۱۸ به نسخه ۱۹
نسخه ۱۹ ۲۶ فوریه ۲۰۲۵ فوریه ۲۰۲۶ (احتمالی) ارتقا از نسخه ۱۸ به نسخه ۱۹

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

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

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

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

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

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

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

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

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

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

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

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

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

جاوا

کتابخانه کلاینت برای جاوا
v22 Min: 41.0.0
Max: -
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: -
v19 Min: 36.0.0
Max: -

سی شارپ

کتابخانه کلاینت برای .NET
v21 Min: 24.1.0
Max: -
v21 Min: 24.0.0
Max: -
v20 Min: 23.0.0
Max: -
v19 Min: 22.1.0
Max: -

پی اچ پی

کتابخانه کلاینت برای PHP
v21 Min: 31.0.0
Max: -
v20 Min: 28.0.0
Max: -
v19 Min: 26.1.0
Max: -
v18 Min: 25.0.0
Max: 30.0.0

پایتون

کتابخانه کلاینت برای پایتون
v22 Min: 28.1.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -
v19 Min: 25.2.0
Max: -

روبی

کتابخانه کلاینت برای روبی
v21 Min: 35.0.0
Max: -
v20 Min: 34.0.0
Max: -
v19 Min: 32.0.0
Max: -

پرل

کتابخانه کلاینت برای پرل
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -
v19 Min: 26.0.0
Max: -
v18 Min: 25.0.1
Max: 28.0.0

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

مرتباً وبلاگ توسعه‌دهندگان گوگل ادز را رصد کنید تا اولین نفری باشید که از حذف ویژگی‌های جدید مطلع می‌شود.

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

ویژگی توضیحات تاریخ لازم الاجرا شدن یادداشت‌های تکمیلی
محیط تبدیل برای تأثیرگذاری بر عملکرد کمپین اپلیکیشن از 30 سپتامبر 2025، ما به تدریج تغییراتی را در مدل‌های پیشنهاد قیمت اعمال خواهیم کرد که به آنها امکان می‌دهد از داده‌های محیط تبدیل موجود در تبدیل‌های وارد شده برای بهینه‌سازی عملکرد کمپین استفاده کنند. ۳ اکتبر ۲۰۲۵ برای جزئیات بیشتر به پست وبلاگ ما مراجعه کنید.
تبدیل‌ها می‌توانند شامل مقادیر «gclid» و «gbraid» باشند. از تاریخ ۳ اکتبر ۲۰۲۵، تبدیل‌های وارد شده دیگر در صورت تنظیم هر دو فیلد «gclid» و «gbraid» خطای «VALUE_MUST_BE_UNSET» را برنمی‌گردانند. ۳ اکتبر ۲۰۲۵ برای جزئیات بیشتر به پست وبلاگ ما مراجعه کنید.