Category Archives: Ads Developer Blog

The official blog for information about the AdWords, AdSense, DoubleClick and AdMob APIs and SDKs

Google Ads API Video Roundup – Feb 2023

The Google Ads Developers Channel is your source for release notes, best practices, new feature integrations, code walkthroughs, and video tutorials. Check out some of the recently released and popular videos and playlists below, and remember to subscribe to our channel to stay up to date with the latest video content.

Performance Max for Developers [New Series]

In this series, we navigate the entire developer journey of creating standard Performance Max campaigns and Performance Max campaigns for online sales with a product feed. We discuss how to think about Performance Max as compared with other campaign types and walk through the process of creating Performance Max campaigns conceptually. In addition, we explore several implementation options with the use of the new Performance Max Interactive Guide, which you can use to easily follow along and jumpstart your integration.

Five episodes have been published with an additional three more on the way. Subscribe to our channel to be notified when new episodes are released.

Testing Your Integration [New Series]

In the first two episodes of this miniseries, we begin to look at testing with the Google Ads API. In the introductory episode, we discuss Google Ads test accounts and test account alternatives. In the second episode, we demonstrate test account usage in practice. Subscribe to our channel to be notified when the next episode about testing best practices becomes available.

Campaign Primary Status [New Video]

The Google Ads API introduced two new fields on the campaign resource in v12, called primary_status and primary_status_reason. In this video, we discuss how they can help you understand what is going on with your campaigns and how to optimize their serving.

Meet the Team [New Episodes]

Check out the two new episodes in our Meet the Team series to catch in-depth discussions with Eric Schwelm, who is a Software Engineer and Tech Lead on the Google Ads API, and Carolyn Chou, who is a Product Manager working on Performance Max campaigns in the Google Ads API.


For additional topics, including Release Notes, Authentication and Authorization and Working with REST, check out the Google Ads Developers YouTube channel.

As always, feel free to reach out to us with any questions via the Google Ads API forum or at [email protected].

- Devin Chasanoff, on behalf of the Google Ads API Team

Announcing iOS Google Mobile Ads SDK Version 10.0.0

We are excited to announce the release of our newest version of the Google Mobile Ads SDK. We recommend upgrading as soon as possible to stay up-to-date with our latest features.

Version 10.0.0 Changes

Google Mobile Ads SDK version 10.0.0 introduces a few major changes:

  • The minimum OS version has been bumped from 11 to 12. Given the high adoption rate of iOS 16, we are continuing the trend of incrementing the minimum support level. Applications can still be built for iOS 11, however, the SDK will not load any ads on iOS 11.
  • Since bitcode is deprecated in Xcode 14, we have disabled bitcode in the SDK. As a result, this has decreased the download size of our SDK by ~35MB. What this means for you is to integrate with SDK version 10.0.0, you also have to disable bitcode (if you haven’t already) in the build settings of your Xcode project.
  • Ad Manager applications require an app ID upon initialization of the SDK. This also means the key GADIsAppManagerApp will no longer bypass this check. App IDs are added to the Info.plist with a key of GADApplicationIdentifier. See Update your Info.plist for more details.
  • Ad Manager applications require GoogleAppMeasurement.xcframework as a dependency. If you install the Google Mobile Ads SDK through CocoaPods or Swift Package Manager, no additional action is required. If you install frameworks manually, see Manual Download for more details.
  • We also have removed deprecated APIs of various properties and classes.

For the full list of changes, check the release notes. Check our migration guide to ensure your mobile apps are ready to upgrade.

SDK Deprecation Reminder

Per the deprecation schedule announced last year, the release of version 10.0.0 means that:

  • iOS Google Mobile Ads SDK versions 8.x.x is officially deprecated, and will sunset in Q2 2024.
  • Versions 7.x.x and below will sunset sometime in Q2 2023, approximately 60 days following the release of Android Google Mobile Ads SDK major version 22.0.0.

As always, if you have any questions or need additional help, contact us via the forum.

 - Justin Malandruccolo, Mobile Ads Developer Relations

Campaign Manager 360 API v3.5 sunset reminder

Campaign Manager 360 API v3.5 will sunset on Feb 20th, 2023. After this date, all requests made to v3.5 of this API will fail. If you're still using this version, you must migrate to the most current release to avoid an interruption in service.

See the migration guide for details. Most likely, you just need to adopt the latest version of your preferred client library. However, all users are advised to review the release notes to learn about important version differences you may need to be aware of.

If you have questions about this or anything else Campaign Manager 360 API related, feel free to reach out to us on our support forum.
- Ruizhi Liao, CM360 API Team

Bid Manager API v1.1 sunset reminder

As announced in August 2022, Bid Manager (DBM) API v1.1 will sunset on February 28, 2023. Please migrate to v2 before the sunset date to avoid an interruption of service.

You can read our release notes for more information about v2. 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

Google Ads API v10 sunset reminder

Google Ads API v10 will sunset on February 1, 2023. After this date, all v10 API requests will begin to fail. Please migrate to a newer version prior to February 1, 2023 to ensure your API access is unaffected.

We've prepared various resources to help you with the migration: In addition, using the Google Cloud Console, you can view the list of methods and services to which your project recently submitted requests:
  1. Open the Dashboard page (found under APIs & Services) in the Google Cloud Console.
  2. Click on Google Ads API in the table.
  3. On the METRICS subtab, you should see your recent requests plotted on each graph. At the bottom of the page, you’ll see the Methods table, where you can see which methods you’ve sent requests to. The method name includes a Google Ads API version, a service, and a method name, e.g., google.ads.googleads.v10.services.GoogleAdsService.Mutate. In this way, you can see all versions that you’ve used recently.
  4. (Optional) Click on the time frame at the top right of the page if you need to change it.
If you have questions while you’re upgrading, please reach out to us on the forum or at [email protected].
 - Thanet Knack Praneenararat, Google Ads API Team

Announcing the Performance Max Interactive Guide for Google Ads API

Today, we are releasing a first-of-its-kind interactive guide to help you get started with standard Performance Max (PMax) campaigns and Performance Max for online sales with a product feed. This new guide walks through the end-to-end process of creating Performance Max campaigns to provide you with a better understanding of the various steps involved. You can build your own custom code dynamically with customization and configuration options.

The Performance Max interactive guide was designed to provide you with a single place to access the entire developer journey. As you step through the guide, you will have the option to enter custom values using form fields in the left-hand navigation panel. As you do, the sample code will automatically update to reflect your inputs.


In addition to variable substitution, the interactive guide offers a number of configuration options, including the ability to interactively create:
  • Standard Performance Max campaigns
  • Performance Max for online sales with a product feed
  • Production partition trees of listing group filters
  • Multiple asset groups
  • Any number of assets supported by Performance Max
  • Any number of campaign criteria support by Performance Max
  • Multiple campaign conversion goals

The Performance Max interactive guide currently supports Java, with additional languages to be added in the future. You can now build your own Google API integrations with this resource. Feel free to provide feedback on this tool by clicking the Feedback button in the top right corner of the guide.

As always, feel free to reach out to us with any questions via the Google Ads API forum or at [email protected].
- Devin Chasanoff, on behalf of the Google Ads API Team

Announcing the Performance Max Interactive Guide for Google Ads API

Today, we are releasing a first-of-its-kind interactive guide to help you get started with standard Performance Max (PMax) campaigns and Performance Max for online sales with a product feed. This new guide walks through the end-to-end process of creating Performance Max campaigns to provide you with a better understanding of the various steps involved. You can build your own custom code dynamically with customization and configuration options.

The Performance Max interactive guide was designed to provide you with a single place to access the entire developer journey. As you step through the guide, you will have the option to enter custom values using form fields in the left-hand navigation panel. As you do, the sample code will automatically update to reflect your inputs.


In addition to variable substitution, the interactive guide offers a number of configuration options, including the ability to interactively create:
  • Standard Performance Max campaigns
  • Performance Max for online sales with a product feed
  • Production partition trees of listing group filters
  • Multiple asset groups
  • Any number of assets supported by Performance Max
  • Any number of campaign criteria support by Performance Max
  • Multiple campaign conversion goals

The Performance Max interactive guide currently supports Java, with additional languages to be added in the future. You can now build your own Google API integrations with this resource. Feel free to provide feedback on this tool by clicking the Feedback button in the top right corner of the guide.

As always, feel free to reach out to us with any questions via the Google Ads API forum or at [email protected].
- Devin Chasanoff, on behalf of the Google Ads API Team

Deprecation of New Smart Display Campaign Creation in the Google Ads API

We are removing the ability to create new Smart Display Campaigns in all versions of the Google Ads API. Version v12 already has these changes implemented.

On January 17, 2023 we will make a breaking change to all active versions of the Google Ads API older than v12, disallowing the creation of new Smart Display Campaigns in the API.

You will still be able to update your existing Smart Display Campaigns until they are auto-migrated in Q1 2023. For more information, please see this Help Center article.

Change Description
In all versions, after January 17, 2023, mutate operations to create a Smart Display Campaign (setting the AdvertisingChannelSubType to DISPLAY_SMART_CAMPAIGN) will throw an OperationAccessDeniedError.CREATE_OPERATION_NOT_PERMITTED error.

Next Steps
If you receive this error during Smart Display Campaign creation, you should create a Standard Display Campaign instead by leaving the optional AdvertisingChannelSubType field blank.

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

Deprecation of New Smart Display Campaign Creation in the Google Ads API

We are removing the ability to create new Smart Display Campaigns in all versions of the Google Ads API. Version v12 already has these changes implemented.

On January 17, 2023 we will make a breaking change to all active versions of the Google Ads API older than v12, disallowing the creation of new Smart Display Campaigns in the API.

You will still be able to update your existing Smart Display Campaigns until they are auto-migrated in Q1 2023. For more information, please see this Help Center article.

Change Description
In all versions, after January 17, 2023, mutate operations to create a Smart Display Campaign (setting the AdvertisingChannelSubType to DISPLAY_SMART_CAMPAIGN) will throw an OperationAccessDeniedError.CREATE_OPERATION_NOT_PERMITTED error.

Next Steps
If you receive this error during Smart Display Campaign creation, you should create a Standard Display Campaign instead by leaving the optional AdvertisingChannelSubType field blank.

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

Request Account Reviews with the Content API

In the Content API for Shopping, your Merchant Center account and the products in it might be disapproved for various reasons. Historically, you have been able to see the status of your merchant center account for free listings and Shopping ads with the accountstatuses service. In Q1 2022 we introduced the freelistingsprogram and shoppingadsprogram services to provide more granular detail. You can now use the requestreview method on the freelistingsprogram and shoppingadsprogram services to request your account to be re-reviewed after making changes to fix your product and account data.

For an in-depth explanation of how to use the freelistingsprogram and shoppingadsprogram services, please refer to the Free listings and Shopping ads guides.

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

Benji Rothman, Content API for Shopping Team