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

При выпуске новой версии устаревшей версии присваивается дата прекращения поддержки, после которой эта версия больше не будет доступна. Вот еще несколько рекомендаций, которые следует учитывать:

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

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

Расписание

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

версия API	Дата выпуска	Дата заката	Руководство по обновлению
Выпущенные версии
v19	26 февраля 2025 г.	11 февраля 2026 г.
v19.1	16 апреля 2025 г.	11 февраля 2026 г.
v19.2	6 августа 2025 г.	11 февраля 2026 г.
v20	4 июня 2025 г.	Июнь 2026 г. (ориентировочно)	Обновление с версии 19 до версии 20
v20.1	6 августа 2025 г.	Июнь 2026 г. (ориентировочно)	Обновление с версии 19 до версии 20
v21	6 августа 2025 г.	Август 2026 г. (ориентировочно)	Обновление с версии 20 до версии 21
v22	15 октября 2025 г.	Октябрь 2026 г. (ориентировочно)	Обновление с версии 21 до версии 22
v23	28 января 2026 г.	Февраль 2027 г.	Обновление с версии 22 до версии 23
Предстоящие версии
v23.1	Февраль 2026 г.	Февраль 2027 г.
v23.2	25 марта 2026 г.	Февраль 2027 г.
v24	Апрель 2026 г.	Май 2027 г.
v24.1	Май 2026 г.	Май 2027 г.
v24.2	Июнь 2026 г.	Май 2027 г.
v25	Июль 2026 г.	Август 2027 г.
v25.1	Август 2026 г.	Август 2027 г.
v25.2	Сентябрь 2026 г.	Август 2027 г.
v26	Октябрь 2026 г.	Ноябрь 2027 г.
v26.1*	Ноябрь 2026 г.	Ноябрь 2027 г.

* Версия 26.1 обозначена как необязательный релиз в связи с периодом, совпадающим с праздничным сезоном.

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

Список методов и сервисов, которые ваш проект недавно вызывал, можно просмотреть в консоли Google Cloud :

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

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

Срок	Амортизация	Закат
Определение	Устаревшая версия — это версия, которая не является последней . После выпуска новой версии все предыдущие версии будут помечены как устаревшие.	Устаревшая версия больше недоступна для использования . Запросы, отправленные на эту версию, будут завершаться с ошибкой в ​​день или после даты прекращения поддержки.
Импликация	Вы по-прежнему можете использовать устаревшие версии, пока их поддержка не будет прекращена , но ссылки на устаревшие версии будут отключены, чтобы показать, что это уже не последняя версия. Мы рекомендуем вам как можно скорее обновить программу до последней версии, чтобы воспользоваться новыми функциями.	Для использования API Google Ads необходимо немедленно перейти с устаревших версий на более новые. Мы настоятельно рекомендуем обновить программу до последней версии , используя руководство по обновлению .
Время	В среднем мы выпускаем новую версию каждые 3-4 месяца, поэтому данная версия будет признана устаревшей примерно через 3-4 месяца.	Мы планируем прекратить поддержку версии через год после её выпуска.
API	API-интерфейсы для устаревших версий по-прежнему функционируют как обычно . Вы можете получить доступ к нашим API-интерфейсам, используя наши клиентские библиотеки, REST и т. д.; однако новые функции не добавляются в устаревшие версии.	После истечения указанных дат API-интерфейсы для устаревающих версий перестанут работать . При попытке доступа к API-интерфейсам устаревающих версий Google Ads выдаст ошибку.
Клиентские библиотеки	В целях обеспечения компактности клиентских библиотек мы прекратим включать устаревшие версии API в новые версии клиентских библиотек после даты их устаревания. Это поможет вам сэкономить место при интеграции наших клиентских библиотек в ваши проекты.	После истечения срока поддержки API в новых версиях клиентских библиотек после указанных дат поддержка устаревших версий API прекращена.
Поддерживать	Мы регулярно оказываем техническую поддержку устаревшим версиям.	После истечения установленного срока поддержка устаревших версий прекращается .

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

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

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

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

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

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