При выпуске новой версии устаревшей версии назначается дата прекращения действия, после которой эта версия больше не будет доступна. Вот еще несколько рекомендаций, которые следует иметь в виду:
- Одновременно доступны не более трех основных версий .
- Срок действия основных версий составляет около 12 месяцев , второстепенных версий: 10 месяцев.
- Вам придется выполнять не более двух обновлений в год , и вам не обязательно выполнять обновление в строгом последовательном порядке — например, вы можете выполнить обновление с версии (N) непосредственно до версии (N+2).
- Перекрытие между датой выпуска всех клиентских библиотек для последней версии и датой закрытия версии составляет не менее 20 недель.
Наши клиентские библиотеки поддерживают любые доступные версии сервиса, поэтому вы можете постепенно обновляться, указывая разные версии используемых сервисов.
Расписание
В следующей таблице перечислены конкретные даты прекращения поддержки и прекращения поддержки каждой доступной версии, а также прогнозируемые даты выпуска будущих версий. Мы рекомендуем вам выполнить обновление до последней версии как можно скорее после ее выпуска.
| версия API | Дата выпуска | Дата прекращения поддержки | Дата заката | Руководство по обновлению |
|---|---|---|---|---|
| v19 | 26 февраля 2025 г. | Обновление с v18 до v19 | ||
| v18 | 16 октября 2024 г. | июнь 2025 г. | Сентябрь 2025 г. | Обновление с v17 до v18 |
| 17.1 | 7 августа 2024 г. | 16 октября 2024 г. | 4 июня 2025 г. | |
| v17 | 5 июня 2024 г. | 16 октября 2024 г. | 4 июня 2025 г. |
Просмотрите версии, которые использует ваш проект
Вы можете просмотреть список методов и сервисов, которые ваш проект недавно вызывал, с помощью Google Cloud Console :
- Откройте API и службы в Google Cloud Console.
- Нажмите Google Ads API в таблице.
- На подвкладке «МЕТРИКИ» вы должны увидеть свои недавние запросы, отображенные на каждом графике. Вы можете увидеть, каким методам вы отправляли запросы, в таблице «Методы» . Имя метода включает версию API Google Рекламы, службу и имя метода, например
google.ads.googleads.v19.services.GoogleAdsService.Mutate. - (Необязательно) Выберите период времени, который вы хотите просмотреть для своих запросов.
Различия между прекращением поддержки и прекращением использования
| Срок | Устаревание | Закат |
|---|---|---|
| Определение | Устаревшая версия — это версия, которая не является последней . После выхода новой версии все предыдущие версии будут помечены как устаревшие. | Версию заката больше нельзя использовать . Запросы, отправленные в эту версию, не будут выполнены в день прекращения действия или после него. |
| Импликация | Вы по-прежнему можете использовать устаревшие версии до тех пор, пока они не устареют , но ссылки на устаревшие версии будут выделены, чтобы показать, что они больше не являются последней версией. Мы рекомендуем вам как можно скорее обновиться до последней версии, чтобы воспользоваться новыми функциями. | Чтобы использовать API Google Рекламы, вам необходимо немедленно обновить устаревшие версии. Мы настоятельно рекомендуем вам выполнить обновление до последней версии , воспользовавшись руководством по обновлению . |
| Тайминг | В среднем мы выпускаем новую версию каждые 3–4 месяца, поэтому данная версия устареет примерно через 3–4 месяца. | Мы стремимся закрыть версию через 1 год после ее выпуска. |
| API | Конечные точки API для устаревших версий по-прежнему работают как обычно . Вы можете получить доступ к нашим конечным точкам API, используя наши клиентские библиотеки, REST и т. д.; однако новые функции не добавляются в устаревшие версии. | Конечные точки API для версий с прекращением действия перестают работать после даты прекращения действия. API Google Рекламы выдаст ошибку, если вы попытаетесь получить доступ к конечным точкам API устаревших версий. |
| Клиентские библиотеки | В целях предоставления компактных клиентских библиотек мы прекратим включать устаревшие версии API в новую версию клиентской библиотеки после даты прекращения поддержки. Это поможет вам сэкономить место при включении наших клиентских библиотек в ваши проекты. | Клиентские библиотеки больше не поддерживают устаревшие версии API в любых новых версиях клиентских библиотек после даты прекращения действия. |
| Поддерживать | Мы предоставляем регулярную поддержку устаревших версий. | Версии с закатом больше не поддерживаются после даты заката. |
Поддерживаемые версии клиентской библиотеки
В таблице показано, какие клиентские библиотеки с какими версиями API работают.
API Google Рекламы | Клиентская библиотека для Java |
v19 | Min: 36.0.0Max: - |
v18 | Min: 34.0.0Max: - |
v17 | Min: 32.0.0Max: - |
API Google Рекламы | Клиентская библиотека для .NET |
v19 | Min: 22.1.0Max: - |
v18 | Min: 21.1.0Max: - |
v17 | Min: 20.1.0Max: - |
v16 | Min: 18.1.0Max: 21.1.0 |
API Google Рекламы | Клиентская библиотека для PHP |
v19 | Min: 26.1.0Max: - |
v18 | Min: 25.0.0Max: - |
v17 | Min: 23.1.0Max: - |
API Google Рекламы | Клиентская библиотека для Python |
v19 | Min: 25.2.0Max: - |
v18 | Min: 25.1.0Max: - |
v17 | Min: 24.1.0Max: - |
v16 | Min: 23.1.0Max: - |
API Google Рекламы | Клиентская библиотека для Ruby |
v18 | Min: 31.0.0Max: - |
v17 | Min: 29.0.0Max: - |
v16 | Min: 27.0.0Max: - |
API Google Рекламы | Клиентская библиотека для Perl |
v19 | Min: 26.0.0Max: - |
v18 | Min: 25.0.1Max: - |
v17 | Min: 23.0.0Max: - |
Устаревшие функции
Регулярно читайте блог разработчиков Google Рекламы , чтобы первыми узнавать о предстоящем прекращении поддержки функций.
В следующей таблице перечислены некоторые устаревшие функции, запланированные для Google Ads API. Более подробную информацию о каждом прекращении поддержки можно найти в связанных сообщениях блога.
| Особенность | Описание | Дата вступления в силу | Дополнительные примечания |
|---|---|---|---|
| Обновление отчета об анализе поисковых запросов API Google Рекламы и сценариев Google Рекламы, начиная с 3 марта 2025 г. | Начиная с 3 марта 2025 г. в отчетах Google Ads API и скриптов Google Ads о поисковых запросах все подкатегории поиска будут отображаться как пустые. Пользовательский интерфейс Google Рекламы уже удалил это поле, и API также внедряет это изменение, чтобы обеспечить единообразие во всей Google Рекламе. | 3 марта 2025 г. | Ожидается, что начиная с 3 марта 2025 г. все значения для segments.search_subcategory будут пустыми. Если вы выполняете запрос segments.search_subcategory в отчетах campaign_search_term_insight или customer_search_term_insight , убедитесь, что ваш код может обрабатывать пустое значение в segments.search_subcategory . Пустая строка уже является универсальной, поэтому ваш код уже должен ее обрабатывать. Мы рекомендуем удалить segments.search_subcategory из вашего запроса. |
| Предстоящие изменения размера страницы в Google Ads API | Когда выйдет версия 16, вы больше не сможете задавать поле page_size при отправке запросов GoogleAdsService.Search . | февраль 2025 г. | Когда версия 16 выйдет из эксплуатации, все запросы GoogleAdsService.Search будут предполагать фиксированный размер страницы в 10 000 строк. |
| Изменение срока действия подписки на списки электронных адресов | С 7 апреля 2025 г. в поле UserList.membership_life_span больше нельзя будет принимать значения, превышающие 540. | 7 апреля 2025 г. | С 7 по 15 апреля 2025 г. мы постепенно внесем изменение в поле UserList.membership_life_span . Запросы на установку поля больше 540 вернут ошибку RangeError.TOO_HIGH . Любой существующий список пользователей со значением поля больше 540 будет автоматически перенесен, чтобы срок членства составлял максимум 540 дней. Дополнительную информацию см. в разделе «Обновление срока действия членства в списках электронных адресов» . |