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

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

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

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

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

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

v2

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

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

1 марта 2025 г.

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

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

v2

• Следующие значения перечисления устарели:

  Перечисление	Ценности)
  ReportType	INVENTORY_AVAILABILITY

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

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

  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 — закат.

Создание или запуск ресурсов 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 также имеет статус sunset.

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 v2.

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

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

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

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

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

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

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

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

v2

• Конечная точка службы была изменена:

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

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

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

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

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

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

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

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

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

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

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

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

  Ресурс	Поле(я)	Тип объекта
  Запрос	метаданные параметры расписание	ЗапросМетаданных Параметры ЗапросРасписание
  Отчет	ключ метаданные параметры	ReportKey ОтчетМетаданные Параметры
  RunQueryRequest	dataRange	DataRange

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

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

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

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

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

  Значение фильтра
  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 для устаревших версий, ознакомьтесь с нашими архивными заметками о выпуске .