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

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

• حداکثر، سه نسخه اصلی در هر زمان در دسترس هستند.
• نسخه های اصلی حدود 12 ماه طول عمر دارند — نسخه های فرعی : 10 ماه.
• شما باید حداکثر دو ارتقا در سال انجام دهید، و نیازی نیست که به ترتیب متوالی دقیق ارتقا دهید—به عنوان مثال، می توانید مستقیماً از نسخه (N) به نسخه (N+2) ارتقا دهید.
• همپوشانی بین تاریخی که همه کتابخانه های مشتری برای آخرین نسخه منتشر می شوند و نسخه غروب آفتاب حداقل 20 هفته است.

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

جدول زمانی

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

نسخه API	تاریخ انتشار	تاریخ منسوخ شدن	تاریخ غروب آفتاب	راهنمای ارتقا
v18	16 اکتبر 2024	فوریه 2025	24 سپتامبر 2025
نسخه 17.1	7 آگوست 2024	16 اکتبر 2024	4 ژوئن 2025	از نسخه 17 به نسخه 18 ارتقا دهید
v17	5 ژوئن 2024	16 اکتبر 2024	4 ژوئن 2025	از نسخه 17 به نسخه 18 ارتقا دهید
نسخه 16.1	24 آوریل 2024	5 ژوئن 2024	5 فوریه 2025	از نسخه 16 به نسخه 17 ارتقا دهید
v16	21 فوریه 2024	5 ژوئن 2024	5 فوریه 2025	از نسخه 16 به نسخه 17 ارتقا دهید

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

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

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

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

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

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

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

جاوا

Google Ads API	کتابخانه مشتری برای جاوا
v18	Min: 34.0.0 Max: -
v17	Min: 32.0.0 Max: -
v16	Min: 30.0.0 Max: -

سی شارپ

Google Ads API	کتابخانه مشتری برای دات نت
v18	Min: 21.1.0 Max: -
v17	Min: 20.1.0 Max: -
v16	Min: 18.1.0 Max: -

PHP

Google Ads API	کتابخانه مشتری برای PHP
v18	Min: 25.0.0 Max: -
v17	Min: 23.1.0 Max: -
v16	Min: 22.1.0 Max: -

پایتون

Google Ads API	کتابخانه کلاینت برای پایتون
v18	Min: 25.1.0 Max: -
v17	Min: 24.1.0 Max: -
v16	Min: 23.1.0 Max: -

روبی

Google Ads API	کتابخانه مشتری برای روبی
v18	Min: 31.0.0 Max: -
v17	Min: 29.0.0 Max: -
v16	Min: 27.0.0 Max: -

پرل

Google Ads API	کتابخانه مشتری برای پرل
v18	Min: 25.0.0 Max: -
v17	Min: 23.0.0 Max: -
v16	Min: 21.0.0 Max: -

حذف ویژگی ها

به طور منظم وبلاگ توسعه دهندگان Google Ads را زیر نظر داشته باشید تا اولین کسی باشید که در مورد لغو ویژگی های آینده می شنوید.

جدول زیر حذف ویژگی های خاصی را که برای Google Ads API برنامه ریزی شده است فهرست می کند. جزئیات بیشتر برای هر انکار را می توان در پست های وبلاگ پیوند یافته یافت.

ویژگی	توضیحات	تاریخ لازم الاجرا شدن	یادداشت های اضافی
تغییرات آتی اندازه صفحه در Google Ads API	وقتی نسخه 16 غروب می‌کند، دیگر نمی‌توانید فیلد page_size را هنگام درخواست GoogleAdsService.Search تنظیم کنید.	فوریه 2025	وقتی نسخه 16 غروب می‌کند، تمام درخواست‌های GoogleAdsService.Search اندازه صفحه ثابت 10000 ردیف را در نظر می‌گیرند.
استراتژی پیشنهاد قیمت CPC پیشرفته	Google Ads API دیگر از تنظیم eCPC به عنوان یک استراتژی پیشنهادی برای کمپین‌های جستجو و نمایش پشتیبانی نمی‌کند.	اکتبر 2024	درخواست برای تنظیم فیلد enhanced_cpc_enabled روی TRUE در استراتژی مناقصه منجر به خطای BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED می شود. کمپین‌های موجود با استراتژی پیشنهاد eCPC تا 15 مارس 2025 ادامه خواهند داشت. پس از این روز، آنها به‌طور خودکار به هزینه هر کلیک دستی (CPC) منتقل می‌شوند.

،

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

• حداکثر، سه نسخه اصلی در هر زمان در دسترس هستند.
• نسخه های اصلی حدود 12 ماه طول عمر دارند — نسخه های فرعی : 10 ماه.
• شما باید حداکثر دو ارتقا در سال انجام دهید، و نیازی نیست که به ترتیب متوالی دقیق ارتقا دهید—به عنوان مثال، می توانید مستقیماً از نسخه (N) به نسخه (N+2) ارتقا دهید.
• همپوشانی بین تاریخی که همه کتابخانه های مشتری برای آخرین نسخه منتشر می شوند و نسخه غروب آفتاب حداقل 20 هفته است.

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

جدول زمانی

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

نسخه API	تاریخ انتشار	تاریخ منسوخ شدن	تاریخ غروب آفتاب	راهنمای ارتقا
v18	16 اکتبر 2024	فوریه 2025	24 سپتامبر 2025
نسخه 17.1	7 آگوست 2024	16 اکتبر 2024	4 ژوئن 2025	از نسخه 17 به نسخه 18 ارتقا دهید
v17	5 ژوئن 2024	16 اکتبر 2024	4 ژوئن 2025	از نسخه 17 به نسخه 18 ارتقا دهید
نسخه 16.1	24 آوریل 2024	5 ژوئن 2024	5 فوریه 2025	از نسخه 16 به نسخه 17 ارتقا دهید
v16	21 فوریه 2024	5 ژوئن 2024	5 فوریه 2025	از نسخه 16 به نسخه 17 ارتقا دهید

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

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

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

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

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

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

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

جاوا

Google Ads API	کتابخانه مشتری برای جاوا
v18	Min: 34.0.0 Max: -
v17	Min: 32.0.0 Max: -
v16	Min: 30.0.0 Max: -

سی شارپ

Google Ads API	کتابخانه مشتری برای دات نت
v18	Min: 21.1.0 Max: -
v17	Min: 20.1.0 Max: -
v16	Min: 18.1.0 Max: -

PHP

Google Ads API	کتابخانه مشتری برای PHP
v18	Min: 25.0.0 Max: -
v17	Min: 23.1.0 Max: -
v16	Min: 22.1.0 Max: -

پایتون

Google Ads API	کتابخانه کلاینت برای پایتون
v18	Min: 25.1.0 Max: -
v17	Min: 24.1.0 Max: -
v16	Min: 23.1.0 Max: -

روبی

Google Ads API	کتابخانه مشتری برای روبی
v18	Min: 31.0.0 Max: -
v17	Min: 29.0.0 Max: -
v16	Min: 27.0.0 Max: -

پرل

Google Ads API	کتابخانه مشتری برای پرل
v18	Min: 25.0.0 Max: -
v17	Min: 23.0.0 Max: -
v16	Min: 21.0.0 Max: -

حذف ویژگی ها

به طور منظم وبلاگ توسعه دهندگان Google Ads را زیر نظر داشته باشید تا اولین کسی باشید که در مورد لغو ویژگی های آینده می شنوید.

جدول زیر حذف ویژگی های خاصی را که برای Google Ads API برنامه ریزی شده است فهرست می کند. جزئیات بیشتر برای هر انکار را می توان در پست های وبلاگ پیوند یافته یافت.

ویژگی	توضیحات	تاریخ لازم الاجرا شدن	یادداشت های اضافی
تغییرات آتی اندازه صفحه در Google Ads API	وقتی نسخه 16 غروب می‌کند، دیگر نمی‌توانید فیلد page_size را هنگام درخواست GoogleAdsService.Search تنظیم کنید.	فوریه 2025	وقتی نسخه 16 غروب می‌کند، تمام درخواست‌های GoogleAdsService.Search اندازه صفحه ثابت 10000 ردیف را در نظر می‌گیرند.
استراتژی پیشنهاد قیمت CPC پیشرفته	Google Ads API دیگر از تنظیم eCPC به عنوان یک استراتژی پیشنهادی برای کمپین‌های جستجو و نمایش پشتیبانی نمی‌کند.	اکتبر 2024	درخواست برای تنظیم فیلد enhanced_cpc_enabled روی TRUE در استراتژی مناقصه منجر به خطای BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED می شود. کمپین‌های موجود با استراتژی پیشنهاد eCPC تا 15 مارس 2025 ادامه خواهند داشت. پس از این روز، آنها به‌طور خودکار به هزینه هر کلیک دستی (CPC) منتقل می‌شوند.