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

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

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

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

Расписание

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

версия API	Дата выпуска	Дата прекращения поддержки	Дата заката	Руководство по обновлению
v18	Сентябрь/октябрь 2024 г.	Январь/февраль 2025 г.	Сентябрь 2025 г.
v17.1	июль/август 2024 г.	Сентябрь/октябрь 2024 г.	май 2025 г.
v17	май/июнь 2024 г.	Сентябрь/октябрь 2024 г.	май 2025 г.
v16.1	апрель/май 2024 г.	май/июнь 2024 г.	Январь 2025 г.
v16	21 февраля 2024 г.	май/июнь 2024 г.	Январь 2025 г.
v15	18 октября 2023 г.	21 февраля 2024 г.	25 сентября 2024 г.	Обновление с v15 до v16
v14.1	9 августа 2023 г.	18 октября 2023 г.	5 июня 2024 г.
v14	7 июня 2023 г.	18 октября 2023 г.	5 июня 2024 г.	Обновление с v14 до v15

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

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

1. Откройте API и службы в Google Cloud Console.
2. Нажмите Google Ads API в таблице.
3. На подвкладке «МЕТРИКИ» вы должны увидеть свои недавние запросы, отображенные на каждом графике. Вы можете увидеть, каким методам вы отправляли запросы, в таблице «Методы» . Имя метода включает версию API Google Рекламы, службу и имя метода, например google.ads.googleads.v16.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. Более подробную информацию о каждом прекращении поддержки можно найти в связанных сообщениях блога.

Особенность	Описание	Дата вступления в силу	Дополнительные замечания
Стратегия ставок комиссий	API Google Рекламы больше не поддерживает создание кампаний для отелей со стратегией назначения ставок COMMISSION .	30 апреля 2024 г.	Запросы на создание новых кампаний для отелей или применение стратегии назначения ставок COMMISSION к существующим кампаниям приведут к ошибке BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED . Существующие кампании со стратегией назначения ставок COMMISSION будут действовать до 31 октября 2024 г. После этого дня кампании прекратят показ объявлений, пока их стратегия назначения ставок не будет обновлена.