При выпуске новой версии устаревшей версии назначается дата прекращения действия, после которой эта версия больше не будет доступна. Вот еще несколько рекомендаций, которые следует иметь в виду:
- Одновременно доступны не более трех основных версий .
- Срок действия основных версий составляет около 12 месяцев , второстепенных версий: 10 месяцев.
- Вам придется выполнять не более двух обновлений в год , и вам не обязательно выполнять обновление в строгом последовательном порядке — например, вы можете выполнить обновление с версии (N) непосредственно до версии (N+2).
- Перекрытие между датой выпуска всех клиентских библиотек для последней версии и датой закрытия версии составляет не менее 20 недель.
Наши клиентские библиотеки поддерживают любые доступные версии сервиса, поэтому вы можете постепенно обновляться, указывая разные версии используемых сервисов.
Расписание
В следующей таблице перечислены конкретные даты прекращения поддержки и прекращения поддержки каждой доступной версии, а также прогнозируемые даты выпуска будущих версий. Мы рекомендуем вам выполнить обновление до последней версии как можно скорее после ее выпуска.
| версия API | Дата выпуска | Дата прекращения поддержки | Дата заката | Руководство по обновлению |
|---|---|---|---|---|
| v18 | 16 октября 2024 г. | февраль 2025 г. | 24 сентября 2025 г. | |
| v17.1 | 7 августа 2024 г. | 16 октября 2024 г. | 4 июня 2025 г. | Обновление с v17 до v18 |
| v17 | 5 июня 2024 г. | 16 октября 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 :
- Откройте API и службы в Google Cloud Console.
- Нажмите Google Ads API в таблице.
- На подвкладке «МЕТРИКИ» вы должны увидеть свои недавние запросы, отображенные на каждом графике. Вы можете увидеть, каким методам вы отправляли запросы, в таблице «Методы» . Имя метода включает версию API Google Рекламы, службу и имя метода, например
google.ads.googleads.v18.services.GoogleAdsService.Mutate. - (Необязательно) Выберите период времени, который вы хотите просмотреть для своих запросов.
Различия между прекращением поддержки и прекращением использования
| Срок | Устаревание | Закат |
|---|---|---|
| Определение | Устаревшая версия — это версия, которая не является последней . После выхода новой версии все предыдущие версии будут помечены как устаревшие. | Версию заката больше нельзя использовать . Запросы, отправленные в эту версию, не будут выполнены в день прекращения действия или после него. |
| Импликация | Вы по-прежнему можете использовать устаревшие версии до тех пор, пока они не устареют , но ссылки на устаревшие версии будут выделены, чтобы показать, что они больше не являются последней версией. Мы рекомендуем вам как можно скорее обновиться до последней версии, чтобы воспользоваться новыми функциями. | Чтобы использовать API Google Рекламы, вам необходимо немедленно обновить устаревшие версии. Мы настоятельно рекомендуем вам выполнить обновление до последней версии , воспользовавшись руководством по обновлению . |
| Тайминг | В среднем мы выпускаем новую версию каждые 3–4 месяца, поэтому данная версия устареет примерно через 3–4 месяца. | Мы стремимся закрыть версию через 1 год после ее выпуска. |
| API | Конечные точки API для устаревших версий по-прежнему работают как обычно . Вы можете получить доступ к нашим конечным точкам API, используя наши клиентские библиотеки, REST и т. д.; однако новые функции не добавляются в устаревшие версии. | Конечные точки API для версий с прекращением действия перестают работать после даты прекращения действия. API Google Рекламы выдаст ошибку, если вы попытаетесь получить доступ к конечным точкам API устаревших версий. |
| Клиентские библиотеки | В целях предоставления компактных клиентских библиотек мы прекратим включать устаревшие версии API в новую версию клиентской библиотеки после даты прекращения поддержки. Это поможет вам сэкономить место при включении наших клиентских библиотек в ваши проекты. | Клиентские библиотеки больше не поддерживают версии API с прекращением действия в любых новых версиях клиентских библиотек после даты прекращения действия. |
| Поддерживать | Мы предоставляем регулярную поддержку устаревших версий. | Версии с закатом больше не поддерживаются после даты заката. |
Поддерживаемые версии клиентской библиотеки
В таблице показано, какие клиентские библиотеки с какими версиями API работают.
Ява
API Google Рекламы | Клиентская библиотека для Java |
v18 | Min: 34.0.0Max: - |
v17 | Min: 32.0.0Max: - |
v16 | Min: 30.0.0Max: - |
С#
API Google Рекламы | Клиентская библиотека для .NET |
v18 | Min: 21.1.0Max: - |
v17 | Min: 20.1.0Max: - |
v16 | Min: 18.1.0Max: - |
PHP
API Google Рекламы | Клиентская библиотека для PHP |
v18 | Min: 25.0.0Max: - |
v17 | Min: 23.1.0Max: - |
v16 | Min: 22.1.0Max: - |
Питон
API Google Рекламы | Клиентская библиотека для Python |
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 |
v18 | Min: 25.0.0Max: - |
v17 | Min: 23.0.0Max: - |
v16 | Min: 21.0.0Max: - |
Устаревшие функции
Регулярно читайте блог разработчиков 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). |
При выпуске новой версии устаревшей версии назначается дата прекращения действия, после которой эта версия больше не будет доступна. Вот еще несколько рекомендаций, которые следует иметь в виду:
- Одновременно доступны не более трех основных версий .
- Срок действия основных версий составляет около 12 месяцев , второстепенных версий: 10 месяцев.
- Вам придется выполнять не более двух обновлений в год , и вам не обязательно выполнять обновление в строгом последовательном порядке — например, вы можете выполнить обновление с версии (N) непосредственно до версии (N+2).
- Перекрытие между датой выпуска всех клиентских библиотек для последней версии и датой закрытия версии составляет не менее 20 недель.
Наши клиентские библиотеки поддерживают любые доступные версии сервиса, поэтому вы можете постепенно обновляться, указывая разные версии используемых сервисов.
Расписание
В следующей таблице перечислены конкретные даты прекращения поддержки и прекращения поддержки каждой доступной версии, а также прогнозируемые даты выпуска будущих версий. Мы рекомендуем вам выполнить обновление до последней версии как можно скорее после ее выпуска.
| версия API | Дата выпуска | Дата прекращения поддержки | Дата заката | Руководство по обновлению |
|---|---|---|---|---|
| v18 | 16 октября 2024 г. | февраль 2025 г. | 24 сентября 2025 г. | |
| v17.1 | 7 августа 2024 г. | 16 октября 2024 г. | 4 июня 2025 г. | Обновление с v17 до v18 |
| v17 | 5 июня 2024 г. | 16 октября 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 :
- Откройте API и службы в Google Cloud Console.
- Нажмите Google Ads API в таблице.
- На подвкладке «МЕТРИКИ» вы должны увидеть свои недавние запросы, отображенные на каждом графике. Вы можете увидеть, каким методам вы отправляли запросы, в таблице «Методы» . Имя метода включает версию API Google Рекламы, службу и имя метода, например
google.ads.googleads.v18.services.GoogleAdsService.Mutate. - (Необязательно) Выберите период времени, который вы хотите просмотреть для своих запросов.
Различия между прекращением поддержки и прекращением использования
| Срок | Устаревание | Закат |
|---|---|---|
| Определение | Устаревшая версия — это версия, которая не является последней . После выпуска новой версии все предыдущие версии будут помечены как устаревшие. | Версию заката больше нельзя использовать . Запросы, отправленные в эту версию, не будут выполнены в день прекращения действия или после него. |
| Импликация | Вы по-прежнему можете использовать устаревшие версии до тех пор, пока они не устареют , но ссылки на устаревшие версии будут выделены, чтобы показать, что они больше не являются последней версией. Мы рекомендуем вам как можно скорее обновиться до последней версии, чтобы воспользоваться новыми функциями. | Чтобы использовать API Google Рекламы, вам необходимо немедленно обновить устаревшие версии. Мы настоятельно рекомендуем вам выполнить обновление до последней версии , воспользовавшись руководством по обновлению . |
| Тайминг | В среднем мы выпускаем новую версию каждые 3–4 месяца, поэтому данная версия устареет примерно через 3–4 месяца. | Мы стремимся прекратить выпуск версии через 1 год после ее выпуска. |
| API | Конечные точки API для устаревших версий по-прежнему работают как обычно . Вы можете получить доступ к нашим конечным точкам API, используя наши клиентские библиотеки, REST и т. д.; однако новые функции не добавляются в устаревшие версии. | Конечные точки API для версий с прекращением действия перестают работать после даты прекращения действия. API Google Рекламы выдаст ошибку, если вы попытаетесь получить доступ к конечным точкам API устаревших версий. |
| Клиентские библиотеки | В целях предоставления компактных клиентских библиотек мы прекратим включать устаревшие версии API в новую версию клиентской библиотеки после даты прекращения поддержки. Это поможет вам сэкономить место при включении наших клиентских библиотек в ваши проекты. | Клиентские библиотеки больше не поддерживают версии API с прекращением действия в любых новых версиях клиентских библиотек после даты прекращения действия. |
| Поддерживать | Мы предоставляем регулярную поддержку устаревших версий. | Версии с закатом больше не поддерживаются после даты заката. |
Поддерживаемые версии клиентской библиотеки
В таблице показано, какие клиентские библиотеки с какими версиями API работают.
Ява
API Google Рекламы | Клиентская библиотека для Java |
v18 | Min: 34.0.0Max: - |
v17 | Min: 32.0.0Max: - |
v16 | Min: 30.0.0Max: - |
С#
API Google Рекламы | Клиентская библиотека для .NET |
v18 | Min: 21.1.0Max: - |
v17 | Min: 20.1.0Max: - |
v16 | Min: 18.1.0Max: - |
PHP
API Google Рекламы | Клиентская библиотека для PHP |
v18 | Min: 25.0.0Max: - |
v17 | Min: 23.1.0Max: - |
v16 | Min: 22.1.0Max: - |
Питон
API Google Рекламы | Клиентская библиотека для Python |
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 |
v18 | Min: 25.0.0Max: - |
v17 | Min: 23.0.0Max: - |
v16 | Min: 21.0.0Max: - |
Устаревшие функции
Регулярно читайте блог разработчиков 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). |