Google has announced the release of Google Ads API v17, introducing several new features and changes that advertisers and developers need to be aware of. This update aims to enhance campaign management and performance monitoring while addressing policy updates and optimising batch processing capabilities.
Google Ads API v17 Key Takeaways
- New resource usage policy updates to manage excessive resource consumption.
- Fixed page size at 10,000 for GoogleAdsService.Search requests.
- New reporting views for Performance Max and Search campaigns.
- Batch processing updates for asset group operations and request size limits.
- Additional features including keyword match type settings and a new shopping product report.
Major Changes for Google Ads API v17
Resource Usage Policy Update
To prepare for an upcoming resource usage policy change on 17 June 2024, Google has added two new values to QuotaError. These values will help manage instances of excessive resource consumption over a specified time period.
Page Size Fixed at 10,000
The page size field is now permanently set to 10,000. Attempting to pass a different page size to GoogleAdsService.Search will result in a request error.
New Reporting Views
Google has introduced new reporting views, including Campaign aggregate asset view and Channel aggregate asset view. These views will provide more metrics on Performance Max and Search campaigns.
Batch Processing Updates
Asset Group Operations
Support for setting MutateOperation.asset_group_operation when using BatchJobService has been added. This allows for batch processing in creating and managing entire Performance Max campaigns.
Request Size Limit
A new BatchJobError.REQUEST_TOO_LARGE error will be triggered for any job requests larger than 10,484,504 bytes. Advertisers will need to divide operations into smaller groups for separate requests.
Other Notable Changes for Google Ads API v17
Keyword Match Type
A new feature, Campaign.keyword_match_type, has been added. This allows advertisers to set a keyword match type for all keywords in a campaign.
Ad Group Criterion Status
Primary status and primary status reasons have been added to AdGroupCriterion. This will show the serving status and reasons for each criterion.
New Shopping Product Report
A new shopping product report has been introduced, corresponding to the Products page in the Google Ads UI.
Demand Gen Renaming
The term ‘Discovery’ has been renamed to ‘Demand Gen‘ across all relevant fields, enums, and errors.
For a complete list of changes made to Google Ads API in version 17, refer to the full release notes.
Sources
- Google Ads API v17 released with new features, changes, Search Engine Land.
