При выходе каждой новой версии мы устанавливаем дату, после которой предыдущая версия становится недоступной. Вот ещё несколько рекомендаций:
- Мы стараемся, чтобы одновременно было доступно не более пяти основных версий.
- Основные версии поддерживаются около 12 месяцев, а дополнительные – 10 месяцев.
- Вам нужно будет выполнять не более двух обновлений в год, и их не обязательно выполнять в строгой последовательности. Например, вы можете перейти с версии N сразу на версию N+2.
Актуальные версии API для всех сервисов представлены в клиентских библиотеках. Вы можете постепенно переходить на новые версии, указывая их в запросах к сервисам.
Расписание
В таблице ниже перечислены конкретные даты прекращения поддержки и отключения для всех доступных версий, а также прогнозируемые даты выпуска будущих версий. Рекомендуем как можно скорее перейти на последнюю версию после ее выпуска. Это значит, что поддержка может быть прекращена в любой день этого месяца, а даты могут измениться. Подпишитесь на блог, чтобы получать напоминания о прекращении поддержки версий API.
| Версия API | Дата выпуска | Дата отключения | Руководство по переходу |
|---|---|---|---|
| Выпущенные версии | |||
| v22 | 15 октября 2025 г. | Октябрь 2026 г. | Переход с версии 21 на версию 22 |
| v23 | 28 января 2026 г. | Февраль 2027 г. | Переход с версии 22 на версию 23 |
| v23.1 | 25 февраль 2026 г. | Февраль 2027 г. | Переход с версии 23 на версию 23.1 |
| v23.2 | 25 марта 2026 г. | Февраль 2027 г. | Переход с версии 23.1 на версию 23.2 |
| v24 | 22 апреля 2026 г. | Май 2027 г. | Переход с версии 23.2 на версию 24 |
| v24.1 | 13 мая 2026 г. | Май 2027 г. | Переход с версии 24 на версию 24.1 |
| v24.2 | 24 июня 2026 г. | Июнь 2027 г. | Переход с версии 24.1 на версию 24.2 |
| v25 | 22 июля 2026 г. | Август 2027 г. | Переход с версии 24.2 на версию 25 |
| v25.1 | 19 августа 2026 г. | Август 2027 г. | Переход с версии 25 на версию 25.1 |
| v25.2 | 23 сентября 2026 г. | Август 2027 г. | Переход с версии 25.1 на версию 25.2 |
| Предстоящие версии | |||
| v26 | Октябрь 2026 г. | Ноябрь 2027 г. | |
| v26.1 | Октябрь 2026 г. | Ноябрь 2027 г. | |
| 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.
- Откройте раздел APIs & Services (API и сервисы) в консоли Google Cloud.
- В таблице нажмите Google Ads API.
- На вложенной вкладке METRICS (Показатели) вы увидите графики с данными о недавних запросах. Посмотреть, для каких методов вы отправили запросы, можно в таблице Методы. Название метода включает версию Google Ads API, сервис и название метода, например
google.ads.googleads.v25.services.GoogleAdsService.Mutate. - При необходимости выберите период времени, за который вы хотите посмотреть запросы.
Различия между прекращением поддержки и прекращением работы
| Термин | Прежней версии | Закат |
|---|---|---|
| Определение | Устаревшей считается версия, которая не является последней. После выпуска новой версии все предыдущие версии будут помечены как устаревшие. | Версию, выведенную из эксплуатации, больше нельзя использовать. Запросы, отправленные в эту версию, будут отклоняться после даты прекращения поддержки. |
| Последствия | Вы можете использовать устаревшие версии до прекращения их поддержки, но ссылки на них будут выделены менее заметно, чтобы показать, что это не последние версии.
Рекомендуем как можно скорее перейти на последнюю версию, чтобы воспользоваться новыми функциями. |
Чтобы продолжить работу с Google Ads API, вам необходимо немедленно перейти на новую версию.
Мы настоятельно рекомендуем перейти на последнюю версию, используя руководство по обновлению. |
| Время | В среднем мы выпускаем новую версию каждые 3–4 месяца, поэтому поддержка текущей версии прекращается примерно через 3–4 месяца. | Мы планируем прекращать поддержку версий через год после их выпуска. |
| API | Конечные точки API для устаревших версий по-прежнему работают.
Вы можете получить доступ к конечным точкам API с помощью наших клиентских библиотек и REST. Однако в устаревшие версии новые функции не добавляются. |
Конечные точки API для версий, поддержка которых прекращена, перестают работать после даты прекращения поддержки. При попытке доступа к конечным точкам API устаревших версий Google Ads API будет выдавать ошибку. |
| Клиентские библиотеки | Чтобы клиентские библиотеки были компактными, мы прекратим включать устаревшие версии API в новые версии клиентских библиотек после даты прекращения поддержки. Это позволяет экономить место при использовании клиентских библиотек в проектах. | Клиентские библиотеки больше не поддерживают версии API, выведенные из эксплуатации, в новых версиях клиентских библиотек после даты вывода из эксплуатации. |
| Поддержка | Мы предоставляем стандартную поддержку для устаревших версий. | После наступления даты вывода из эксплуатации версии больше не поддерживаются. |
Поддерживаемые версии клиентских библиотек
В таблице показано, какие клиентские библиотеки работают с какими версиями API.
Указанная минимальная версия клиентской библиотеки подходит для основного выпуска Google Ads API (например, версии 25). Чтобы узнать, какая версия клиентской библиотеки требуется для второстепенных выпусков, ознакомьтесь с журналом изменений.
Java
Google Ads API |
Клиентская библиотека для Java |
v25 |
Min: 44.0.0Max: - |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: - |
C#
Google Ads API |
Клиентская библиотека для .NET |
v25 |
Min: 26.1.0Max: - |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: - |
PHP
Google Ads API |
Клиентская библиотека для PHP |
v25 |
Min: 33.6.0Max: - |
v24 |
Min: 33.3.0Max: - |
v23 |
Min: 32.2.0Max: - |
Python
Google Ads API |
Клиентская библиотека для Python |
v25 |
Min: 31.2.0Max: - |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
Ruby
Google Ads API |
Клиентская библиотека для Ruby |
v25 |
Min: 43.0.0Max: - |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
Perl
Google Ads API |
Клиентская библиотека для Perl |
v25 |
Min: 33.0.0Max: - |
v24 |
Min: 32.0.0Max: - |
v23 |
Min: 31.0.0Max: - |
Прекращение поддержки и изменение функций
На этой странице рассматриваются жизненные циклы версий API, но отслеживание прекращения поддержки отдельных функций (например, умных кампаний) и изменений рабочих процессов без версий (например, новых требований к бюджету кампаний для создания спроса) выполняется отдельно.
Чтобы узнать о предстоящих изменениях в жизненном цикле функций и изменении поведения активных версий, ознакомьтесь с руководством Устаревшие функции и изменения без версий.