Google Ads API v17 Released

Google announced the v17 release of the Google Ads API. o use some of the v17 features, you will need to upgrade your client libraries and client code. Key updates include:

Resource Usage Policy

• QuotaError: Two new values were added to handle excessive resource consumption for GoogleAdsService.Search() and GoogleAdsService.SearchStream() requests.
• Page Size: page_size is now fixed at 10,000. Passing a page_size will result in a RequestError.PAGE_SIZE_NOT_SUPPORTED error.

Reporting Enhancements

• Added campaign_aggregate_asset_view and channel_aggregate_asset_view for Performance Max and Search campaigns.
• New report shopping_product for the Products page in the Google Ads UI.

Batch Processing

• Support for MutateOperation.asset_group_operation in BatchJobService to manage Performance Max campaigns.
• New BatchJobError.REQUEST_TOO_LARGE error for requests larger than 10,484,504 bytes.
• Added Campaign.keyword_match_type for setting keyword match types for all keywords in a campaign.

Service and Field Changes

• Removed AdService.getAd. Refer to Retrieving objects for fetching resources.
• Added primary_status and primary_status_reasons to AdGroupCriterion.
• Added more validations for ImageAdInfo.image_asset.
• Added segments.sk_ad_network_redistributed_fine_conversion_value.

Renaming and Field Selection

• Renamed Discovery to Demand Gen across all resources.
• Queries for product_link must now select fields related to one linked product, or face QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE.

New Services and Methods

• Added UserListCustomerTypeService.MutateUserListCustomerTypes() to configure audience customer types.
• Added expiration date fields to local_services_verification_artifact.