Устаревание и закат

С выходом новой версии устаревшая версия получает дату окончания срока действия, после которой она перестанет быть доступной. Вот несколько других рекомендаций, которые следует учитывать:

  • Мы стремимся поддерживать доступными не более четырех основных версий одновременно.
  • Срок жизни основных версий составляет около 12 месяцев , второстепенных версий — 10 месяцев.
  • Вам придется выполнять не более двух обновлений в год , и вам не обязательно обновляться в строго последовательном порядке — например, вы можете обновиться с версии (N) сразу до версии (N+2).
  • Перекрытие между датой выпуска всех клиентских библиотек последней версии и датой прекращения поддержки версии составляет не менее 20 недель.

Наши клиентские библиотеки поддерживают любые доступные версии сервиса, поэтому вы можете постепенно обновляться, указывая разные версии используемых сервисов.

Расписание

В таблице ниже указаны конкретные даты прекращения поддержки и прекращения поддержки для каждой доступной версии, а также предполагаемые даты выпуска будущих версий. Мы рекомендуем вам обновиться до последней версии как можно скорее после её выпуска. Предварительная дата означает, что прекращение поддержки может произойти в любой момент в течение месяца, и даты могут измениться. Подпишитесь на блог, чтобы получать напоминания об объявлениях об прекращении поддержки версий API.

версия API Дата выпуска Дата прекращения поддержки Дата заката Руководство по обновлению
v21 6 августа 2025 г. Обновление с версии 20 до версии 21
v20.1 6 августа 2025 г. Июнь 2026 г. (предварительно) Обновление с версии 19 до версии 20
версия 20 4 июня 2025 г. Июнь 2026 г. (предварительно) Обновление с версии 19 до версии 20
версия 19.2 6 августа 2025 г. Февраль 2026 г. (предварительно) Обновление с версии 18 до версии 19
v19.1 16 апреля 2025 г. Февраль 2026 г. (предварительно) Обновление с версии 18 до версии 19
v19 26 февраля 2025 г. Февраль 2026 г. (предварительно) Обновление с версии 18 до версии 19
v18 16 октября 2024 г. Июнь 2025 г. 20 августа 2025 г.

Посмотрите версии, которые использует ваш проект

Вы можете просмотреть список методов и служб, которые ваш проект недавно вызывал, с помощью Google Cloud Console :

  1. Откройте API и службы в Google Cloud Console.
  2. Нажмите Google Ads API в таблице.
  3. На подвкладке «ПОКАЗАТЕЛИ» на каждом графике отображаются ваши последние запросы. В таблице «Методы» можно увидеть, к каким методам вы отправляли запросы. Название метода включает версию API Google Ads, название сервиса и его название, например google.ads.googleads.v21.services.GoogleAdsService.Mutate .
  4. (Необязательно) Выберите временной интервал, за который вы хотите просматривать свои запросы.

Различия между устареванием и прекращением поддержки

Срок Устаревание Закат
Определение Устаревшая версия — это версия, которая не является последней . После выпуска новой версии все предыдущие версии будут помечены как устаревшие. Версию, срок действия которой истек , больше нельзя использовать . Запросы, отправленные к этой версии, будут отклонены в день истечения срока действия или после него.
Импликация Вы по-прежнему можете использовать устаревшие версии до момента их прекращения поддержки , но ссылки на устаревшие версии будут де-подсвечены, чтобы показать, что они больше не являются последними версиями.

Мы рекомендуем вам как можно скорее обновиться до последней версии, чтобы воспользоваться новыми функциями.

 Чтобы использовать API Google Ads, вам необходимо немедленно обновить устаревшие версии.

Мы настоятельно рекомендуем вам обновиться до последней версии , используя руководство по обновлению .

Сроки В среднем мы выпускаем новую версию каждые 3–4 месяца, поэтому данная версия будет считаться устаревшей примерно через 3–4 месяца. Мы стремимся прекратить поддержку версии через год после ее выпуска.
API Конечные точки API для устаревших версий продолжают функционировать в обычном режиме .

Вы можете получить доступ к нашим конечным точкам API, используя наши клиентские библиотеки, REST и т. д.; однако новые функции не добавляются в устаревшие версии.

 Конечные точки API для устаревших версий перестают работать после истечения срока действия. API Google Ads выдаст ошибку при попытке доступа к конечным точкам API устаревших версий.
Клиентские библиотеки В целях обеспечения компактности клиентских библиотек мы прекратим включать устаревшие версии API в новые версии клиентских библиотек после даты прекращения поддержки. Это поможет вам сэкономить место при интеграции наших клиентских библиотек в ваши проекты. Клиентские библиотеки больше не поддерживают устаревшие версии API в новых версиях клиентских библиотек после даты окончания срока действия.
Поддерживать Мы осуществляем регулярную поддержку устаревших версий. Версии с истекшим сроком действия больше не поддерживаются после даты окончания срока действия.

Поддерживаемые версии клиентской библиотеки

В таблице показано, какие клиентские библиотеки работают с теми или иными версиями API.

Ява

Клиентская библиотека для Java
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: -
v19 Min: 36.0.0
Max: -

С#

Клиентская библиотека для .NET
v21 Min: 24.0.0
Max: -
v20 Min: 23.0.0
Max: -
v19 Min: 22.1.0
Max: -
v18 Min: 21.1.0
Max: 23.0.0

PHP

Клиентская библиотека для 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

Питон

Клиентская библиотека для Python
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -
v19 Min: 25.2.0
Max: -

Руби

Клиентская библиотека для Ruby
v21 Min: 35.0.0
Max: -
v20 Min: 34.0.0
Max: -
v19 Min: 32.0.0
Max: -
v18 Min: 31.0.0
Max: -

Перл

Клиентская библиотека для Perl
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

Устаревание функций

Регулярно следите за блогом разработчиков Google Ads, чтобы первыми узнавать о предстоящем прекращении поддержки некоторых функций.

В таблице ниже перечислены конкретные функции, поддержка которых планируется прекратить в API Google Ads. Подробнее об этом можно узнать в соответствующих записях блога.

Особенность Описание Дата вступления в силу Дополнительные примечания
Среда конверсии влияет на эффективность кампании в приложении Начиная с 30 сентября 2025 года мы начнем постепенно внедрять изменения в модели назначения ставок, что позволит им использовать данные о среде конверсий, включенные в импортированные конверсии, для оптимизации эффективности кампании. 3 октября 2025 г. Более подробную информацию смотрите в нашем блоге .
Преобразования могут включать значения `gclid` и `gbraid`. Начиная с 3 октября 2025 года импортированные преобразования больше не будут возвращать ошибку `VALUE_MUST_BE_UNSET`, если заданы оба поля `gclid` и `gbraid`. 3 октября 2025 г. Более подробную информацию смотрите в нашем блоге .