Tag Archives: ad_manager_api

Announcing v202205 of the Google Ad Manager API

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.

Sunset of the Ad Manager API v202105

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

If you’re still using v202105, now is the time to upgrade to a newer release and take advantage of additional functionality. For example, in v202111 and newer versions we added new video opportunity Columns.

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:
  • 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.
As always, don't hesitate to reach out to us on the developer forum with any questions.

Announcing v202202 of the Google Ad Manager API

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.

Sunset of the Ad Manager API v202102

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

If you’re still using v202102, now is the time to upgrade to a newer release and take advantage of additional functionality. For example, in v202105 and newer versions 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:

As always, don't hesitate to reach out to us on the developer forum with any questions.

Announcing v202111 of the Google Ad Manager API

We're pleased to announce that v202111 of the Google Ad Manager API is available starting today. This release brings new video features including more Video Opportunity metrics and GRP settings for proposal line items.

Additionally, MCM users can now programmatically resend expired invitations using the new ResendInvitationAction. For altering revenue share or re-inviting an inactive child publisher, continue to use the ReInviteAction.

For the full list of changes for v202111 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.

Sunset of the Ad Manager API v202011

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

If you’re still using v202011, now is the time to upgrade to a newer release and take advantage of additional functionality. For example, in v202102 we added support for AudioCreatives, and 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
    • The AuthenticationError enum value NOT_WHITELISTED_FOR_API_ACCESS was changed to NETWORK_API_ACCESS_DISABLED.
    • The LineItem fields isPrioritizedPreferredDealsEnabled and adExchangeAuctionOpeningPriority were removed.
    • For video Line Items, the videoMaxDuration field is now required and must be greater than 0.
  • v202105
  • v202108
    • On the MobileApplication object, the singular field appStore was changed to the list field appStores.

As always, don't hesitate to reach out to us on the developer forum with any questions.

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.

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.

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.

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.