Google Ads Developer Blog: ad_manager

New Google Ad Manager API read-only scope

пʼятниця, 27 березня 2026 р.

The Ad Manager API now supports a read-only OAuth scope. This new scope, https://www.googleapis.com/auth/admanager.readonly, allows developers to request read-only access to their users' Ad Manager data.This new scope is only available for the Ad Manager API. It is not supported by the legacy Ad Manager SOAP API, which will continue to require the full-access scope.The read-only scope allows reading data and running reports, but does not grant permission to write or modify data. This provides an enhanced security layer for developers and users of read-only integrations, such as reporting dashboards or alerting tools.No action is required for existing integrations. If your application does not require write access, we recommend migrating to the new read-only scope. For a refresher on how to configure OAuth, see Using Oauth 2.0 for Web Server Authentication.As always, Ad Manager access controls, including User roles and Restrictions imposed by teams, are applied to all API requests regardless of the OAuth scope used. If you have any questions or want to discuss this post, reach out to us on our Google Advertising and Measurement Community Discord server.

- Chris Seeley, Ad Manager API Team

Announcing v202511 of the Google Ad Manager API

середа, 19 листопада 2025 р.

We're pleased to announce that v202511 of the Google Ad Manager API is available now. This release provides support for targeting Publisher Provided Signals using PublisherProvidedSignalsTargeting. You can also check the declaration status of Ad technology providers using ThirdPartyDataDeclarationStatus on Creatives, and read the verifiedExchangeAdvertiserdId on Companies. For the full list of changes, check the release notes. Contact us on the Ad Manager API forum with any API-related questions.

- Chris Seeley, Ad Manager API Team

Join our “Google Advertising and Measurement Community” Discord Server

вівторок, 8 липня 2025 р.

We’re launching our new “Google Advertising and Measurement Community” Discord server! To join, just click this invite link and follow the onboarding guide. The current products available on this server are Analytics, Google Ads, Google AdMob, and Google Ad Manager. The Ads Developer Relations team will be on this server regularly to discuss your feedback or questions using Google’s Advertising and Analytics APIs/SDKs, as well as to let you know what’s new with our products. We’ll be hosting a “Meet the Team” in August, where we’ll go over who we are, and how you can expect to engage with us in Discord. Stay tuned as we add other events, and more channels. Looking forward to chatting with you on Discord!

- Cory Liseno, on behalf of the Ads Developer Relations Team

Announcing v202502 of the Google Ad Manager API

середа, 26 лютого 2025 р.

We're pleased to announce that v202502 of the Google Ad Manager API is now available. This is a maintenance release to add new error types for entity limits. For the full list of changes, check the release notes. Contact us on the Ad Manager API forum with any API-related questions.

- Chris Seeley, Ad Manager API Team

Announcing v202411 of the Google Ad Manager API

четвер, 21 листопада 2024 р.

We're pleased to announce that v202411 of the Google Ad Manager API is available starting today, November 21, 2024. This release brings support for INVENTORY_FORMAT reporting dimensions and removes GOOGLE as a GrpProvider. In the PublisherQueryLanguageService Line_Item table, the field EndDateTime has been renamed to ServingEndTime. In both v202411 and earlier versions, the value is inclusive of any grace period. The new name differentiates the PQL field from the LineItem.endDateTime field which is exclusive of any grace period.

Version

Service

End time including grace period

End time excluding grace period

v202411

PublisherQueryLanguageService

ServingEndTime

Not available

LineItemService

endDateTime + autoExtensionDays

endDateTime

v202408

PublisherQueryLanguageService

EndDateTime

Not available

LineItemService

endDateTime + autoExtensionDays

endDateTime

For the full list of changes, check the release notes. Contact us on the Ad Manager API forum with any API-related questions.

- Chris Seeley, Ad Manager API Team

Subscribe to the blog

четвер, 19 вересня 2024 р.

RSS feedcommunity resource on GitHub

Structured Data Files

IMA SDK

Mobile Ads SDK

- Mike Cloonan, Ads DevRel Team

Announcing v202408 of the Google Ad Manager API

середа, 21 серпня 2024 р.

We're pleased to announce that v202408 of the Google Ad Manager API is available starting today, August 21, 2024. This release brings support for setting contextual targeting with ContentLabelTargeting and VerticalTargeting. It also adds AdsTxtService for reading MCM supply chain diagnostics. In reporting, the VIDEO_PLACEMENT_NAME dimension has been replaced by the VIDEO_PLCMT_NAME dimension which reflects the updated IAB definition. For the full list of changes, check the release notes. Contact us on the Ad Manager API forum with any API-related questions.

- Chris Seeley, Ad Manager API Team

Announcing v202405 of the Google Ad Manager API

пʼятниця, 24 травня 2024 р.

We're pleased to announce that v202405 of the Google Ad Manager API is available today. This release brings support for contextual targeting. It also includes a number of deprecations, such as the removal of the ActivityService, ActivityGroupService, and ACTIVITY reporting dimensions to support the Spotlight deprecation. For the full list of changes, check the release notes. Feel free to contact us on the Ad Manager API forum with any API-related questions.

- Chris Seeley, Ad Manager API Team

Announcing v202402 of the Google Ad Manager API

середа, 14 лютого 2024 р.

We're pleased to announce that v202402 of the Google Ad Manager API is available starting today, February 13, 2024. This release brings support for gross revenue metrics in reporting as well as new error messages to support the Spotlight deprecation. For the full list of changes, check the release notes. Feel free to contact us on the Ad Manager API forum with any API-related questions.

- Chris Seeley, Ad Manager API Team

Announcing v202311 of the Google Ad Manager API

середа, 8 листопада 2023 р.

We're pleased to announce that v202311 of the Google Ad Manager API is available starting today, November 8, 2023. This release brings support for marketplace ID on Proposals and consolidates MCM Child Network information in the Company object, removing the Network.childPublishers field. For the full list of changes, check the release notes. Feel free to contact us on the Ad Manager API forum with any API-related questions.

- Chris Seeley, Ad Manager API Team

Announcing v202308 of the Google Ad Manager API

вівторок, 22 серпня 2023 р.

We're pleased to announce that v202308 of the Google Ad Manager API is available starting today, August 23, 2023. This release brings support for new ThirdPartyMeasurementSettings providers. For the full list of changes, check the release notes. Feel free to contact us on the Ad Manager API forum with any API-related questions.

- Chris Seeley, Ad Manager API Team

Announcing v202305 of the Google Ad Manager API

середа, 24 травня 2023 р.

We're pleased to announce that v202305 of the Google Ad Manager API is available starting today, May 23rd. This release brings support for new DAI ingestion statuses and removes deprecated SPM reporting dimensions. For the full list of changes, check the release notes. Feel free to contact us on the Ad Manager API forum with any API-related questions.

- Chris Seeley, Ad Manager API Team

Removing support for PHP 7 in the Google Ad Manager SOAP API Client Library for PHP

середа, 26 квітня 2023 р.

In August 2023, the Google Ad Manager SOAP API Client Library for PHP will start requiring PHP version 8.0 or higher. The version of the client library that adds support for Google Ad Manager API v202305 will be the last version that supports PHP 7. We’ll still fix security issues for this client library version until Google Ad Manager API v202305 is sunset, but no new features will be added. All PHP 7 versions reached their end of life in 2022. The PHP development team no longer provides security fixes for these versions, so we highly recommend migrating to newer versions as soon as possible. Here are useful resources to help with the PHP migration:

The PHP support version calendar

How to migrate from PHP 7.4.x to PHP 8.0.x

If you have any questions regarding this change, feel free to comment directly on the GitHub issue.

Pierrick Voulet, Google Ads API Team

Ad Manager API v202205 sunset and v202202 extension

вівторок, 25 квітня 2023 р.

On Wednesday, May 31, 2023, in accordance with the deprecation schedule, v202205 of the Ad Manager API will sunset. At that time, any requests made to this version will return errors. Additionally, support for Ad Manager API v202202 is being extended until the same date, May 31, 2023. We've heard from a number of users that they need additional time to complete the Ad Exchange Historical report migration. Note that v202202 is the last version with support for Ad Exchange Historical reports. When you’re ready to upgrade, check the full release notes to identify any breaking changes. Here are a few examples of changes that may impact your applications:

v202211

Replaced the string field thirdPartyImpressionTrackingUrl with the list field thirdPartyImpressionTrackingUrls for multiple creative types including ImageCreative. Currently only a single URL may be provided in the list.
Removed support for OPTIMIZATION reporting columns.

As always, feel free to contact us on the developer forum with any questions.

- Chris Seeley, Ad Manager API Team

Announcing v202302 of the Google Ad Manager API

середа, 22 лютого 2023 р.

We're pleased to announce that v202302 of the Google Ad Manager API is available starting today, February 21st. This release brings a number of new features for Reporting including Yield Group metrics, Programmatic metrics, and time zone support. For the full list of changes, check the release notes. Feel free to reach out to us on the Ad Manager API forum with any API-related questions.

- Chris Seeley, Ad Manager API Team

Announcing v202211 of the Google Ad Manager API

середа, 2 листопада 2022 р.

v202211ImageCreativethirdPartyImpressionTrackingUrlthirdPartyImpressionTrackingUrlsrelease notesAd Manager API forum

- Chris Seeley, Ad Manager API Team

Announcing v202208 of the Google Ad Manager API

вівторок, 16 серпня 2022 р.

We're pleased to announce that v202208 of the Google Ad Manager API is available starting today, August 16th. This release adds support for AMP URLs in ThirdPartyCreatives, InventorySizeTargeting in traffic forecasts, and Real-time video reporting. For the full list of changes, check the release notes. Feel free to reach out to us on the Ad Manager API forum with any API-related questions.

- Chris Seeley, Ad Manager API Team

Announcing v202205 of the Google Ad Manager API

вівторок, 17 травня 2022 р.

We're pleased to announce that v202205 of the Google Ad Manager API is available starting today, May 17th. This release adds support for CPM sponsorships for ProposalLineItems. It also updates the ReportService for the upcoming "Ad Exchange Historical" to "Historical" report type conversion. Ad Exchange Historical dimensions and metrics are now available for Historical reports. Because of this change, several Ad Exchange dimensions and metrics have been renamed or replaced in the API. To migrate, please refer to the migration guide and the reference documentation for v202202 and earlier. The reference documentation has been updated to show which values are deprecated and their replacements. Here’s an example:

Enumeration

Description

AD_EXCHANGE_IMPRESSIONS

Ad Impressions on mapped Ad Exchange properties. When multiple text ads fill a single display slot it is only counted once, when the top text ad is recognized. In these cases, the Ad Impression is attributed to the top text ad.
Deprecated as part of the "Ad Exchange Historical" to "Historical" report type conversion. Use AD_EXCHANGE_LINE_ITEM_LEVEL_IMPRESSIONS instead.

For the full list of changes, check the release notes. Feel free to reach out to us on the Ad Manager API forum with any API-related questions.

- Chris Seeley, Ad Manager API Team

Sunset of the Ad Manager API v202105

середа, 11 травня 2022 р.

deprecation schedulevideo opportunity Columnsrelease notes

v202108

The deprecated adExchangeEnvironment field has been removed from ProposalLineItem. To control which platforms your ProposalLineItem will serve on, you can use requestPlatformTargeting instead.
On the MobileApplication object, the singular field appStore was changed to the list field appStores.

v202202

The deprecated pauseRole and pauseReason fields were removed from Proposals. These fields have been available on ProposalLineItems since v202108.
The deprecated exchangeRate and refreshExchangeRate fields were removed from Proposals.

the developer forum

- Donovan McMurray, Ad Manager API Team

Announcing v202202 of the Google Ad Manager API

понеділок, 28 лютого 2022 р.

We're pleased to announce that v202202 of the Google Ad Manager API is available starting today, February 28th. This release brings a long-awaited feature – Ad Manager hosted video creatives. Simply provide a URL for the video asset, and Ad Manager will read and transcode it. While API support has been added, this feature is still rolling out to Ad Manager networks and may not yet be available in yours. Networks with this feature disabled will continue to receive CreativeSetError.CANNOT_CREATE_OR_UPDATE_VIDEO_CREATIVES. MCM companies now include information about the status of onboarding tasks and Sellers.json identifiers. There are also some maintenance updates removing deprecated features, like AdExclusionRuleService and Proposal pause information. For the full list of changes, check the release notes. Feel free to reach out to us on the Ad Manager API forum with any API-related questions.

- Chris Seeley, Ad Manager API Team

Ads Developer Blog

New Google Ad Manager API read-only scope

Announcing v202511 of the Google Ad Manager API

Join our “Google Advertising and Measurement Community” Discord Server

Announcing v202502 of the Google Ad Manager API

Announcing v202411 of the Google Ad Manager API

Subscribe to the blog

Announcing v202408 of the Google Ad Manager API

Announcing v202405 of the Google Ad Manager API

Announcing v202402 of the Google Ad Manager API

Announcing v202311 of the Google Ad Manager API

Announcing v202308 of the Google Ad Manager API

Announcing v202305 of the Google Ad Manager API

Removing support for PHP 7 in the Google Ad Manager SOAP API Client Library for PHP

Ad Manager API v202205 sunset and v202202 extension

Announcing v202302 of the Google Ad Manager API

Announcing v202211 of the Google Ad Manager API

Announcing v202208 of the Google Ad Manager API

Announcing v202205 of the Google Ad Manager API

Sunset of the Ad Manager API v202105

Announcing v202202 of the Google Ad Manager API

Мітки

Archive