При выходе каждой новой версии мы устанавливаем дату, после которой предыдущая версия становится недоступной. Вот ещё несколько рекомендаций:
- Мы стараемся поддерживать не более пяти основных версий одновременно.
- Основные версии поддерживаются около 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 | 14 октября 2026 г. | Ноябрь 2027 г. | Переход с версии 25.2 на версию 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 Рекламы 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 (например, версии 26). Чтобы узнать, какая версия клиентской библиотеки требуется для минорных выпусков, перейдите по ссылке в журнале изменений.
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, но отслеживание прекращения поддержки отдельных функций (например, умных кампаний) и изменений рабочих процессов без версий (например, новых требований к бюджету кампаний для создания спроса) выполняется отдельно.
Чтобы узнать о жизненных циклах функций и изменениях в поведении активных версий, ознакомьтесь с руководством Прекращение поддержки функций и изменения, не связанные с версиями.