Google Ads Developer Blog: Announcing v17 of the Google Ads API

Ads Developer Blog

The official blog for information about the Google Ads, Google Ad Manager, Google Mobile Ads SDKs for AdMob and IMA SDKs, and other Google Advertising Platform developer tools.

Announcing v17 of the Google Ads API

Wednesday, June 5, 2024

Google Ads APIclient libraries

To prepare for the resource usage policy change that will happen on June 17, 2024, we added two new values to QuotaError, thrown for excessive resource consumption over a period of time by a query pattern for GoogleAdsService.Search() and GoogleAdsService.SearchStream() requests.

The page_size field is always set to 10,000, and you can no longer pass a page_size to GoogleAdsService.Search. Doing so will result in a RequestError.PAGE_SIZE_NOT_SUPPORTED error.

Added campaign_aggregate_asset_view and channel_aggregate_asset_view for reporting more metrics of Performance Max and Search campaigns.

Changes to batch processing:

Added support for setting MutateOperation.asset_group_operation when using BatchJobService. This lets you use batch processing to create and manage entire Performance Max campaigns.
Added the BatchJobError.REQUEST_TOO_LARGE error for submitting a AddBatchJobOperationsRequest that is larger than 10,484,504 bytes. You should divide the operations into smaller groups and send them as a separate request.

Added Campaign.keyword_match_type to allow setting a keyword match type for all keywords in a campaign.

Removed AdService.getAd to align the service with others in the Google Ads API. For recommendations on how to fetch resources, see Retrieving objects.

Added primary_status and primary_status_reasons to AdGroupCriterion to show whether the ad group criterion is serving, or the reasons why it's not serving.

Added a new report shopping_product, which corresponds to the Products page of the Google Ads UI.

Added more validations for ImageAdInfo.image_asset regarding dimensions and format, which makes it more consistent with other image validations in the Google Ads API.

Added segments.sk_ad_network_redistributed_fine_conversion_value, which redistributes NULL values to other values based on a machine learning model on recent SkAdNetwork postback data.

Renamed Discovery to Demand Gen in all fields, enums, errors of all resources across the Google Ads API.

You can now select only fields related to one linked product when querying product_link. Failing to do so will throw QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE.

Added UserListCustomerTypeService.MutateUserListCustomerTypes() to configure audience customer types. This method replaces the use of CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.