Примечания к выпускам

На этой странице представлены примечания к выпуску API Google Bid Manager.

Последняя версия API: v2

22 сентября 2025 г.

Известные проблемы

В связи с низким уровнем использования трех значений перечисления Filter , как было ранее объявлено в справочном центре Display & Video 360, прекращается их поддержка .

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

v2

• Следующие Filters устарели:

  Значение(я) Filter
  FILTER_DFP_ORDER_ID FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_INSERTION_ORDER FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_PARTNER

1 марта 2025 г.

Известные проблемы

Отмена публикации отчета о доступности контента YouTube Trueview и связанных с ним параметров, как было объявлено ранее в справочном центре Display & Video 360 .

v2

• Следующие фильтры устарели:

  Значение(я) фильтра

  FILTER_DETAILED_DEMOGRAPHICS FILTER_DETAILED_DEMOGRAPHICS_ID FILTER_HOUSEHOLD_INCOME FILTER_LIFE_EVENT FILTER_REMARKETING_LIST FILTER_TRUEVIEW_IAR_AGE FILTER_TRUEVIEW_IAR_CATEGORY FILTER_TRUEVIEW_IAR_CITY FILTER_TRUEVIEW_IAR_COUNTRY FILTER_TRUEVIEW_IAR_COUNTRY_NAME FILTER_TRUEVIEW_IAR_GENDER FILTER_TRUEVIEW_IAR_INTEREST FILTER_TRUEVIEW_IAR_LANGUAGE FILTER_TRUEVIEW_IAR_PARENTAL_STATUS FILTER_TRUEVIEW_IAR_REGION_NAME FILTER_TRUEVIEW_IAR_REMARKETING_LIST FILTER_TRUEVIEW_IAR_TIME_OF_DAY FILTER_TRUEVIEW_IAR_YOUTUBE_CHANNEL FILTER_TRUEVIEW_IAR_YOUTUBE_VIDEO FILTER_TRUEVIEW_IAR_ZIPCODE FILTER_YOUTUBE_CHANNEL FILTER_YOUTUBE_VIDEO

• Следующие метрики устарели:

  Значение(я) метрики
  METRIC_POTENTIAL_VIEWS METRIC_TEA_TRUEVIEW_IMPRESSIONS METRIC_TEA_TRUEVIEW_UNIQUE_COOKIES

20 ноября 2024 г.

Новые функции

Запускается фильтр FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID . Это позволяет включать данные с более низким уровнем достоверности для метрик со следующими префиксами:

• METRIC_UNIQUE_REACH_
• METRIC_VIRTUAL_PEOPLE_DUPLICATE_
• METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_
• METRIC_VIRTUAL_PEOPLE_OVERLAP_

При использовании этого фильтра необходимо включить один из соответствующих показателей.

При запуске запросы, не содержащие этот фильтр, будут по умолчанию включать только данные с высокой степенью достоверности. Начиная с 4 февраля 2025 года , запросы, не содержащие этот фильтр, будут по умолчанию включать данные с более низкой степенью достоверности.

v2

• Добавлены следующие фильтры:

  Тип фильтра	Доступные значения
  FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID	0 : Включить данные с более низким уровнем достоверности. (По умолчанию после 4 февраля 2025 г. ) 1 : Включать только данные с высокой степенью достоверности. (По умолчанию — до 4 февраля 2025 г. )

1 октября 2024 г.

Новые функции

Никто.

Известные проблемы

v2

Прекращение использования метода анонимного моделирования инвентаризации (AIM) в качестве инструмента отчетности.

Размерность FILTER_ANONYMOUS_INVENTORY_MODELING — sunset.

Создание или запуск ресурсов Query с использованием значений, определяющих закат активности, в параметре params.groupBy приводит к ошибке 400 .

Показатели DST/ROC (регулируемые операционные расходы) и общие затраты на рекламу стали несовместимы с отчетами YOUTUBE .

Следующие значения метрик больше нельзя использовать в отчетах YOUTUBE :

• METRIC_TOTAL_MEDIACOST_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPC_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPAPC_USD
• METRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPV_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPAPV_USD
• METRIC_TOTAL_MEDIACOST_ECPA_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPA_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPA_USD
• METRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPCV_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPCV_USD
• METRIC_TOTAL_MEDIACOST_ECPC_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPC_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPC_USD
• METRIC_TOTAL_MEDIACOST_ECPM_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPM_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPM_USD
• METRIC_TOTAL_MEDIACOST_PARTNER
• METRIC_TOTAL_MEDIACOST_USD
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISER
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNER
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USD
• METRIC_FEE32_ADVERTISER
• METRIC_FEE32_PARTNER
• METRIC_FEE32_USD

При попытке создания или выполнения Query к ресурсам с params.type равным YOUTUBE и соответствующим значением метрики в params.metrics возникает ошибка 400 .

1 мая 2024 г.

Новые функции

Никто.

Известные проблемы

v2

Прекращение поддержки отчетов о полном пути и атрибуции пути.

Отчеты с полным путем и атрибуцией пути больше не поддерживаются. Получение или создание ресурсов Query и Report такого типа приводит к ошибке.

Устаревшие значения следующих ReportType :

• FULL_PATH
• PATH_ATTRIBUTION

Поле pathQueryOptions объекта Options также устарело.

28 февраля 2024 г.

Новые функции

Никто.

Известные проблемы

v2

Прекращение действия метрик конверсии между устройствами

Показатели конверсии между устройствами больше не поддерживаются. Включены следующие значения метрик API Bid Manager:

• METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENT
• METRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENT
• METRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENT
• METRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENT
• METRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT

6 июля 2022 г.

Новые функции

Выпущен API Bid Manager версии 2.

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

Значительно обновлены ресурсы запросов и отчетов: удалены ненужные поля, реорганизованы существующие поля и изменены типы полей. Это включает в себя изменение типов полей с использования именованных объектов вместо общего определения «вложенного объекта».

Требуется запускать произвольные запросы с помощью метода queries.run , а не автоматически после их создания.

Заменил параметр запроса queries.run asynchronous на synchronous .

Упрощен процесс получения отчетов благодаря следующим изменениям:

• Добавление метода queries.reports.get .
• Добавление параметра запроса orderBy к queries.reports.list .
• Обновление тела ответа queries.run с пустого объекта на экземпляр сгенерированного ресурса Report .

Обновлены сообщения об ошибках, возвращаемые API, чтобы сделать их более конкретными и содержать более конкретные рекомендации по решению проблемы.

Для перехода с версии 1.1 на версию 2 следуйте инструкциям, представленным в Руководстве по миграции версии 2 .

v2

• Адрес конечной точки сервиса был изменен:

  конечная точка службы v1	конечная точка сервиса v2
  https://www.googleapis.com/doubleclickbidmanager	https://doubleclickbidmanager.googleapis.com

• Названия сервисов были изменены следующим образом:

  сервис v1	сервис v2
  Запросы	запросы
  Отчеты	запросы.отчеты

• Методы были переименованы следующим образом:

  метод v1	метод v2
  Queries.createquery	запросы.создать
  Запросы.удалить запрос	запросы.удалить
  Queries.getquery	запросы.получить
  Запросы. Список запросов	запросы.список
  Queries.runquery	запросы.запуск
  Reports.listreports	запросы.отчеты.список

• Добавлены следующие методы:

  Услуга	Метод(ы)
  запросы.отчеты	получать

• Следующие методы имеют новое тело ответа:

  Метод	Новый объект тела ответа
  запросы.запуск	Отчет

• Следующие поля были удалены:

  Ресурс	Поле(а)
  queries.list Тело ответа	добрый
  queries.reports.list Response Body	добрый
  Запрос	добрый reportDataEndTimeMs reportDataStartTimeMs код часового пояса
  RunQueryRequest	reportDataEndTimeMs reportDataStartTimeMs код часового пояса

• Тип объекта следующих полей был изменен на следующий:

  Ресурс	Поле(а)	Тип объекта
  Запрос	метаданные параметры расписание	QueryMetadata Параметры QuerySchedule
  Отчет	ключ метаданные параметры	ReportKey ReportMetadata Параметры
  RunQueryRequest	диапазон данных	Диапазон данных

• Добавлены следующие параметры запроса метода:

  Метод	Параметры запроса
  запросы.список	orderBy
  запросы.отчеты.список	orderBy
  запросы.запуск	синхронный

• Следующие параметры запроса метода были удалены:

  Метод	Параметры запроса
  запросы.создать	асинхронный
  запросы.запуск	асинхронный

• Добавлены следующие значения фильтра:

  Значение фильтра
  FILTER_INVENTORY_MEDIA_COST_TYPE
  FILTER_TARGETING_EXPANSION

• Следующие значения фильтра были удалены:

  Значение фильтра
  FILTER_TRUEVIEW_IAR_REGION

• Добавлены следующие значения метрик:

  Значение метрики
  METRIC_STORE_VISIT_VIEW_THROUGH_CONVERSIONS
  METRIC_UNIQUE_REACH_AVERAGE_VIEWABLE_IMPRESSION_FREQUENCY
  METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_CROSS_STACK_FCAP
  METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_PG_FMGMT
  METRIC_UNIQUE_REACH_INCREMENTAL_CLICK_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_IMPRESSION_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_TOTAL_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_VIEWABLE_IMPRESSION_REACH
  METRIC_UNIQUE_REACH_VIEWABLE_IMPRESSION_REACH

Известные проблемы

Никто.

Предыдущие релизы

Чтобы ознакомиться с информацией о предыдущих выпусках API Bid Manager для устаревающих версий, см. архив примечаний к выпуску .