This page provides release notes for the Google Bid Manager API.

**Latest API version: v2**

## September 22, 2025

### Known issues

Sunsetting three `Filter` enum values due to low use, as previously announced in
the [Display \& Video 360 help center](https://support.google.com/displayvideo/answer/16544983#September_2025_Deprecation_of_low-use_Dimensions_and_Metrics).

> [!WARNING]
> **Correction:** At publication, this release note incorrectly listed the `Filter` value `FILTER_INSERTION_ORDER` as deprecated. This note has been updated to include the correct value `FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_INSERTION_ORDER`.

#### v2

- The following `https://developers.google.com/bid-manager/reference/rest/v2/filters-metrics#filters` have been deprecated:

  | `Filter` value(s) |
  |---|
  | `FILTER_DFP_ORDER_ID` `FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_INSERTION_ORDER` `FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_PARTNER` |

## March 1, 2025

### Known issues

Sunsetting YouTube Trueview inventory availability report and related
dimensions as previously announced in the [Display \& Video 360 help
center](https://support.google.com/displayvideo/answer/15874746).

#### v2

- The following [filters](https://developers.google.com/bid-manager/reference/rest/v2/filters-metrics#filters) have been deprecated:

  | Filter value(s) |
  |---|
  | `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` |

- The following [metrics](https://developers.google.com/bid-manager/reference/rest/v2/filters-metrics#metrics) have been deprecated:

  | Metric value(s) |
  |---|
  | `METRIC_POTENTIAL_VIEWS` `METRIC_TEA_TRUEVIEW_IMPRESSIONS` `METRIC_TEA_TRUEVIEW_UNIQUE_COOKIES` |

## November 20, 2024

### New features

The `FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID` is launched. This allows the inclusion
of lower confidence data for metrics with the following prefixes:

- `METRIC_UNIQUE_REACH_`
- `METRIC_VIRTUAL_PEOPLE_DUPLICATE_`
- `METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_`
- `METRIC_VIRTUAL_PEOPLE_OVERLAP_`

One of the relevant metrics must be included when using this filter.

Upon launch, queries that don't include this filter will default to the
previous default behavior of only including high-confidence data. On and after
**February 4, 2025**, queries that do not include this filter will default to
include lower-confidence data.

#### v2

- The following filters have been added:

  | Filter Type | Available values |
  |---|---|
  | `FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID` | `0`: Include lower-confidence data. (Default after **February 4, 2025**) `1`: Only include high-confidence data. (Default before **February 4, 2025**) |

## October 1, 2024

### New features

None.

### Known issues

#### v2

##### Sunset of Anonymous Inventory Modeling (AIM) reporting dimension

The `FILTER_ANONYMOUS_INVENTORY_MODELING` dimension is sunset.

Creating or running [`Query`](https://developers.google.com/bid-manager/reference/rest/v2/queries#Query)
resources using sunset values in
[`params.groupBy`](https://developers.google.com/bid-manager/reference/rest/v2/Parameters#FIELDS.group_bys)
returns a `400` error.

##### DST/ROC (Regulatory Operating Costs) and Total Media Cost metrics made incompatible with `YOUTUBE` reports.

The following metric values can no longer be used in `YOUTUBE` reports:

- `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`

Creating or running [`Query`](https://developers.google.com/bid-manager/reference/rest/v2/queries#Query)
resources with a
[`params.type`](https://developers.google.com/bid-manager/reference/rest/v2/Parameters#FIELDS.type) of
`YOUTUBE` and a relevant metric value in
[`params.metrics`](https://developers.google.com/bid-manager/reference/rest/v2/Parameters#FIELDS.metrics)
returns a `400` error.

## May 1, 2024

### New features

None.

### Known issues

#### v2

##### Sunset of Full Path and Path Attribution Reports

Full Path and Path Attribution reports are sunset. Retrieving or creating these
types of [`Query`](https://developers.google.com/bid-manager/reference/rest/v2/queries#Query) and
[`Report`](https://developers.google.com/bid-manager/reference/rest/v2/queries.reports#Report) resources
results in an error.

The following
[`ReportType`](https://developers.google.com/bid-manager/reference/rest/v2/Parameters#ReportType) values are
sunset:

- `FULL_PATH`
- `PATH_ATTRIBUTION`

The
`pathQueryOptions`
field of the
[`Options`](https://developers.google.com/bid-manager/reference/rest/v2/Parameters#Options) object is also
sunset.

## February 28, 2024

### New features

None.

### Known issues

#### v2

##### Sunset of cross-device conversion metric values

[Cross-device conversion
metrics](https://support.google.com/campaignmanager/answer/14190111) are sunset.
The following Bid Manager API [metric
values](https://developers.google.com/bid-manager/reference/rest/v2/filters-metrics) are included:

- `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`

## July 6, 2022

### New features

Released Bid Manager API v2.

Made structural changes to the API, including updating the service
endpoint and renaming services and methods.

Significantly updated [Query](https://developers.google.com/bid-manager/reference/rest/v2/queries#Query) and [Report](https://developers.google.com/bid-manager/reference/rest/v2/queries.reports#Report) resources by
removing unnecessary fields, reorganizing existing fields, and changing field
types. This includes changing field types to use named objects instead of a
general "nested object" definition.

Required running ad-hoc queries using the [`queries.run`](https://developers.google.com/bid-manager/reference/rest/v2/queries/run) method
instead of having them run automatically after creation.

Replaced the [`queries.run`](https://developers.google.com/bid-manager/reference/rest/v2/queries/run) query parameter `asynchronous` with
[`synchronous`](https://developers.google.com/bid-manager/reference/rest/v2/queries/run#body.QUERY_PARAMETERS.synchronous).

Simplified report retrieval through the following changes:

- The addition of a [`queries.reports.get`](https://developers.google.com/bid-manager/reference/rest/v2/queries.reports/get) method.
- The addition of an [`orderBy`](https://developers.google.com/bid-manager/reference/rest/v2/queries.reports/list#body.QUERY_PARAMETERS.order_by) query parameter to [`queries.reports.list`](https://developers.google.com/bid-manager/reference/rest/v2/queries.reports/list).
- The update of the [`queries.run`](https://developers.google.com/bid-manager/reference/rest/v2/queries/run) response body from an empty object to an instance of the generated [`Report`](https://developers.google.com/bid-manager/reference/rest/v2/queries.reports#Report) resource.

Updated error messages returned by the API to be more specific and provide more
prescriptive solutions.

Follow the instructions presented in the [v2 Migration Guide](https://developers.google.com/bid-manager/how-tos/v2-migration) to
migrate from v1.1 to v2.

#### v2

- The service endpoint has been changed:

  | v1 service endpoint | v2 service endpoint |
  |---|---|
  | `https://www.googleapis.com/doubleclickbidmanager` | `https://doubleclickbidmanager.googleapis.com` |

- Services have been renamed as follows:

  | v1 service | v2 service |
  |---|---|
  | [Queries](https://developers.google.com/bid-manager/v1.1/queries) | [queries](https://developers.google.com/bid-manager/reference/rest/v2/queries) |
  | [Reports](https://developers.google.com/bid-manager/v1.1/reports) | [queries.reports](https://developers.google.com/bid-manager/reference/rest/v2/queries.reports) |

- Methods have been renamed as follows:

  | v1 method | v2 method |
  |---|---|
  | [Queries.createquery](https://developers.google.com/bid-manager/v1.1/queries/createquery) | [queries.create](https://developers.google.com/bid-manager/reference/rest/v2/queries/create) |
  | [Queries.deletequery](https://developers.google.com/bid-manager/v1.1/queries/deletequery) | [queries.delete](https://developers.google.com/bid-manager/reference/rest/v2/queries/delete) |
  | [Queries.getquery](https://developers.google.com/bid-manager/v1.1/queries/getquery) | [queries.get](https://developers.google.com/bid-manager/reference/rest/v2/queries/get) |
  | [Queries.listqueries](https://developers.google.com/bid-manager/v1.1/queries/listqueries) | [queries.list](https://developers.google.com/bid-manager/reference/rest/v2/queries/list) |
  | [Queries.runquery](https://developers.google.com/bid-manager/v1.1/queries/runquery) | [queries.run](https://developers.google.com/bid-manager/reference/rest/v2/queries/run) |
  | [Reports.listreports](https://developers.google.com/bid-manager/v1.1/reports/listreports) | [queries.reports.list](https://developers.google.com/bid-manager/reference/rest/v2/queries.reports/list) |

- The following methods have been added:

  | Service | Method(s) |
  |---|---|
  | [queries.reports](https://developers.google.com/bid-manager/reference/rest/v2/queries.reports) | [get](https://developers.google.com/bid-manager/reference/rest/v2/queries.reports/get) |

- The following methods have a new response body:

  | Method | New response body object |
  |---|---|
  | [queries.run](https://developers.google.com/bid-manager/reference/rest/v2/queries/run) | [Report](https://developers.google.com/bid-manager/reference/rest/v2/queries.reports#Report) |

- The following fields have been removed:

  | Resource | Field(s) |
  |---|---|
  | [`queries.list` Response Body](https://developers.google.com/bid-manager/reference/rest/v2/queries/list#response-body) | kind |
  | [`queries.reports.list` Response Body](https://developers.google.com/bid-manager/reference/rest/v2/queries.reports/list#response-body) | kind |
  | [Query](https://developers.google.com/bid-manager/reference/rest/v2/queries#Query) | kind reportDataEndTimeMs reportDataStartTimeMs timezoneCode |
  | [RunQueryRequest](https://developers.google.com/bid-manager/reference/rest/v2/queries/run#RunQueryRequest) | reportDataEndTimeMs reportDataStartTimeMs timezoneCode |

- The object type of the following fields have been changed to the following:

  | Resource | Field(s) | Object Type |
  |---|---|---|
  | [Query](https://developers.google.com/bid-manager/reference/rest/v2/queries#Query) | [metadata](https://developers.google.com/bid-manager/reference/rest/v2/queries#Query.FIELDS.metadata) [params](https://developers.google.com/bid-manager/reference/rest/v2/queries#Query.FIELDS.params) [schedule](https://developers.google.com/bid-manager/reference/rest/v2/queries#Query.FIELDS.schedule) | [QueryMetadata](https://developers.google.com/bid-manager/reference/rest/v2/queries#QueryMetadata) [Parameters](https://developers.google.com/bid-manager/reference/rest/v2/Parameters) [QuerySchedule](https://developers.google.com/bid-manager/reference/rest/v2/queries#QuerySchedule) |
  | [Report](https://developers.google.com/bid-manager/reference/rest/v2/queries.reports#Report) | [key](https://developers.google.com/bid-manager/reference/rest/v2/queries.reports#Report.FIELDS.key) [metadata](https://developers.google.com/bid-manager/reference/rest/v2/queries.reports#Report.FIELDS.metadata) [params](https://developers.google.com/bid-manager/reference/rest/v2/queries.reports#Report.FIELDS.params) | [ReportKey](https://developers.google.com/bid-manager/reference/rest/v2/queries.reports#ReportKey) [ReportMetadata](https://developers.google.com/bid-manager/reference/rest/v2/queries.reports#ReportMetadata) [Parameters](https://developers.google.com/bid-manager/reference/rest/v2/Parameters) |
  | [RunQueryRequest](https://developers.google.com/bid-manager/reference/rest/v2/queries/run#RunQueryRequest) | [dataRange](https://developers.google.com/bid-manager/reference/rest/v2/queries/run#RunQueryRequest.FIELDS.data_range) | [DataRange](https://developers.google.com/bid-manager/reference/rest/v2/queries#DataRange) |

- The following method query parameters have been added:

  | Method | Query Parameter(s) |
  |---|---|
  | [queries.list](https://developers.google.com/bid-manager/reference/rest/v2/queries/list) | [orderBy](https://developers.google.com/bid-manager/reference/rest/v2/queries/list#body.QUERY_PARAMETERS.order_by) |
  | [queries.reports.list](https://developers.google.com/bid-manager/reference/rest/v2/queries.reports/list) | [orderBy](https://developers.google.com/bid-manager/reference/rest/v2/queries.reports/list#body.QUERY_PARAMETERS.order_by) |
  | [queries.run](https://developers.google.com/bid-manager/reference/rest/v2/queries/run) | [synchronous](https://developers.google.com/bid-manager/reference/rest/v2/queries/run#body.QUERY_PARAMETERS.synchronous) |

- The following method query parameters have been removed:

  | Method | Query Parameter(s) |
  |---|---|
  | [queries.create](https://developers.google.com/bid-manager/reference/rest/v2/queries/create) | asynchronous |
  | [queries.run](https://developers.google.com/bid-manager/reference/rest/v2/queries/run) | asynchronous |

- The following Filter values have been added:

  | Filter value |
  |---|
  | FILTER_INVENTORY_MEDIA_COST_TYPE |
  | FILTER_TARGETING_EXPANSION |

- The following Filter values have been removed:

  | Filter value |
  |---|
  | FILTER_TRUEVIEW_IAR_REGION |

- The following Metric values have been added:

  | Metric value |
  |---|
  | 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 |

### Known issues

None.

## Previous releases

To read about previous Bid Manager API releases for sunset versions, see our
[archived release notes](https://developers.google.com/bid-manager/release-notes-archive).