При выходе каждой новой версии мы устанавливаем дату, после которой предыдущая версия становится недоступной. Вот ещё несколько рекомендаций:
- Мы стараемся, чтобы одновременно было доступно не более пяти основных версий.
- Основные версии поддерживаются около 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 | Различия между протоколами версий 24 и 25 |
| v25.1 | 19 августа 2026 г. | Август 2027 г. | Нет (минорный выпуск) | Функции и обновления в версии 25.1 | Различия между протоколами версий 24 и 25 |
| v25.2 | 23 сентября 2026 г. | Август 2027 г. | Нет (минорный выпуск) | Функции и обновления в версии 25.2 | Различия между протоколами версий 24 и 25 |
| v26 (последняя) | 14 октября 2026 г. | Ноябрь 2027 г. | Критические изменения в версии 26 (руководство по обновлению) | Функции и обновления в версии 26 | Различия между протоколами версий 25 и 26 |
| Предстоящие версии | |||||
| 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.v26.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 (например, v26). Чтобы узнать, какая версия клиентской библиотеки требуется для минорных выпусков, перейдите по ссылке в журнале изменений.
Java
Google Ads API |
Клиентская библиотека для Java |
v26 |
Min: 48.0.0Max: - |
v25 |
Min: 44.0.0Max: - |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: - |
C#
Google Ads API |
Клиентская библиотека для .NET |
v26 |
Min: 27.5.0Max: - |
v25 |
Min: 26.1.0Max: - |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: - |
PHP
Google Ads API |
Клиентская библиотека для PHP |
v26 |
Min: 35.2.0Max: - |
v25 |
Min: 33.6.0Max: - |
v24 |
Min: 33.3.0Max: - |
v23 |
Min: 32.2.0Max: - |
Python
Google Ads API |
Клиентская библиотека для Python |
v26 |
Min: 34.0.0Max: - |
v25 |
Min: 31.2.0Max: - |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
Ruby
Google Ads API |
Клиентская библиотека для Ruby |
v26 |
Min: 46.0.0Max: - |
v25 |
Min: 43.0.0Max: - |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
Perl
Google Ads API |
Клиентская библиотека для Perl |
v26 |
Min: 36.0.0Max: - |
v25 |
Min: 33.0.0Max: - |
v24 |
Min: 32.0.0Max: - |
v23 |
Min: 31.0.0Max: - |
Прекращение поддержки и изменение функций
На этой странице рассматриваются жизненные циклы версий API. Прекращение поддержки отдельных функций (например, умных кампаний) и изменения рабочих процессов, не связанные с версиями (например, новые требования к бюджету кампаний для создания спроса), отслеживаются отдельно.
Чтобы узнать о предстоящих изменениях жизненного цикла функций и поведения в активных версиях, ознакомьтесь с руководством Прекращение поддержки функций и изменения без версий.