32.1.0 - 2026-04-22
-------------------
- Added support for Google Ads API v24_1.

32.0.0 - 2026-04-22
-------------------
- Added support for v24 of the Google Ads API.
- Removed support for Google Ads API v23.
- Updated code examples: generate_forecast_metrics, add_performance_max_campaign.

31.1.0 - 2026-03-25
-------------------
- Add support for v23_2 of the Google Ads API.

31.0.0 - 2026-02-25
-------------------
- Added support for Google Ads API v23_1.
- Added support for Google Ads API v20_2, v21_1, and v22_1, which contain
  EU political advertising-related changes.
- Added code examples: fetch_incentives, apply_incentive.

30.0.0 - 2026-01-28
-------------------
- Added support for Google Ads API v23.
- Removed support for Google Ads API v19.
- Renamed campaign start_date and end_date fields to start_date_time and
  end_date_time.
- Removed add_call_add example.

29.0.0 - 2025-10-15
-------------------
- Added support for Google Ads API v22.
- Fixed a typo in the BudgetPerDayMinimumErrorDetails.minimum_budget_amount_micros
  field.
- Updated PMax-related examples to remove the use of urlExpansionOptOut.

28.0.0 - 2025-08-06
-------------------
- Added support for Google Ads API v21.
- Added support for Google Ads API v19_2 and v20_1, which contain EU
  political advertising-related changes.
- Removed support for Google Ads API v18.
- Added code example: add_demand_gen_campaign.
- Updated campaign-related examples to set the containsEuPoliticalAdvertising
  field.

27.0.1 - 2025-07-07
-------------------
- Fixed bug in Google::Ads::GoogleAds::V20::Resources::CampaignBudget.

27.0.0 - 2025-06-04
-------------------
- Added support for Google Ads API v20.
- Removed support for Google Ads API v17.

26.1.0 - 2024-04-16
-------------------
- Added support for Google Ads API v19_1.
- Updated upload_enhanced_conversions_for_leads example to use session attributes.

26.0.0 - 2024-02-26
-------------------
- Added support for Google Ads API v19.
- Removed support for Google Ads API v16.
- Removed feed-related examples.
- Updated PMax campaign creation examples to use brand guidelines.
- Updated add_shopping_product_ad example to remove usage of enhancedCpc.

25.0.1 - 2024-12-18
-------------------
- Fixed bug in Google::Ads::GoogleAds::V18::Resources::CampaignBudget.

25.0.0 - 2024-10-16
-------------------
- Added support for Google Ads API v18.
- Updated example get_all_disapproved_ads to set returnTotalResultsCount
  on new searchSettings request field.

24.0.0 - 2024-08-08
-------------------
- Added support for Google Ads API v17_1.
- Removed support for Google Ads API v15.

23.0.0 - 2024-06-07
-------------------
- Added support for Google Ads API v17.
- Updated examples to remove usage of the page size parameter in Search
  requests.

22.0.0 - 2024-04-24
-------------------
- Added support for Google Ads API v16.1.
- Removed support for Google Ads API v14.
- Removed examples: approve_merchant_center_link, reject_merchant_center_link,
  remove_flights_feed_item_attribute_value, update_flights_feed_item_string_attribute_value,
  add_real_estate_feed, add_flights_feed.

21.0.0 - 2024-02-22
-------------------
- Added support for Google Ads API v16.0.
- Updated examples to remove references to extensions.
- Added support for a flag on the client that allows making requests
  without a developer token. This is in preparation for the pilot
  that uses Google Cloud orgs for API Access levels.
- Added local_services_lead.contact_details and
  local_services_lead_conversation.message_details.text to the fields
  to mask from logs.

20.0.0 - 2024-01-22
-------------------
- Removed support for Google Ads API v13.

19.0.0 - 2023-10-19
-------------------
- Added support for Google Ads API v15.0.
- Renamed upload_conversion_with_identifiers to
  upload_enhanced_conversions_for_leads and upload_conversion_enhancement to
  upload_enhanced_conversions_for_web, and updated these examples.
- Renamed get_product_bidding_category_constant to
  get_product_category_constants and updated.
- Updated examples: upload_offline_conversion, add_customer_match_user_list,
  upload_call_conversion, upload_store_sales_transactions,
  add_merchant_center_dynamic_remarketing_campaign, add_performance_max_product_listing_group_tree, add_performance_max_retail_campaign, add_shopping_product_ad.

18.0.0 - 2023-08-08
-------------------
- Added support for Google Ads API v14.1.
- Removed support for Google Ads API v12.
- Removed add_keyword_plan code example.
- Added code examples: generate_forecast_metrics, generate_historical_metrics.

17.0.0 - 2023-06-08
-------------------
- Added support for Google Ads API v14.
- Removed examples: generate_forecast_metrics, generate_historical_metrics,
  get_campaign_criterion_bid_modifier_simulations.

16.1.2 - 2023-05-17
-------------------
- Mark namespaces as no_index to avoid PAUSE indexing issues.

16.1.0 - 2023-04-28
-------------------
- Added support for Google Ads API v13.1.
- Added code example: add_things_to_do_ad.
- Renamed hotel directory to travel.
- Updated examples: upload_conversion_enhancement, add_call_ad,
  add_smart_campaign, add_call, add_customer_match_user_list,
  upload_call_conversion, upload_conversion_enhancement,
  upload_store_sales_transactions.

16.0.0 - 2023-03-31
-------------------
- Removed support for Google Ads API v11.
- Added code example: add_performance_max_for_travel_goals_campaign.
- Updated code example: create_experiment.

15.0.1 - 2023-03-08
-------------------
- Fixed bug in v13 CampaignBudget object.

15.0.0 - 2023-02-22
-------------------
- Added support for Google Ads API v13.
- Removed support for Google Ads API v10.
- Reworked code examples to address the deprecation of combined rule user lists
and expression rule user lists:
  - Edited set_up_advanced_remarketing and set_up_remarketing
  - Renamed add_combined_rule_user_list to add_flexible_rule_user_list
  - Removed add_expression_rule_user_list

14.0.1 - 2022-12-08
-------------------
- Decreased minimum perl version to 5.28.1.

14.0.0 - 2022-11-02
-------------------
- Added support for Google Ads API v12.
- Removed code examples: add_local_campaign, add_dynamic_page_feed,
  add_smart_display_ad, add_shopping_smart_ad, and migration folder.
- Bump perl version to 5.32.1.
- Updated examples: add_performance_max_retail_campaign, add_smart_campaign,
  create_experiment, forecast_reach.
- Replace handle_expanded_text_ad_policy_violations example with
  handle_responsive_search_ad_policy_violations.

13.1.1 - 2022-09-15
-------------------
- Updated the default redirect_uri, used in generate_user_credentials example,
  to remove OOB redirect. See relevant blog post:
  https://developers.googleblog.com/2022/02/making-oauth-flows-safer.html.

13.1.0 - 2022-08-22
-------------------
- Added support for Google Ads API v11_1.
- Added code examples: generate_historical_metrics.
- Improved code examples: set_custom_client_timeouts.
- Updated examples to remove references to expanded text ads.

13.0.0 - 2022-07-06
-------------------
- Removed support for Google Ads API v9.

12.0.0 - 2022-06-16
-------------------
- Added support for Google Ads API v11_0.
- Added code examples: create_experiment, detect_and_apply_recommendations.
- Removed code examples: create_campaign_experiment, graduate_campaign_experiment.
- Updated add_smart_campaign example.
- Updated the FieldMasks utility to better handle empty object fields. See updated guide:
  https://developers.google.com/google-ads/api/docs/client-libs/perl/field-masks.

11.0.0 - 2022-04-28
-------------------
- Added support for Google Ads API v10_1.
- Removed support for Google Ads API v8_0.
- Renamed authenticate_in_web_application to generate_user_credentials and updated
  to support the desktop application flow, since OAuth OOB is being deprecated.
- Removed authenticate_in_desktop_application code example.
- Updated add_customer_match_user_list code example.

10.0.1 - 2022-03-30
-------------------
- Added code examples: add_performance_max_product_listing_group_tree,
  navigate_search_result_pages_caching_tokens.
- Updated code examples: add_campaigns, add_performance_max_campaign,
  add_performance_max_retail_campaign, upload_offline_conversion.

10.0.0 - 2022-02-18
-------------------
- Added support for Google Ads API v10_0.
- Removed support for Google Ads API v7.
- Added code examples: add_call, add_call_ad, add_dynamic_page_feed_asset,
  add_dynamic_remarketing_asset.
- Updated code examples: get_account_information, add_display_upload_ad, upload_image_asset,
  add_performance_max_campaign, add_performance_max_retail_campaign, get_keywords.

9.3.0 - 2021-12-15
-------------------
- Supported HTTP agent version in the "x-goog-api-client" request header.
- Updated the references of “Google My Business/GMB” in code examples to
  “Business Profile”.
- Added code examples: add_performance_max_campaign, add_performance_max_retail_campaign,
  add_responsive_search_ad_with_ad_customizer, upload_conversion_enhancement,
  upload_conversion_with_identifiers.
- Updated code examples: add_app_campaign, add_smart_campaign.
- Renamed code examples: add_google_my_business_location_extensions to
  add_business_profile_location_extensions, setup_advanced_remarketing to
  set_up_advanced_remarketing, setup_remarketing to set_up_remarketing.

9.2.0 - 2021-11-12
-------------------
- Added support for Google Ads API v9_0.
- Supported client library version in the "x-goog-api-client" request header.
- Improved code examples: add_smart_campaign, upload_store_sales_transactions,
  create_customer_match_user_list.
- Updated code examples to the asset based extensions: add_hotel_callout,
  add_sitelinks_using_assets, add_prices.

9.1.0 - 2021-09-30
-------------------
- Added code examples: add_bidding_data_exclusion, add_bidding_seasonality_adjustment.
- Fixed code examples: add_display_upload_ad, add_local_campaign, add_smart_display_ad,
  upload_image, upload_image_asset, upload_media_bundle,
  add_merchant_center_dynamic_remarketing_campaign.

9.0.0 - 2021-08-13
-------------------
- Added support for Google Ads API v8_1.
- Removed support for Google Ads API v6.
- Removed add_gmail_ad code example.
- Added new services: BiddingDataExclusionService,
  BiddingSeasonalityAdjustmentService.
- Updated code examples for Google Ads API v8_1: add_smart_campaign,
  get_change_details.

8.0.1 - 2021-07-05
-------------------
- Improved code examples: get_ad_group_bid_modifiers, upload_call_conversion,
  upload_offline_conversion.

8.0.0 - 2021-06-11
-------------------
- Added support for Google Ads API v8_0.
- Removed support for Google Ads API v5.
- Added support for logging the request IDs for search stream API.
- Added new services: AccessibleBiddingStrategyService,
  AssetFieldTypeViewService, ConversionValueRuleService,
  ConversionValueRuleSetService, DetailedDemographicService,
  KeywordThemeConstantService, SmartCampaignSearchTermViewService,
  SmartCampaignSettingService, SmartCampaignSuggestService.
- Added code examples: add_smart_campaign, use_cross_account_bidding_strategy.
- Updated upload_store_sales_transactions code example.

7.0.0 - 2021-05-06
-------------------
- Added support for Google Ads API v7_0.
- Removed support for Google Ads API v4.
- Added code examples: migrate_promotion_feed_to_asset.
- Improved code examples: get_ad_group_bid_modifiers.

6.1.1 - 2021-04-07
-------------------
- Supported HTTP requests retry mechanism on error responses.
- Improved code examples: create_customer, add_dynamic_page_feed, etc.
- Updated all code examples to link to Google Ads API documentation instead of
  AdWords API documentation.

6.1.0 - 2021-02-15
-------------------
- Added support for Google Ads API v6_1.
- Removed support for Google Ads API v3.
- Added support for authenticating with service accounts.
- Added code examples: get_pending_invitations, invite_user_with_access_role,
  add_image_extension, etc.

6.0.1 - 2020-12-09
-------------------
- Extended the FieldMasks utility to retrieve a field value given the fieldmask.
- Made the update_user_access code example more robust by using 'LIKE' query
  instead of '='.

6.0.0 - 2020-11-11
-------------------
- Added support for Google Ads API v6_0.
- Removed support for Google Ads API v2.
- Added support of client configuration from environment variables.
- Refactored GoogleAdsLogger to redact email addresses present in the requests
  and responses.
- Added new services: CustomerUserAccessService, CustomAudienceService,
  CombinedAudienceService, FeedItemSetService, etc.
- Added code examples: get_change_details, update_user_access, add_lead_form_extension,
  update_audience_target_restriction, etc.
- Renamed code example authenticate_in_standalone_application to
  authenticate_in_desktop_application.

5.0.0 - 2020-08-31
-------------------
- Added support for Google Ads API v5_0.
- Added code examples: add_logical_user_list, add_combined_rule_user_list,
  add_expression_rule_user_list, add_conversion_based_user_list, add_geo_target,
  add_billing_setup, etc.

4.0.0 - 2020-07-13
-------------------
- Added support for Google Ads API v4_0.
- Renamed MutateJobService to BatchJobService.
- Added code examples: add_merchant_center_dynamic_remarketing_campaign,
  add_sitelinks_using_feeds, parallel_report_download, add_display_upload_ad, etc.

3.1.0 - 2020-05-07
-------------------
- Added support for Google Ads API v3_1.
- Added code examples: upload_conversion_adjustment, upload_call_conversion,
  approve_merchant_center_link, search_for_language_and_carrier_constants,
  add_customer_match_user_list, etc.
- Improved code examples: add_complete_campaigns_using_mutate_job,
  get_account_hierarchy, get_account_budgets.

3.0.0 - 2020-02-26
-------------------
- Added support for Google Ads API v3_0.
- Added SearchStreamHandler to support the search stream API.
- Added code examples: add_app_campaign, update_campaign_criterion_bid_modifier,
  add_listing_scope.
- Updated code examples get_campaigns and get_keyword_stats to use the search
  stream API.

2.2.0 - 2019-09-16
-------------------
- Added support for Google Ads API v2_2.
- Added code examples: get_account_hierarchy, add_smart_display_ad, add_prices,
  add_sitelinks, forecast_reach, upload_offline_conversion, etc.

2.1.0 - 2019-08-15
-------------------
- Added support for Google Ads API v2_1.
- Added examples for campaign experiments and mutate jobs.
- Added OperationService to support long running operations.

2.0.0 - 2019-06-28
-------------------
- Added support for Google Ads API v2_0.

1.0.0 - 2019-06-24
-------------------
- Initial release with support for Google Ads API v1_3.
