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

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

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

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

Расписание

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

API-версия Дата выпуска Дата прекращения поддержки Дата заката Руководство по обновлению
версия 20 4 июня 2025 г. Обновление с v19 до v20
версия 19.1 16 апреля 2025 г.
в19 26 февраля 2025 г. Обновление с v18 до v19
в18 16 октября 2024 г. Июнь 2025 г. Август 2025 г. Обновление с v17 до v18

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

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

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

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

Срок Устаревание Закат
Определение Устаревшая версия — это версия, которая не является последней . После выпуска новой версии все предыдущие версии будут помечены как устаревшие. Версию заката больше нельзя использовать . Запросы, отправленные на эту версию, не будут выполнены в день заката или после него.
Импликация Вы по-прежнему можете использовать устаревшие версии до тех пор, пока они не будут упразднены , но ссылки на устаревшие версии будут деподсвечены, чтобы показать, что они больше не являются последними версиями.

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

 Чтобы использовать API Google Ads, вам необходимо немедленно обновить устаревшие версии.

Мы настоятельно рекомендуем вам обновиться до последней версии , используя руководство по обновлению .

Сроки В среднем мы выпускаем новую версию каждые 3–4 месяца, поэтому данная версия будет считаться устаревшей примерно через 3–4 месяца. Мы стремимся прекратить поддержку версии через год после ее выпуска.
API Конечные точки API для устаревших версий по-прежнему функционируют в обычном режиме .

Вы можете получить доступ к нашим конечным точкам API, используя наши клиентские библиотеки, REST и т. д.; однако новые функции не добавляются в устаревшие версии.

 Конечные точки API для версий sunset перестают работать после дат sunset. API Google Ads выдаст ошибку, если вы попытаетесь получить доступ к конечным точкам API версий sunset.
Клиентские библиотеки В целях предоставления компактных клиентских библиотек мы прекратим включать устаревшие версии API в новую версию клиентской библиотеки после даты устаревания. Это поможет вам сэкономить место при включении наших клиентских библиотек в ваши проекты. Клиентские библиотеки больше не поддерживают устаревшие версии API в новых версиях клиентских библиотек после даты окончания срока действия.
Поддерживать Мы оказываем регулярную поддержку устаревшим версиям. Версии с истекшим сроком действия больше не поддерживаются после даты окончания срока действия.

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

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

Ява

Клиентская библиотека для Java
v20 Min: 38.0.0
Max: -
v19 Min: 36.0.0
Max: -
v18 Min: 34.0.0
Max: -
v17 Min: 31.0.0
Max: 36.1.0

С#

Клиентская библиотека для .NET
v20 Min: 23.0.0
Max: -
v19 Min: 22.1.0
Max: -
v18 Min: 21.1.0
Max: -
v17 Min: 20.1.0
Max: 22.2.0

PHP

Клиентская библиотека для PHP
v20 Min: 28.0.0
Max: -
v19 Min: 26.1.0
Max: -
v18 Min: 25.0.0
Max: -
v17 Min: 23.1.0
Max: 27.2.0

Питон

Клиентская библиотека для Python
v20 Min: 27.0.0
Max: -
v19 Min: 25.2.0
Max: -
v18 Min: 25.1.0
Max: -
v17 Min: 24.1.0
Max: 26.1.0

Рубин

Клиентская библиотека для Ruby
v20 Min: 34.0.0
Max: -
v19 Min: 32.0.0
Max: -
v18 Min: 31.0.0
Max: -

Перл

Клиентская библиотека для Perl
v20 Min: 27.0.0
Max: -
v19 Min: 26.0.0
Max: -
v18 Min: 25.0.1
Max: -

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

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

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

Особенность Описание Дата вступления в силу Дополнительные примечания
Новые сообщения об ошибках для недействительных токенов разработчика Начиная с 28 апреля 2025 года недействительный токен разработчика будет возвращать DEVELOPER_TOKEN_INVALID для v19.1 и более поздних версий, и DEVELOPER_TOKEN_NOT_APPROVED для версий до v19.1. Недействительные токены разработчика ранее возвращали OAUTH_TOKEN_HEADER_INVALID , который по-прежнему будет использоваться для недействительных заголовков OAuth. 28 апреля 2025 г. Это изменение не повлияет на тех, у кого уже есть работающие вызовы API.