Google Ads Developer Blog

Announcing v9 of the Google Ads API

Wednesday, November 3, 2021

Google Ads APIclient libraries

Added support for Performance Max campaigns, a new campaign type that provides a unified buying service to virtually all Google Ads inventory. Performance Max also provides a superset of Smart Shopping Campaign functionality.

Added support for conversion goals to help you organize your conversion actions so that you can more easily optimize toward your advertising objectives.

Smart campaigns is in open beta and is now available for all users. We also added a new, more robust suggestion method, which leverages your company’s business details to suggest keyword themes for your Smart campaign.

Added support for an App campaign for pre-registration and the pre-registration ads which helps to gauge interest before an app or a game is available to install.

Migrated Video ads from using MediaFile to represent videos and images to using assets: AdVideoAsset and AdImageAsset. This includes the companion_banner and video fields of Video ads-related objects.

To comply with ATT, ConversionUploadService now supports conversion uploads with BRAID identifiers (ClickConversion.gbraid and ClickConversion.wbraid) in place of GCLID. BRAID identifiers are used for clicks associated with conversions from iOS14 devices. This feature is currently only available to allowlisted customers.

The Google Ads API now distinguishes between conversions with SKAdNetwork conversion value 0 and conversions with no conversion value present in the postback from Apple. Note that this feature is only available for SKAdNetwork conversions received after September 20th, 2021.

Added support for asset sets, which are a collection of assets. They will eventually replace the FeedService.

Added support for ad customizers for Responsive Search Ads.

Added support for warnings for OfflineUserDataJobService as AddOfflineUserDataJobOperationsRequest.enable_warnings. When set to true, any non-blocking errors pertaining to operation failures will be returned as AddOfflineUserDataJobResponse.warning.

ad_group_ad_asset_view reporting is now available for App engagement ads and responsive search ads.

Added support for retrieving hotel_reconciliation resources, which contain booking information to reconcile bookings from commission campaigns.

Added support for customer match rate range with CreateOfflineUserDataJobRequest.enable_match_rate_range_preview. The customer match rate range is the efficacy of your Customer Match uploads, which is the number of matched user data rows divided by the total number of Customer Match uploaded rows.

Added UserAttribute.shopping_loyalty to allow for sending loyalty-related data with UserAttribute.

Added the following types of assets, which will be available in all accounts by the end of 2021

Price assets
Hotel Callout assets
Mobile App assets
Call assets
Call to action assets

Where can I learn more?

forum

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

Sunset of the Ad Manager API v202011

Wednesday, November 3, 2021

deprecation scheduleAudioCreativespushing creative previewslinked devicesrelease notes

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

Support was removed for filtering on the field keyValueMemberContent in CmsMetadataService.getCmsMetadataValuesByStatement. Use Content.cmsMetadataValueIds instead.

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.

- Donovan McMurray, Ad Manager API Team

Ads API apps must complete OAuth verification

Thursday, October 28, 2021

were classified as sensitiveverification process

Google Ads API & AdWords API

https://www.googleapis.com/auth/adwords

Content API for Shopping

https://www.googleapis.com/auth/content

DoubleClick Bid Manager API

https://www.googleapis.com/auth/doubleclickbidmanager

OAuth clients using the above scopes that remain unverified may have their existing credentials revoked and lose access to the above APIsexceptions for app verification

Google Ads API & AdWords API: googleadsapi-support@google.com

Content API for Shopping: support forum

DoubleClick Bid Manager API: support contact form

Adam Ohren, Google Ads API Team

Google Ads scripts failures starting on October 13

Thursday, October 14, 2021

Update (Oct 16, 2021): An issue impacting Google Ads scripts between 7:30 AM EDT on October 13 until October 15th 7:00 PM EDT has been resolved.Finished with errorsFailedNo changesforum - Mike Cloonan, Google Ads Scripts Team

Announcing the release of the Authorized Buyers Marketplace API

Thursday, October 14, 2021

Authorized Buyers Marketplace API

accounts.clients

accounts.clients.invitations

accounts.clients.users

accounts.finalizedProposals

accounts.proposals

accounts.publisherProfiles

is not

Programmatic support for auction packages.

Deals are now a sub-resource of proposals.

The finalizedDeals resource helps you manage deals.

The rtbMetrics field of finalizedDeals provides performance data.

enableAuthorized Buyers Marketplace APIhttps://www.googleapis.com/auth/authorized-buyers-marketplacesupport forums

- Mark Saniscalchi, Authorized Buyers Developer Relations

UserData Enforcement in Google Ads API

Wednesday, October 13, 2021

January 10, 2022user_identifersUserData

Correct usage

operations: {
  create: {
    user_identifiers {
      hashed_email: hash(“johndoe@gmail.com”)
    },
    user_identifiers {
       hashed_email: hash(“johndoe@google.com”)
    } 
  }
}
operations: {
  create: {
    user_identifiers {
      hashed_email: hash(“maxmustermann@gmail.com”)
    },
    user_identifiers {
      hashed_email: hash(“maxmustermann@google.com”)
    }
  }
}

Incorrect usage

operations: {
  create: {
    user_identifiers { 
      hashed_email:  hash(“johndoe@gmail.com”) 
    },
    user_identifiers {
      hashed_email:  hash(“johndoe@google.com”)
    },
    user_identifiers { 
      hashed_email: hash(“maxmustermann@gmail.com”)
    },
    user_identifiers { 
      hashed_email: hash(“maxmustermann@google.com”)
    }
  }
}

UserDataCustomer Matchstore salesUserDatauser_identifiersshould be for a single useruser_identifiersuser_identifiersTOO_MANY_USER_IDENTIFIERSUserData

OfflineUserDataJobService.AddOfflineUserDataOperations

UserDataService.UploadUserDataRequest

If you have any questions or need additional help, contact us via the forum.

David Wihl, Google Ads API Team

Final reminder to migrate to the AdMob API

Wednesday, October 6, 2021

October 12, 2021AdSense Management API v1.4AdMob APIWhat do I need to do?migration guide

Get started with the AdMob API - Follow this guide to learn how to generate credentials and make your first request using the AdMob API.

Reference documentation - Find detailed information on each REST method and its specific parameters.

Client Library Samples - Check out code samples on how to make requests in Java, PHP, and Python.

October 12th, 2021AdMob API Developer forum

- Amira Badreldin, AdMob API team

Ads Developer Blog