Release notes

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

Latest API version: v2

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 resources using sunset values in params.groupBy 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 resources with a params.type of YOUTUBE and a relevant metric value in params.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 and Report resources results in an error.

The following ReportType values are sunset:

  • FULL_PATH
  • PATH_ATTRIBUTION

The pathQueryOptions field of the 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 are sunset. The following Bid Manager API metric values 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 and 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 method instead of having them run automatically after creation.

Replaced the queries.run query parameter asynchronous with synchronous.

Simplified report retrieval through the following changes:

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 to migrate from v1.1 to v2.

v2

Known issues

None.

Previous releases

To read about previous Bid Manager API releases for sunset versions, see our archived release notes.