Google Ads Developer Blog: sunset

Sunset of the Ad Manager API v202002

Thursday, January 28, 2021

deprecation schedulegetTrafficDataForecastServicerelease notesintActivityActivityGroupall later versions use type longthe developer forum

- Donovan McMurray, Ad Manager API Team

Google Ads API v3 sunset reminder

Thursday, January 7, 2021

Google Ads API v3 will sunset on February 10, 2021. After this date, all v3 API requests will begin to fail. Please migrate to a newer version prior to February 10, 2021 to ensure your API access is unaffected. We've prepared various resources to help you with the migration:

Upgrading to the newest version

Release notes

If you have questions while you’re upgrading, please reach out to us on the forum or at googleadsapi-support@google.com.

- Thanet Knack Praneenararat, Google Ads API Team

Upcoming sunset for DBM API v1, SDF Download and Line Item services

Monday, November 30, 2020

As announced in August, deprecated services in the DoubleClick Bid Manager (DBM) API, comprised of DBM API v1, the DBM API v1.1 SDF Download service, and the DBM API v1.1 Line Item service, will be sunset on February 26, 2021.

If you are still using the DBM API v1 Reporting service, you must migrate to the DBM API v1.1 Reporting service before the sunset date to avoid an interruption of service. Consult the API release notes for details of the changes between v1 and v1.1. Differences to note during this migration include:

Queries created and accessed through the Reporting service require more specific filters in the params.groupBy field in v1.1. You might have to add more values to the params.groupBy field in order to create the same report structure generated in v1.
Responses from queries.listqueries and reports.listreports calls are paginated in v1.1. You have to update your implementation to traverse multiple pages if you want to consume more than the first 100 items returned.

If you are using any version of any other DBM API service, you must migrate to the Display & Video 360 (DV360) API.

Guides are available to help you set up and start using the Display & Video 360 API to download SDFs and manage your line items.

If you encounter issues with your migration or want to report a separate issue, please contact us using our support contact form.

- Trevor Mulchay, Display & Video 360 API Team

Sunset of deprecated Geo Region targeting options in Display & Video 360 API

Friday, November 20, 2020

Starting January 2021, over 1500 deprecated Geo Region targeting options will no longer be supported in Display & Video 360. This announcement, along with the full list of deprecated options, can be found on the Geography Targeting Help Center article. These deprecated targeting options reflect outdated geographical regions and, therefore, do not change the serving of line items.

How will this happen in the API?

This sunset will be reflected in the Display & Video 360 API through the following sequence of events:

Starting today, we will begin removing deprecated targeting from older resources. These resources consist of Line Items or Insertion Orders that are currently archived or have been paused for more than six months.
In February 2021, the deprecated targeting options will no longer be retrievable through the Targeting Options service and attempts at assigning or removing deprecated targeting through the Line Item Assigned Targeting Options service will return an error.
After the deprecated targeting options are no longer able to be assigned, we will begin removing deprecated targeting from all remaining resources. Any line items only using deprecated targeting will be paused upon the removal of said targeting. This concludes the formal sunset of the deprecated targeting options.

What should I do to prepare for this?

In anticipation of this sunset, it is recommended that you do the following:

Check to see if any existing Line Items utilize deprecated targeting options. Use advertisers.lineItems.targetingTypes.assignedTargetingOptions.list to list the assigned Geo Region targeting for each active line item and check the targeting against the deprecated targeting options. Remove or replace any deprecated targeting as soon as possible using advertisers.lineItems.bulkEditLineItemAssignedTargetingOptions.
If you are storing oft-used targeting option IDs locally, cross-reference them against the list of deprecated targeting options. This will avoid errors caused by attempting to assign sunset targeting options.

Should I expect more deprecations in the future?

Users should expect the occasional deprecation and sunset of targeting options in Display & Video 360 in much smaller quantities than this deprecation. As such, future deprecations likely won’t be announced through a blog post or documentation change.

In order to account for these deprecations, it is recommended that you use targetingTypes.targetingOptions.get to confirm that a targeting option is still available before assigning it. This should be done before assigning any option not obtained through the Targeting Options service, including those stored locally or copied from existing targeting. This will avoid errors caused by attempting to assign deprecated targeting.

You can read more about the Targeting Options and Assigned Targeting Options services in our reference documentation and on the Set Targeting page of our Managing Line Items guide.
If you have questions or run into issues navigating this process, please contact us using our support contact form.

- Trevor Mulchay, Display & Video 360 API Team

Sunset approaching for v2 of the Content API for Shopping

Wednesday, November 11, 2020

We are writing to remind you that the Content API for Shopping v2 will sunset on March 29, 2021. On this date, all requests made against v2 of the Content API will fail. Please migrate to v2.1 as soon as possible to ensure your applications are unaffected. To help with the migration to v2.1, we have prepared the following resources:

Migration guide -- Explains how to update your applications for v2.1.

Supplemental feeds guide — In v2.1, supplemental feeds replace the v2 inventory service for partial updates to online products.

Local inventory service guide — In v2.1, the local inventory service replaces the v2 inventory service for updates to local inventory.

Release notes -- Lists all changes and new features added in v2.1, organized by release date.

If you have questions about the migration or encounter challenges that prevent you from migrating, we want to hear from you. Please reach out to us on the forum so we can help.

Benji Rothman, Content API for Shopping Team

Sunset of the Ad Manager API v201911

Thursday, November 5, 2020

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

Target Spend Migration for Maximize Clicks Bid Strategies

Thursday, October 29, 2020

Starting January 18, 2021, we will start migrating Maximize Clicks bid strategies that still utilize the deprecated target_spend setting to use campaign daily budget pacing instead. This follows last year’s sunset of the target_spend field for Maximize Clicks. After that sunset went into effect, Google Ads has prevented users from creating any new Maximize Clicks strategies that have a target_spend setting. What’s changing As part of this migration, any Maximize Clicks bid strategies that still use the target_spend setting may have their maximum CPC bid limit lowered to minimize the performance impact that may result from this change. This would affect the following API fields:

Fields whose values may be lowered as part of the January 18, 2021, migration:

AdWords API

Google Ads API

TargetSpendBiddingScheme.bidCeiling

TargetSpend.cpc_bid_ceiling_micros

What you can do You can avoid the above changes by removing the target spend setting on your campaigns’ bidding strategies before January 18, 2021. To do so, unset the following field (set its value to 0) on any existing Maximize Clicks bid strategies:

Fields to unset (set to 0) to avoid the migration:

AdWords API

Google Ads API

TargetSpendBiddingScheme.spendTarget

TargetSpend.spend_target_micros

If you have any questions or need additional help, contact us via the forum or at googleadsapi-support@google.com.

Adam Ohren, Google Ads API Team

Google Ads API v2 sunset reminder

Thursday, August 27, 2020

sunsetAfter this date, all v2 API requests will begin to fail.newer version

Upgrading to the newest version

Release notes

forumgoogleadsapi-support@google.com

- Thanet Knack Praneenararat, Google Ads API Team

Sunset of DBM API v1, SDF Download and Line Item services

Thursday, August 27, 2020

Doubleclick Bid Manager (DBM) API v1.1 Line Item serviceFebruary 26, 2021DBM API v1DBM API v1.1 Structured Data File (SDF) Download serviceoriginally scheduled for June 15, 2020postponed due to COVID-19

Service

Methods

Available in v1.1 after
February 26, 2021?

Reporting

queries.createquery

queries.deletequery

queries.getquery

queries.listqueries

queries.runquery

reports.listreports

Yes

Line Item

lineitems.downloadlineitems

lineitems.uploadlineitems

No. Use the new Display &
Video 360 API instead.

SDF Download

sdf.download

No. Use the new Display &
Video 360 API instead.

DBM API v1 Reporting servicev1.1API release notes

Queries created and accessed through the Reporting service require more specific filters in the params.groupBy field in v1.1. You might have to add more values to the params.groupBy field in order to create the same report structure generated in v1.

Responses from queries.listqueries and reports.listreports calls are paginated in v1.1. Users have to update their implementation to traverse multiple pages if they wish to consume more than the first 100 items returned.

Display & Video 360 (DV360) API

The DBM API SDF Download service is being replaced by the DV360 API asynchronous SDF Download service. It features new filter options and a new download format.

The DBM API Line Item service is being replaced by the DV360 API Line Item service. This service provides create, update, and delete methods for line items using a more easily managed REST Line Item resource separate from Entity Write File format currently used in the DBM API.

set up the Display & Video 360 APIdownload SDFsmanage your line items
If you encounter issues with your migration or want to report a separate issue, please contact us using our support contact form.

- Trevor Mulchay, Display & Video 360 API Team

Sunset of the Ad Manager API v201908

Tuesday, August 11, 2020

deprecation schedulein v201911CMS Metadatarelease notesActivityActivityGroupchanging from type int to type longAs always, don't hesitate to reach out to us on the developer forum with any questions.

- Donovan McMurray, Ad Manager API Team

Sunset of v2 for the Content API for Shopping

Monday, July 13, 2020

The Content API for Shopping v2 will sunset on March 29, 2021. On this date, all requests made against v2 of the Content API for Shopping will fail. Please migrate to v2.1 as soon as possible to ensure your applications are unaffected.

To help with the migration to v2.1, we have prepared the following resources:

If you have questions about migration, please reach out to us on the forum.

Benji Rothman, Content API for Shopping Team

Announcing Authorized Buyers’ new Real-Time Bidding API

Thursday, June 25, 2020

Today we are pleased to announce the release of Authorized Buyers’ Real-Time Bidding API. In addition, we are also announcing that all versions of the Ad Exchange Buyer API are now deprecated, and will sunset by the end of Q2, 2021. With the exception of the Budgets and PerformanceReport resources that are not being carried over to the new API, we recommend migrating to the Real-Time Bidding API’s equivalent resources well before the sunset to avoid interruptions to your integration. Note that this deprecation does not include the Ad Exchange Buyer II API, which will continue to be supported.

The Real-Time Bidding API currently includes resources for managing creatives and user lists, and will be expanded in Q4 to include resources for managing pretargeting. Additional updates through Q4 will add features for managing accounts and billing information. We recommend reading through the migration guide—which will be updated as new features are added to the Real-Time Bidding API—to learn more about getting started with the new API.

Feel free to reach out to us via the Authorized Buyers API forums if you have questions or feedback concerning the Real-Time Bidding API.

Mark Saniscalchi, Authorized Buyers Developer Relations

Google Ads API beta v1 sunset reminder

Tuesday, June 16, 2020

Google Ads API beta v1 will sunset on July 29, 2020. After this date, all v1 API requests will begin to fail. Please migrate to a newer version prior to July 29, 2020 to ensure your API access is unaffected.

We've prepared various resources to help you with the migration:

Upgrading to the newest version
Release notes

If you have questions while you’re upgrading, please reach out to us on the forum or at googleadsapi-support@google.com.

Nadine Wang, Google Ads API Team

Sunset of the Ad Manager API v201905

Wednesday, May 20, 2020

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

If you’re still using this version, now is the time to upgrade to the latest release and take advantage of new functionality like CustomPacingCurves on LineItem objects and performing actions on CMS Metadata Values.

When you’re ready to upgrade, check the 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

Reminder about sunset, creation of target spend field for Maximize Clicks strategies in Ads APIs

Monday, May 18, 2020

On July 31st, 2019 we began to sunset the target spend field for Maximize Clicks bidding strategies. At the time, the feature was only removed from the UI, and the Google Ads APIs were not impacted.

Starting on June 30th, 2020, we will continue to sunset the target spend field in the Google Ads APIs as per our original blog post. This will affect all versions of both the AdWords API and the Google Ads API. The following behaviors will be blocked:

Populating the target spend field on existing standard and portfolio strategies
Attaching portfolio strategies that have the deprecated field set to campaigns

Read on to see how this will affect your API usage:

	Affected Target Spend Fields
Google Ads API	`campaign.target_spend.target_spend_micros` `bidding_strategy.target_spend.target_spend_micros`
AdWords API	`Campaign.BiddingStrategyConfiguration.TargetSpendBiddingScheme.spendTarget` `SharedBiddingStrategy.TargetSpendBiddingScheme.spendTarget`

Change Description
Any mutate operations that set a target spend field for the first time will return an error. You will be able to update a target spend field that currently contains a value, but you cannot set previously empty fields to a new value. Additionally, any operation attaching a bidding strategy to a campaign where that bidding strategy has a value set for a target spend field, will throw an error. To manage Target Spend on any new campaigns, we recommend using campaign budget. In each of these cases an error will be thrown.

Performing any of the actions listed above will generate one of the following errors:

OPERATION_NOT_PERMITTED_FOR_CONTEXT
UNSUPPORTED_FIELD_IS_SET

If you have any questions about this change or any other API feature, please contact us via the forum.

- Cory Liseno, Google Ads API Team

Postponement of DBM API v1 and SDF Download Service Sunset

Friday, May 15, 2020

We’re officially postponing the planned sunset of the Doubleclick Bid Manager (DBM) API v1 and the DBM API v1.1 Structured Data File (SDF) Download service.

Originally scheduled for June 15, 2020, we are delaying the sunset indefinitely in order to account for the difficulties many users are facing due to COVID-19. We’re hoping that this postponement frees up room for users to address more immediately pressing issues. An updated sunset schedule will be announced at a later date.

Although a sunset date is no longer scheduled, these services are still deprecated and migrations to DBM API v1.1 and the Display & Video 360 (DV360) API are recommended.

- Trevor Mulchay, Display & Video 360 API Team

Updates to the AdWords API and Google Ads API

Tuesday, April 7, 2020

As communities respond to COVID-19, we know that this time presents unique challenges for everyone. Below are updates and resources to help you navigate and plan through these challenging times.

How does this impact the APIs?
We realize you are balancing a lot in your life. Here’s what we’re doing to help:

Delaying the sunset of the Google Ads API v1: The Google Ads API’s v1 sunset is delayed until July 29, 2020. The AdWords API will continue to be available for production use.
Giving additional time: Any new changes that require updates in your AdWords API and Google Ads API code will be given additional time or will be deferred.

We will continue releasing new versions of the Google Ads API to get new features to you.

What are some customer resources?
Google Ads has provided the following resources for business and customers:

Where can I get support?
The Google Ads Help Center posted a delay for non-API related support. This delay includes developer token approvals and changes.

If you have any API questions or need help, you can reach us at googleadsapi-support@google.com or on our Google Ads API and AdWords API forum.

Nadine Wang, on behalf of the entire Google Ads API Team

Upcoming change to the Google Ad Manager API

Thursday, March 19, 2020

On Wednesday April 1st, 2020 existing metrics in the Ad Manager API's ReportService will start returning net revenue instead of gross revenue for Programmatic Guaranteed and Preferred Deals. If your application does not process Programmatic Guaranteed and Preferred Deals revenue data, no action is required.

This change will impact all API versions and reports run in the Ad Manager UI. For more information, see the Ad Manager release notes for March 9th.

To help this transition, new metrics have been added in v202002 to allow you to report on gross revenue in order to facilitate historical comparisons. These metrics are temporary and will be removed in future API versions.

Why are we making this change?

This change brings Programmatic Guaranteed and Preferred Deals into alignment with all other transaction types.

How can I tell if I am impacted?

If you use any of the below metrics and your application processes Programmatic Guaranteed and Preferred Deals values as gross revenue, you are impacted by this change:

AD_SERVER_ALL_REVENUE
AD_SERVER_CPD_REVENUE
AD_SERVER_CPM_AND_CPC_REVENUE
TOTAL_LINE_ITEM_LEVEL_ALL_REVENUE
TOTAL_LINE_ITEM_LEVEL_CPM_AND_CPC_REVENUE
TOTAL_LINE_ITEM_LEVEL_WITHOUT_CPD_AVERAGE_ECPM

What changes do I need to make?

You must update your application to process Programmatic Guaranteed and Preferred Deals values as net revenue before April 1st, 2020. If you need access to gross revenue values after April 1st, 2020, you can use temporary gross revenue metrics added in v202002. These metrics will be available until the end of February 2021.

Net revenue values starting 2020-04-01	Gross revenue values until 2021-03-01
AD_SERVER_ALL_REVENUE	AD_SERVER_ALL_REVENUE_GROSS
AD_SERVER_CPM_AND_CPC_REVENUE	AD_SERVER_CPM_AND_CPC_REVENUE_GROSS
AD_SERVER_CPD_REVENUE	Not available
TOTAL_LINE_ITEM_LEVEL_ALL_REVENUE	Not available
TOTAL_LINE_ITEM_LEVEL_CPM_AND_CPC_REVENUE	Not available
TOTAL_LINE_ITEM_LEVEL_WITHOUT_CPD_AVERAGE_ECPM	Not available

If you have questions about this change or are unsure if it impacts you, reach out to us on the Ad Manager API forums. We'll be happy to check if you're impacted and work with you to update your applications.

- Chris Seeley, Ad Manager API Team

Sunset of the Ad Manager API v201902

Thursday, January 9, 2020

On Friday, February 28, 2020, in accordance with the deprecation schedule, v201902 of the Ad Manager API will be sunset. At that time, any requests made to this version will return errors.

If you’re still using this version, now is the time to upgrade to the latest release and take advantage of new functionality like CmsMetadata reporting, the TargetingPresetService, and deal IDs on programmatic LineItems.

When you’re ready to upgrade, check the release notes to identify any breaking changes, such as the removal of the deprecated field ImageCreative.lockedOrientation.

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

Sunset of the Ad Manager API v201811

Wednesday, October 16, 2019

On Monday, December 2, 2019, in accordance with the deprecation schedule, v201811 of the Ad Manager API will be sunset. At that time, any requests made to this version will return errors.

If you’re still using this version, now is the time to upgrade to the latest release and take advantage of new features like the TargetingPresetService and reporting on CustomTargetingKeys.

When you’re ready to upgrade, check the release notes to identify any breaking changes. Then, grab the latest version of your client library and update your code.

We now provide a machine-readable version of our deprecation schedule, giving you more flexibility to stay up to date with the latest Ad Manager API features. You can access this CSV file at https://developers.google.com/ad-manager/downloads/api-schedule.csv.

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

- Donovan McMurray, Ad Manager API Team

Ads Developer Blog

Sunset of the Ad Manager API v202002

Google Ads API v3 sunset reminder

Upcoming sunset for DBM API v1, SDF Download and Line Item services

Sunset of deprecated Geo Region targeting options in Display & Video 360 API

Sunset approaching for v2 of the Content API for Shopping

Sunset of the Ad Manager API v201911

Target Spend Migration for Maximize Clicks Bid Strategies

Google Ads API v2 sunset reminder

Sunset of DBM API v1, SDF Download and Line Item services

Sunset of the Ad Manager API v201908

Sunset of v2 for the Content API for Shopping

Announcing Authorized Buyers’ new Real-Time Bidding API

Google Ads API beta v1 sunset reminder

Sunset of the Ad Manager API v201905

Reminder about sunset, creation of target spend field for Maximize Clicks strategies in Ads APIs

Postponement of DBM API v1 and SDF Download Service Sunset

Updates to the AdWords API and Google Ads API

Upcoming change to the Google Ad Manager API

Sunset of the Ad Manager API v201902

Sunset of the Ad Manager API v201811

Labels

Archive

Feeds

Google Ads API [+]

AdWords API [+]

Google Ads scripts [+]

Content API for Shopping [+]

Google Ad Manager API [+]

DCM API [+]

DV360 API [+]

DBM API [+]

Mobile Ads [+]

IMA SDK [+]