Устаревание и закат

При выпуске новой версии устаревшей версии назначается дата прекращения действия, после которой эта версия больше не будет доступна. Вот еще несколько рекомендаций, которые следует иметь в виду:

• Одновременно доступны не более трех основных версий .
• Срок действия основных версий составляет около 12 месяцев , второстепенных версий: 10 месяцев.
• Вам придется выполнять не более двух обновлений в год , и вам не обязательно выполнять обновление в строгом последовательном порядке — например, вы можете выполнить обновление с версии (N) непосредственно до версии (N+2).
• Перекрытие между датой выпуска всех клиентских библиотек для последней версии и датой закрытия версии составляет не менее 20 недель.

Наши клиентские библиотеки поддерживают любые доступные версии сервиса, поэтому вы можете постепенно обновляться, указывая разные версии используемых сервисов.

Расписание

В следующей таблице перечислены конкретные даты прекращения поддержки и прекращения поддержки каждой доступной версии, а также прогнозируемые даты выпуска будущих версий. Мы рекомендуем вам выполнить обновление до последней версии как можно скорее после ее выпуска.

версия API	Дата выпуска	Дата прекращения поддержки	Дата заката	Руководство по обновлению
v18	16 октября 2024 г.	февраль 2025 г.	24 сентября 2025 г.
v17.1	7 августа 2024 г.	Сентябрь/октябрь 2024 г.	4 июня 2025 г.	Обновление с v17 до v18
v17	5 июня 2024 г.	Сентябрь/октябрь 2024 г.	4 июня 2025 г.	Обновление с v17 до v18
v16.1	24 апреля 2024 г.	5 июня 2024 г.	5 февраля 2025 г.	Обновление с v16 до v17
v16	21 февраля 2024 г.	5 июня 2024 г.	5 февраля 2025 г.	Обновление с v16 до v17

Просмотрите версии, которые использует ваш проект

Вы можете просмотреть список методов и сервисов, которые ваш проект недавно вызывал, с помощью Google Cloud Console :

1. Откройте API и службы в Google Cloud Console.
2. Нажмите Google Ads API в таблице.
3. На подвкладке «МЕТРИКИ» вы должны увидеть свои недавние запросы, отображенные на каждом графике. Вы можете увидеть, каким методам вы отправляли запросы, в таблице «Методы» . Имя метода включает версию API Google Рекламы, службу и имя метода, например google.ads.googleads.v18.services.GoogleAdsService.Mutate .
4. (Необязательно) Выберите период времени, который вы хотите просмотреть для своих запросов.

Различия между прекращением поддержки и прекращением использования

Срок	Устаревание	Закат
Определение	Устаревшая версия — это версия, которая не является последней . После выхода новой версии все предыдущие версии будут помечены как устаревшие.	Версию заката больше нельзя использовать . Запросы, отправленные в эту версию, не будут выполнены в день прекращения действия или после него.
Импликация	Вы по-прежнему можете использовать устаревшие версии до тех пор, пока они не устареют , но ссылки на устаревшие версии будут выделены, чтобы показать, что они больше не являются последней версией. Мы рекомендуем вам как можно скорее обновиться до последней версии, чтобы воспользоваться новыми функциями.	Чтобы использовать API Google Рекламы, вам необходимо немедленно обновить устаревшие версии. Мы настоятельно рекомендуем вам выполнить обновление до последней версии , воспользовавшись руководством по обновлению .
Тайминг	В среднем мы выпускаем новую версию каждые 3–4 месяца, поэтому данная версия устареет примерно через 3–4 месяца.	Мы стремимся прекратить выпуск версии через 1 год после ее выпуска.
API	Конечные точки API для устаревших версий по-прежнему работают как обычно . Вы можете получить доступ к нашим конечным точкам API, используя наши клиентские библиотеки, REST и т. д.; однако новые функции не добавляются в устаревшие версии.	Конечные точки API для версий с прекращением действия перестают работать после даты прекращения действия. API Google Рекламы выдаст ошибку, если вы попытаетесь получить доступ к конечным точкам API устаревших версий.
Клиентские библиотеки	В целях предоставления компактных клиентских библиотек мы прекратим включать устаревшие версии API в новую версию клиентской библиотеки после даты прекращения поддержки. Это поможет вам сэкономить место при включении наших клиентских библиотек в ваши проекты.	Клиентские библиотеки больше не поддерживают версии API с прекращением действия в любых новых версиях клиентских библиотек после даты прекращения действия.
Поддерживать	Мы предоставляем регулярную поддержку устаревших версий.	Версии с закатом больше не поддерживаются после даты заката.

Поддерживаемые версии клиентской библиотеки

В таблице показано, какие клиентские библиотеки с какими версиями API работают.

Устаревшие функции

Регулярно читайте блог разработчиков Google Рекламы , чтобы первыми узнавать о предстоящем прекращении поддержки функций.

В следующей таблице перечислены некоторые устаревшие функции, которые в настоящее время запланированы для Google Ads API. Более подробную информацию о каждом прекращении поддержки можно найти в связанных сообщениях блога.

Особенность	Описание	Дата вступления в силу	Дополнительные примечания
Предстоящие изменения размера страницы в Google Ads API	Когда выйдет версия 16, вы больше не сможете задавать поле page_size при отправке запросов GoogleAdsService.Search .	январь 2025 г.	Когда версия 16 выйдет из эксплуатации, все запросы GoogleAdsService.Search будут предполагать фиксированный размер страницы в 10 000 строк.
Стратегия назначения ставок с расширенной ценой за клик	API Google Рекламы больше не поддерживает настройку эффективной цены за клик в качестве стратегии назначения ставок для кампаний в поисковой и контекстно-медийной сети.	октябрь 2024 г.	Запросы на установку поля enhanced_cpc_enabled в TRUE в стратегии назначения ставок приведут к ошибке BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED . Существующие кампании со стратегией назначения ставок eCPC будут работать до 15 марта 2025 г. После этого дня они будут автоматически переведены на ручное определение цены за клик (CPC).