При выходе каждой новой версии мы устанавливаем дату, после которой предыдущая версия становится недоступной. Вот ещё несколько рекомендаций:
- Мы стараемся, чтобы одновременно было доступно не более пяти основных версий.
- Основные версии поддерживаются около 12 месяцев, а промежуточные – 10 месяцев.
- Вам нужно будет выполнять не более двух обновлений в год, и их не обязательно выполнять в строгой последовательности. Например, вы можете перейти с версии N сразу на версию N+2.
Наши клиентские библиотеки поддерживают все доступные версии сервисов, поэтому вы можете постепенно переходить на новые версии, указывая разные версии используемых сервисов.
Расписание
В таблице ниже перечислены конкретные даты прекращения поддержки и отключения для всех доступных версий, а также прогнозируемые даты выпуска будущих версий. Рекомендуем как можно скорее перейти на последнюю версию после ее выпуска. Это значит, что поддержка может быть прекращена в любой день этого месяца, а даты могут измениться. Подпишитесь на блог, чтобы получать напоминания о прекращении поддержки версий API.
| Версия API | Дата выпуска | Дата отключения | Руководство по переходу |
|---|---|---|---|
| Конечные версии | |||
| 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 г. | |
| 26.1* | Ноябрь 2026 г. | Ноябрь 2027 г. | |
* Версия 26.1 считается необязательной, поскольку ее выпуск совпадает с праздничным сезоном.
Как посмотреть, какие версии используются в проекте
Посмотреть список методов и сервисов, к которым ваш проект обращался в последнее время, можно в консоли Google Cloud:
- Откройте раздел APIs & Services (API и сервисы) в консоли Google Cloud.
- В таблице нажмите Google Ads API.
- На вложенной вкладке METRICS (Показатели) вы увидите графики с данными о недавних запросах. Посмотреть, для каких методов вы отправили запросы, можно в таблице Методы. Название метода включает версию Google Рекламы 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 (например, v25). Чтобы узнать, какая версия клиентской библиотеки требуется для минорных выпусков, перейдите по ссылке в журнале изменений.
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. Прекращение поддержки отдельных функций (например, умных кампаний) и изменения рабочих процессов, не связанные с версиями (например, новые требования к бюджету кампаний для создания спроса), отслеживаются отдельно.
Чтобы узнать о жизненных циклах функций и изменениях в поведении активных версий, ознакомьтесь с руководством Прекращение поддержки функций и изменения, не связанные с версиями.