Tag Archives: ad_manager_api

Announcing v202108 of the Google Ad Manager API

We're happy to announce that v202108 of the Google Ad Manager API is available starting today. This release brings new proposal line item features including a pauseRole and pauseReason, as well as support for Nielsen Digital Ad Ratings.

There are also some updates for MobileApplications, like changing the singular appStore to the list field appStores and adding an applicationCode field. This field contains the same code used to identify the app in the Google Mobile Ads SDK.

For the full list of changes for v202108 and all other active API versions, 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 v202008

On Tuesday, August 31, 2021, in accordance with the deprecation schedule, v202008 of the Ad Manager API will sunset. At that time, any requests made to this version will return errors.

If you’re still using v202008, now is the time to upgrade to a newer release and take advantage of additional functionality. For example, in v202105 we added support for pushing creative previews to linked devices.

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:
  • v202102
    • We renamed an AuthenticationError enum value from NOT_WHITELISTED_FOR_API_ACCESS to NETWORK_API_ACCESS_DISABLED.
    • We removed deprecated LineItem fields isPrioritizedPreferredDealsEnabled and adExchangeAuctionOpeningPriority.
  • v202105
As always, don't hesitate to reach out to us on the developer forum with any questions.
 - Donovan McMurray, Ad Manager API Team

Announcing v202105 of the Google Ad Manager API

We're happy to announce that v202105 of the Google Ad Manager API is available starting today. With this release, Creative Previews are going mobile! You can now push creatives to multiple linked devices using the new LineItemCreativeAsociationService.pushCreativeToDevices method and Linked_Device PQL table.

This release also brings support for pause controls for programmatic proposals and new ReportService features like Inventory Share dimensions.


For the full list of changes for v202105 and all other active API versions, 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 v202005

On Tuesday, June 1, 2021, in accordance with the deprecation schedule, v202005 of the Ad Manager API will sunset. At that time, any requests made to this version will return errors.

If you’re still using v202005, now is the time to upgrade to a newer release and take advantage of additional functionality. For example, in v202102 we added support for AudioCreative types.

When you’re ready to upgrade, check the full release notes to identify any breaking changes. For instance, starting in v202008, we replaced the singular LineItem.viewabilityProviderCompanyId field with viewabilityProviderCompanyIds for specifying a list of IDs.

As always, don't hesitate to reach out to us on the developer forum with any questions.
 - Donovan McMurray, Ad Manager API Team

Announcing v202102 of the Google Ad Manager API

We're happy to announce that v202102 of the Google Ad Manager API is available starting today. Upgrade to this version to take advantage of new functionality, including CreativeSizeType.IGNORED for click-tracking entities, where size doesn't matter, or for entities that allow all requested sizes, where the size represents all sizes.

Additionally, there are several highly-requested report dimensions added in v202102.

Dimension name Report data break down
BROWSER_NAME Name and version number of the user's browser
VIDEO_PLACEMENT_NAME Video placement (e.g., in-article, in-stream, and in-feed)
CLASSIFIED_YIELD_PARTNER_NAME Detected yield partner name, as classified by Google
DOMAIN Top private domain, such as "example.co.uk" (excludes subdomains)


Finally, if you use the Ad Manager API to create video LineItems, v202102 now requires that LineItem.videoMaxDuration is greater than 0. This new validation applies to newly created video LineItems as well as updates. If you think you might be affected, you should update any code that creates video LineItems to set videoMaxDuration to be greater than 0 and scan your network for existing video LineItems with videoMaxDuration set to 0.

For the full list of changes for v202102 and all other active API versions, check the release notes. Feel free to reach out to us on the Ad Manager API forum with any API-related questions.
 - , Ad Manager API Team

Announcing v202102 of the Google Ad Manager API

We're happy to announce that v202102 of the Google Ad Manager API is available starting today. Upgrade to this version to take advantage of new functionality, including CreativeSizeType.IGNORED for click-tracking entities, where size doesn't matter, or for entities that allow all requested sizes, where the size represents all sizes.

Additionally, there are several highly-requested report dimensions added in v202102.

Dimension name Report data break down
BROWSER_NAME Name and version number of the user's browser
VIDEO_PLACEMENT_NAME Video placement (e.g., in-article, in-stream, and in-feed)
CLASSIFIED_YIELD_PARTNER_NAME Detected yield partner name, as classified by Google
DOMAIN Top private domain, such as "example.co.uk" (excludes subdomains)


Finally, if you use the Ad Manager API to create video LineItems, v202102 now requires that LineItem.videoMaxDuration is greater than 0. This new validation applies to newly created video LineItems as well as updates. If you think you might be affected, you should update any code that creates video LineItems to set videoMaxDuration to be greater than 0 and scan your network for existing video LineItems with videoMaxDuration set to 0.

For the full list of changes for v202102 and all other active API versions, check the release notes. Feel free to reach out to us on the Ad Manager API forum with any API-related questions.
 - , Ad Manager API Team

Sunset of the Ad Manager API v202002

On Monday, March 1, 2021, in accordance with the deprecation schedule, v202002 of the Ad Manager API will sunset. At that time, any requests made to this version will return errors.

If you’re still using v202002, now is the time to upgrade to a newer release and take advantage of additional functionality. For example, in v202011 we added the getTrafficData method to the ForecastService, which is capable of exploring historical and forecasted network-level data for a particular date range and targeting configuration.

When you’re ready to upgrade, check the full release notes to identify any breaking changes. Keep in mind that v202002 is the final version to use int types for Activity and ActivityGroup, and all later versions use type long. After you’ve considered all of the changes, grab the latest version of your client library and update your code.

As always, don't hesitate to reach out to us on the developer forum with any questions.
 - Donovan McMurray, Ad Manager API Team

Sunset of the Ad Manager API v201911

On Monday, November 30, 2020, in accordance with the deprecation schedule, v201911 of the Ad Manager API will sunset. At that time, any requests made to this version will return errors.

If you’re still using v201911, now is the time to upgrade to a newer release and take advantage of additional functionality. For example, in v202002 we added a number of video and reporting features.

When you’re ready to upgrade, check the full release notes to identify any breaking changes, like Activity and ActivityGroup IDs changing from type int to type long in v202005. Then, grab the latest version of your client library and update your code.
As always, don't hesitate to reach out to us on the developer forum with any questions.
 - Donovan McMurray, Ad Manager API Team

Announcing v202008 of the Google Ad Manager API

We're happy to announce that v202008 of the Google Ad Manager API is available starting today. Upgrade to this version to take advantage of new functionality, like support for Audio Ads and the ability to specify multiple Viewability Provider Companies on a LineItem.

If you work with video ads, there are several new useful features available to you in v202008:
  • We’ve added nielsenCtvPacingType for specifying the pacing computation method for impressions on connected devices for a Nielsen measured LineItem.
  • You can now call the performCmsMetadataKeyAction to activate and deactivate CmsMetadataKeys.
For the full list of changes for v202008 and all other active API versions, check the release notes. Feel free to reach out to us on the Ad Manager API forum with any API-related questions.
 - , Ad Manager API Team

Sunset of the Ad Manager API v201908

On Monday, August 31, 2020, in accordance with the deprecation schedule, v201908 of the Ad Manager API will sunset. At that time, any requests made to this version will return errors.

If you’re still using v201908, now is the time to upgrade to a newer release and take advantage of additional functionality. For example, in v201911 we improved reporting error messages and added the ability to break down reports by CMS Metadata.

When you’re ready to upgrade, check the full release notes to identify any breaking changes, like Activity and ActivityGroup IDs changing from type int to type long in v202005. Then, grab the latest version of your client library and update your code.

As always, don't hesitate to reach out to us on the developer forum with any questions.
 - Donovan McMurray, Ad Manager API Team