Announcing v17 of the Google Ads API
Wednesday, June 5, 2024
Today, we’re announcing the v17 release of the Google Ads API. To use some of the v17 features, you will need to upgrade your client libraries and client code. The updated client libraries and code examples will be published next week.
Here are the highlights:
The following resources can help you get started: If you have any questions or need additional help, contact us via the forum.
Here are the highlights:
- 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 forGoogleAdsService.Search()
andGoogleAdsService.SearchStream()
requests. - The
page_size
field is always set to 10,000, and you can no longer pass apage_size
toGoogleAdsService.Search
. Doing so will result in aRequestError.PAGE_SIZE_NOT_SUPPORTED
error. - Added
campaign_aggregate_asset_view
andchannel_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 usingBatchJobService
. This lets you use batch processing to create and manage entire Performance Max campaigns. - Added the
BatchJobError.REQUEST_TOO_LARGE
error for submitting aAddBatchJobOperationsRequest
that is larger than 10,484,504 bytes. You should divide the operations into smaller groups and send them as a separate request.
- Added support for setting
- 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
andprimary_status_reasons
toAdGroupCriterion
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 redistributesNULL
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 throwQueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE
. - Added
UserListCustomerTypeService.MutateUserListCustomerTypes()
to configure audience customer types. This method replaces the use ofCustomerLifecycleGoal.lifecycle_goal_customer_definition_settings
. - Added two expiration_date_time fields
local_services_verification_artifact
to allow advertisers to better monitor when their artifacts expire.
The following resources can help you get started: If you have any questions or need additional help, contact us via the forum.