Google Ads Developer Blog

Deprecation of Bid Manager API v1.1

Thursday, August 18, 2022

Today we’re announcing the deprecation of the Bid Manager (DBM) API v1.1. This version will be fully sunset on February 28, 2023. Please migrate to Bid Manager API v2 by the sunset date to avoid an interruption of service. v2 introduced a number of new features and breaking changes, which are listed in our release notes. Here are some of the changes introduced in v2:

Updated API endpoints for existing services and methods.

Restructured Query and Report resources that use named object types and enums.

Added ability to request individual Report objects via queries.reports.get.

Added ability to order queries.list and queries.reports.list requests.

Improved queries.run behavior to return a Report object instead of an empty response

Follow the steps in our v2 migration guide to help you migrate from v1.1 to v2. If you run into issues or need help with your migration, please contact us using our support contact form.

- Trevor Mulchay, Display & Video 360 API Team

Announcing v11_1 of the Google Ads API

Wednesday, August 17, 2022

Google Ads APIclient libraries

Added UpgradeLocalCampaignToPerformanceMaxRecommendation to help you migrate from Local campaigns to Performance Max campaigns (more details).

Added Campaign.bidding_strategy_system_status to show the system status of the bidding strategy. It’ll help you understand if the bidding strategy is learning, limited, or misconfigured, etc. This addresses a long standing feature request to surface learning status in the API.

Added FlexibleRuleUserListInfo for creating user lists in a more flexible way. This is also a replacement for DateSpecificRuleUserListInfo that was removed in the previous release.

Enabled creation of experiments using GoogleAdsService.Mutate(). Previously, it was possible only when using ExperimentService.

Added more features to reach forecasting, which lets you

Specify affinity and in-market categories when calling ReachPlanService.GenerateReachForecast.
Specify YouTubeSelectSettings when calling ReachPlanService.GenerateReachForecast.
Retrieve YouTubeSelectLineUp when calling ReachPlanService.ListPlannableProducts.

Where can I learn more?

Release Notes

Guides

Reference

forum

Thanet Knack Praneenararat, on behalf of the Google Ads API Team

Display & Video 360 API Annual Developer Survey 2022 is closing soon

Wednesday, August 17, 2022

Annual Display & Video 360 API Developer Survey for 2022 Here is our original blog post for reference.

- Trevor Mulchay, Display & Video 360 API Team

Announcing v202208 of the Google Ad Manager API

Tuesday, August 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

Country targeting in Shopping Ads campaigns is changing in August 2022

Wednesday, August 10, 2022

Feed label replaces target country in Content API for ShoppingContent API for Shoppingfeed_labelShoppingSettingfeed_labelsfeed_label not set to a 2-letter CLDR territory code can serve ads in any country as long as the campaign has the appropriate geoTargeting and the appropriate target countries are set in Merchant Center.

This change doesn’t impact the countries targeted by existing shopping feeds. You don’t need to update existing shopping feeds or campaigns.

What’s changing in Merchant Center
Today, Google Merchant Center feeds require you to select a primary country of sale target (sales_country in Google Ads API), with the option to provide additional target countries once the feed has been created. Starting in August 23, 2022, we will make the following changes to how target countries are organized in the Merchant Center UI:

The primary country of sale option will be removed in Google Merchant Center. Country of sale will be replaced by the more generic feed_label that can accept any string, including any existing 2 letter CDLR country code.
The current additional countries field will be renamed target countries, and will include all countries you want the feed to target.

What’s changing in Google Ads UI and API
The current sales_country field for all available Shopping campaign types, including Performance Max, will eventually be replaced by feed_label. Note that we will keep the sales_country field for backwards compatibility until at least Q2 2023. Right now, you can continue to use sales_country in your campaigns.

You can create a feed_label in Google Merchant Center or the Content API. Feed labels let you group different offers according to a common trait, like language (or a country, as you’ve currently been doing). You can also use feed_labels in Google Ads campaigns to target the relevant offers (all products with the same Merchant Center feed label).

The ads for the offers that match the feed_label will show based on the following:

The countries you selected as target countries in Merchant Center.
Your campaign’s geo targeting. Note: The default campaign targeting behavior (if you do not geo target) is that your products will serve in all your Merchant Center target countries.

How you’re impacted
The phased rollout to enable this feature in Google Ads UI and API has already started, and is expected to be complete by the end of September 2022. For existing feeds, feed_label will automatically be set to the two-letter territory code of the existing sales_country field to avoid interrupting existing targeting.

However, if you want to support new users or new feeds that only have a feed_label and not a sales_country field, we recommend you update your code by August 23, 2022 to accommodate customers who will use campaigns that only have a feed_label (without a sales_country).

If you have any questions or concerns, please don't hesitate to contact us via the forum.

Benji Rothman, Content API for Shopping Team

Feed label replaces target country in Content API for Shopping

Wednesday, August 10, 2022

On August 23, 2022 we will gradually start updating the way country targeting works for shopping products.targetCountrycountryContent API for ShoppingtargetCountrycountryfeedLabelshippingIf you're accessing accounts whose product data you don’t have total control over and you are unsure whether the products or datafeeds will have ONLY a feedLabel field beginning in late August, we recommend you update your code to support the feedLabel field.productstargetCountrydatafeedscountryCountry targeting in Shopping Ads campaigns is changing in August 2022What’s already changedAugust 8, 2022Content API for ShoppingfeedLabelfeedLabelCLDR territory codestargetCountryfeedLabelfeedLabeltargetCountrythe idREST IDfeedLabeltargetCountryhereThis change to product identifier is backwards compatible, so existing REST IDs for existing products will continue to work without change.ImportantfeedLabelfeedLabeltargetCountryshippingWhat’s coming nextAugust 23, 2022feedLabeltargetCountryfeedLabeltargetCountrycountryfeedLabeltargetCountrycountryHow you’re impactedProductstargetCountryfeedLabelproductstargetCountryfeedLabelfeedLabelstargetCountryAll products inserted with a feedLabel instead of targetCountry, even if the feedLabel is a CLDR territory code, will not automatically target that country. You must explicitly set the countries you want to target via the shipping field.Datafeedsfeed labelcountry of salefeedLabelcountryfeedLabelfeedLabelscountryRecommendation for third party integrationstargetCountrycountryfeedLabelproducts.listtargetCountryfeedLabelcountrydatafeeds.listcountry

Make a request to products.list.

Filter your products to search for products where the targetCountry field does not exist on the product.

If any products appear, you have offers without a country in your Merchant Center.

Detailed ChangeshereDatafeeds ServicedatafeedsfeedLabelcountrydatafeeddatafeedscountryfeedLabelOpt out of receiving products and datafeeds without a countryFeed label replaces target country in the Content API for Shopping - temporary exemptionforum

Benji Rothman, Content API for Shopping Team

Google Ads Scripts migration office hours

Tuesday, August 2, 2022

migration guideoffice hours information pageAs a reminderforumgoogleadsscripts-support@google.com - Mike Cloonan, Google Ads Scripts Team

Ads Developer Blog