В Google Ads API одновременно поддерживается несколько основных версий. Версия считается устаревшей, только если она явно помечена как устаревшая. Мы заранее публикуем даты выпуска и прекращения поддержки, чтобы вы могли планировать обновления. После этой даты версия становится недоступной. Вот несколько основных рекомендаций по управлению версиями:
- Мы стараемся, чтобы одновременно было доступно не более пяти основных версий.
- 12 месяцев для основных версий. Срок действия минорных версий API не отслеживается отдельно. Вместо этого для промежуточных версий действует та же дата прекращения поддержки, что и для соответствующей основной версии.
- Каждая промежуточная версия обновляет соответствующую основную версию.
- Все вызовы API, относящиеся к определенной основной версии, всегда направляются к последней соответствующей промежуточной версии. Google Ads API не поддерживает вызов определенных промежуточных версий.
- Вам нужно будет выполнять не более двух обновлений в год, причем не обязательно в строгом порядке. Например, вы можете перейти с версии N сразу на версию N+2.
- Если вы только начинаете работать с Google Ads API, рекомендуем использовать версию 26.
Наши клиентские библиотеки поддерживают все доступные версии сервиса, поэтому вы можете постепенно обновлять его, указывая разные версии используемых сервисов.
Расписание
В таблице ниже перечислены даты выпуска и прекращения поддержки для каждой доступной версии, а также прогнозируемые даты выпуска будущих версий. Рекомендуем как можно скорее перейти на последнюю версию после ее выпуска. Ориентировочная дата означает, что прекращение поддержки может произойти в любой день этого месяца, а даты могут измениться. Подпишитесь на блог, чтобы получать напоминания о прекращении поддержки версий 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 | 11 ноября 2026 г. | Ноябрь 2027 г. | Нет (незначительный выпуск) | Функции и обновления в версии 26.2 | Различия между прототипами v25 и v26 |
| Предстоящие версии | |||||
| 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 всегда есть несколько активных основных версий. | Использовать такую версию больше нельзя. Запросы, отправленные в эту версию, не будут выполняться после даты прекращения поддержки. |
| Последствия | Вы можете использовать устаревшие версии до тех пор, пока они не будут отключены. Однако ссылки на них будут выделены, чтобы показать, что это не последние версии.
Рекомендуем как можно скорее перейти на последнюю версию, чтобы воспользоваться новыми функциями. |
Чтобы продолжить работу с Google Ads API, вам нужно немедленно перейти на новую версию.
Мы настоятельно рекомендуем перейти на последнюю версию, следуя руководству по обновлению. |
| Время | Даты прекращения поддержки публикуются заранее, и версия считается устаревшей, только если она явно помечена как устаревшая. | Мы планируем прекращать поддержку версий через год после их выпуска. |
| 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. Прекращение поддержки отдельных функций (например, умных кампаний) и изменения рабочих процессов, не связанные с версиями (например, новые требования к бюджету кампаний для создания спроса), отслеживаются отдельно.
Чтобы узнать о жизненных циклах функций и изменениях поведения в активных версиях, ознакомьтесь с руководством Прекращение поддержки функций и изменения без версий.