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:

• 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.
• Added two expiration_date_time fields local_services_verification_artifact to allow advertisers to better monitor when their artifacts expire.

Where can I learn more?
The following resources can help you get started:

• Release Notes
• Guides
• Reference
• Diff between v16 and v17

If you have any questions or need additional help, contact us via the forum.

 - Thanet Knack Praneenararat, on behalf of the Google Ads API Team

Labels: google-ads-api, release