Google Ad Manager API release notes

This page documents production updates to Google Ad Manager API. Check this page for announcements about new or updated features, bug fixes, known issues, and deprecated features.

To get the latest product updates delivered to you, add the URL of this page to your feed reader, or add the feed URL directly: https://developers.google.com/feeds/ad-manager-release-notes.xml.

August 12, 2025

Announcement

In an upcoming release, Report messages will be restructured. These changes are wire compatible, but this change will alter the import paths in client libraries.

Current Type Path New Type Path
Report.Field ReportDefinition.Field
Report.DateRange ReportDefinition.DateRange
Report.Sort ReportDefinition.Sort
Report.Filter ReportDefinition.Filter
Report.Slice ReportDefinition.Slice
Report.Flag ReportDefinition.Flag
Report.ReportType ReportDefinition.ReportType
Report.Dimension ReportDefinition.Dimension
Report.Metric ReportDefinition.Metric
Report.MetricValueType ReportDefinition.MetricValueType
Report.TimePeriodColumn ReportDefinition.TimePeriodColumn
Report.TimeZoneSource ReportDefinition.TimeZoneSource
Report.Value ReportValue
Report.DataTable ReportDataTable
Schedule ScheduleOptions.Schedule
Feature

Added MobileCarrier resource.

Feature

Added MobileDeviceSubmodel resource.

Feature

Added additional Report dimensions and metrics.

Feature

Added ContentBundle resource.

Feature

Added Browser resource.

Feature

Added CmsMetadataValue resource.

Feature

Added methods for reading and writing Contact resources.

Feature

Added DeviceCapability resource.

Feature

Added DeviceManufacturer resource.

June 26, 2025

Change

AdBreak, AdUnit, CustomField , Placement , and Role resources now include fields with default values in responses. Previously, fields with default values like 0 or an empty string were omitted from the response.

Old behavior

{
   "name": "/networks/123/exampleResource/1"
}

New behavior

{
   "name": "/networks/123/exampleResource/1",
   "stringField": "",
   "intField": 0
}
Feature

Added support for Targeting on Private Auction deals.

Feature

Added DeviceCategory resource.

March 11, 2025

Feature

Added support for Ad Breaks.

Fixed

Corrected resource name patterns and grammar in documentation.

Breaking

Refactored type paths for Companies and Reports. This change is wire compatible, but import paths will change for Python client library versions >0.2.4. Other client libraries are not affected.

September 24, 2024

Feature

Added support for Interactive Reporting

Feature

Request ID is set in the HTTP header X-Goog-Correlation-Id for all responses and in the error body for API errors. This ID can be shared with support to assist with troubleshooting.

Breaking

Temporarily removed Closed Beta services that had data discrepancies with the SOAP API:

  • LineItem
  • Creative
  • Contact
  • Label
  • Team

These will be added back when the discrepancies are resolved.

June 18, 2024

Breaking

All DateTime fields have been changed to use RFC3339 timestamp strings.

Feature

Added adUnitSizes resource to list the ad unit sizes available in a network.