Прекращение поддержки и отключение

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

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

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

Расписание

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

Версия API	Дата выпуска	Дата отключения	Критические изменения и обновление	Функции и обновления	Таблица различий в прототипах
Выпущенные версии
v23	28 января 2026 г.	Февраль 2027 г.	Критические изменения в версии 23 (руководство по обновлению)	Функции и обновления в версии 23	Различия между протоколами версий 22 и 23
v23.1	25 февраль 2026 г.	Февраль 2027 г.	Нет (незначительный выпуск)	Функции и обновления в версии 23.1	Различия между протоколами версий 22 и 23
v23.2	25 марта 2026 г.	Февраль 2027 г.	Нет (незначительный выпуск)	Функции и обновления в версии 23.2	Различия между протоколами версий 22 и 23
v23.3	24 июня 2026 г.	Февраль 2027 г.	Нет (незначительный выпуск)	Функции и обновления в версии 23.3	Различия между протоколами версий 22 и 23
v24	22 апреля 2026 г.	Май 2027 г.	Критические изменения в версии 24 (руководство по обновлению)	Функции и обновления в версии 24	Различия между протоколами версий 23 и 24
v24.1	13 мая 2026 г.	Май 2027 г.	Нет (незначительный выпуск)	Функции и обновления в версии 24.1	Различия между протоколами версий 23 и 24
v24.2	24 июня 2026 г.	Июнь 2027 г.	Нет (незначительный выпуск)	Функции и обновления в версии 24.2	Различия между протоколами версий 23 и 24
v25	22 июля 2026 г.	Август 2027 г.	Критические изменения в версии 25 (руководство по обновлению)	Новые функции и обновления в версии 25	Различия между протоколами v24 и v25
v25.1	19 августа 2026 г.	Август 2027 г.	Нет (незначительный выпуск)	Функции и обновления в версии 25.1	Различия между протоколами v24 и v25
v25.2	23 сентября 2026 г.	Август 2027 г.	Нет (незначительный выпуск)	Функции и обновления в версии 25.2	Различия между протоколами v24 и v25
v26 (последняя)	14 октября 2026 г.	Ноябрь 2027 г.	Критические изменения в версии 26 (руководство по обновлению)	Функции и обновления в версии 26	Различия между прототипами v25 и v26
v26.1	28 октября 2026 г.	Ноябрь 2027 г.	Нет (незначительный выпуск)	Функции и обновления в версии 26.1	Различия между прототипами v25 и v26
Предстоящие версии
v26.2	Ноябрь 2026 г.	Ноябрь 2027 г.
26.3*	Декабрь 2026 г.	Ноябрь 2027 г.
v27	Январь 2027 г.	Февраль 2028 г.
v27.1	Февраль 2027 г.	Февраль 2028 г.
v27.2	Февраль 2027 г.	Февраль 2028 г.
v27.3	Март 2027 г.	Февраль 2028 г.
v27.4	Март 2027 г.	Февраль 2028 г.
v28	Апрель 2027 г.	Май 2028 г.
v28.1	Апрель 2027 г.	Май 2028 г.
v28.2	Май 2027 г.	Май 2028 г.
v28.3	Май 2027 г.	Май 2028 г.
v28.4	Июнь 2027 г.	Май 2028 г.
v28.5	Июнь 2027 г.	Май 2028 г.
v29	Июль 2027 г.	Август 2028 г.
v29.1	Июль 2027 г.	Август 2028 г.
v29.2	Август 2027 г.	Август 2028 г.
v29.3	Август 2027 г.	Август 2028 г.
v29.4	Сентябрь 2027 г.	Август 2028 г.
v29.5	Сентябрь 2027 г.	Август 2028 г.
v30	Октябрь 2027 г.	Ноябрь 2028 г.
v30.1	Октябрь 2027 г.	Ноябрь 2028 г.
v30.2	Ноябрь 2027 г.	Ноябрь 2028 г.
30.3*	Декабрь 2027 г.	Ноябрь 2028 г.

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

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

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

1. Откройте раздел APIs & Services (API и сервисы) в консоли Google Cloud.
2. В таблице нажмите Google Ads API.
3. На вложенной вкладке METRICS (Показатели) вы увидите графики, на которых представлены ваши недавние запросы. Посмотреть, каким методам вы отправляли запросы, можно в таблице Методы. Название метода включает версию Google Ads API, сервис и название метода, например google.ads.googleads.v26.services.GoogleAdsService.Mutate.
4. При необходимости выберите период времени, за который вы хотите посмотреть запросы.

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

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

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

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

Указанная минимальная версия клиентской библиотеки подходит для основной версии Google Ads API (например, v26). Чтобы узнать, какая версия клиентской библиотеки требуется для минорных выпусков, перейдите по ссылке в журнале изменений.

Прекращение поддержки и изменение функций

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

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