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()
andGoogleAdsService.SearchStream()
requests. - Page Size:
page_size
is now fixed at 10,000. Passing apage_size
will result in aRequestError.PAGE_SIZE_NOT_SUPPORTED
error.
Reporting Enhancements
- Added
campaign_aggregate_asset_view
andchannel_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
inBatchJobService
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
andprimary_status_reasons
toAdGroupCriterion
. - Added more validations for
ImageAdInfo.image_asset
. - Added
segments.sk_ad_network_redistributed_fine_conversion_value
.
Renaming and Field Selection
- Renamed
Discovery
toDemand Gen
across all resources. - Queries for
product_link
must now select fields related to one linked product, or faceQueryError.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
.