Skip to content

Latest commit

 

History

History
315 lines (274 loc) · 12.1 KB

CHANGELOG.md

File metadata and controls

315 lines (274 loc) · 12.1 KB
Raw

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

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.