32.0.0 - 2026-04-22 ------------------- - Add 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.