Today, we’re announcing nan v17 merchandise of nan Google Ads API. To usage immoderate of nan v17 features, you will request to upgrade your client libraries and customer code. The updated customer libraries and codification examples will beryllium published adjacent week.


Here are nan highlights:
  • To hole for nan resource usage argumentation change that will hap connected June 17, 2024, we added 2 caller values to QuotaError, thrown for excessive assets depletion complete a play of clip by a query shape for GoogleAdsService.Search() and GoogleAdsService.SearchStream() requests.
  • The page_size section is ever group to 10,000, and you tin nary longer walk a page_size to GoogleAdsService.Search. Doing truthful will consequence successful a RequestError.PAGE_SIZE_NOT_SUPPORTED error.
  • Added campaign_aggregate_asset_view and channel_aggregate_asset_view for reporting much metrics of Performance Max and Search campaigns.
  • Changes to batch processing:
    • Added support for mounting MutateOperation.asset_group_operation erstwhile utilizing BatchJobService. This lets you usage batch processing to create and negociate full Performance Max campaigns.
    • Added nan BatchJobError.REQUEST_TOO_LARGE correction for submitting a AddBatchJobOperationsRequest that is larger than 10,484,504 bytes. You should disagreement nan operations into smaller groups and nonstop them arsenic a abstracted request.
  • Added Campaign.keyword_match_type to let mounting a keyword lucifer type for each keywords successful a campaign.
  • Removed AdService.getAd to align nan work pinch others successful nan Google Ads API. For recommendations connected really to fetch resources, spot Retrieving objects.
  • Added primary_status and primary_status_reasons to AdGroupCriterion to show whether nan advertisement group criterion is serving, aliases nan reasons why it's not serving.
  • Added a caller study shopping_product, which corresponds to nan Products page of nan Google Ads UI.
  • Added much validations for ImageAdInfo.image_asset regarding dimensions and format, which makes it much accordant pinch different image validations successful nan Google Ads API.
  • Added segments.sk_ad_network_redistributed_fine_conversion_value, which redistributes NULL values to different values based connected a instrumentality learning exemplary connected caller SkAdNetwork postback data.
  • Renamed Discovery to Demand Gen successful each fields, enums, errors of each resources crossed nan Google Ads API.
  • You tin now prime only fields related to one linked product erstwhile querying product_link. Failing to do truthful will propulsion QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE.
  • Added UserListCustomerTypeService.MutateUserListCustomerTypes() to configure audience customer types. This method replaces nan usage of CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.
  • Added 2 expiration_date_time fields local_services_verification_artifact to let advertisers to amended show erstwhile their artifacts expire.
Where tin I study more?
The pursuing resources tin thief you get started:
  • Release Notes
  • Guides
  • Reference
  • Diff betwixt v16 and v17
If you person immoderate questions aliases request further help, interaction america via nan forum.