Today, we’re announcing the December 2024 update to the Display & Video 360 API. This update includes the following: Support for additional exchanges. An increased maximum page size of 5000 for firstAndThirdAudiencePartyAudiences.list requests. To optimize quota usage, manually set the pageSize parameter of list requests to the maximum value. More details about this update can be found in the Display & Video 360 API release notes. Before using these new features, make sure to update your client library to the latest version. If you need help with these new features, please contact us ..read more

Google Ads has rolled out a new feature that allows Google Ads account administrators to grant access to a service account. Once the access has been granted, you can use the service account credentials to make API calls to that Google Ads account and other accounts in that hierarchy, if applicable. Refer to the service account guide to learn more about this option. This new approach simplifies the Google Ads API authentication process in two important ways: If your application works entirely offline without any user interaction, then you no longer need to generate a refresh token. This means ..read more

Starting November 13th, Google Ads will be implementing a new data retention policy. All account data, including performance metrics, billing information, and historical reports, will now be retained for a period of 11 years. This means that when querying the Google Ads API using either GoogleAds.Search or GoogleAds.SearchStream you will only be able to retrieve data up to 11 years before the date of your API request and data before that will not be returned. Required actions If you need historical data for more than 11 years ago, we recommend you retrieve it and store it before November 13th ..read more

On October 1, 2024, the Anonymous Inventory Modeling (AIM) reporting dimension will sunset and DST/ROC (Regulatory Operating Costs) and Total Media Cost metrics will become incompatible with YouTube reports in Display & Video 360. This will impact the structure of the reports that can be created and run using the Bid Manager API. The relevant AIM dimension is defined by Filter value FILTER_ANONYMOUS_INVENTORY_MODELING. Once sunset, queries.create and queries.run requests creating and running Query resources with this dimension will return a 400 error. The relevant cost metrics are defined ..read more

The Google Real-time Bidding protocol is deprecated and will sunset on February 15th, 2025. As previously announced, Google plans to no longer send bid requests to endpoints configured to use that protocol after it is sunset. Additionally, starting September 1st, the protocol will enter maintenance mode, and stop receiving non-critical feature and quality of service updates. If your real-time bidding integration uses the deprecated Authorized Buyers RTB protocol, Google strongly recommends that you start migrating to either our JSON or Protobuf OpenRTB implementations in order to continue acce ..read more

We're pleased to announce that v202411 of the Google Ad Manager API is available starting today, November 21, 2024. This release brings support for INVENTORY_FORMAT reporting dimensions and removes GOOGLE as a GrpProvider. In the PublisherQueryLanguageService Line_Item table, the field EndDateTime has been renamed to ServingEndTime. In both v202411 and earlier versions, the value is inclusive of any grace period. The new name differentiates the PQL field from the LineItem.endDateTime field which is exclusive of any grace period. Version Service End time including grace period End time exclud ..read more

Starting today, you can populate reports in the Bid Manager API with data that had been previously omitted due to lower statistical significance by using a new filter, FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID, and setting the value to “0”. This filter setting only impacts reach metrics with the following Metric prefixes as defined in the Bid Manager API: METRIC_UNIQUE_REACH_ METRIC_VIRTUAL_PEOPLE_DUPLICATE_ METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_ METRIC_VIRTUAL_PEOPLE_OVERLAP_ queries.create requests with queries that filter by FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID but don’t include impacted metrics will re ..read more

We’re announcing our tentative 2025 release and sunset schedule for upcoming versions of the Google Ads API to bring greater clarity to your planning cycle. Please keep in mind that these dates are only estimates and may be adjusted going forward. Additionally, releases may be added, removed, or switched between major and minor versions. Version Planned Release Type* Projected launch* Projected sunset* V19 Major February/March 2025 February 2026 V19_1 Minor April/May 2025 February 2026 V20 Major June/July 2025 June 2026 V20_1 Minor August/September 2025 June 2026 V21 Major October ..read more

Starting in January 2025, we will enable consent unbundling in Google Ads scripts. This is a new feature of OAuth that allows you to customize which specific scopes you want to authorize, rather than the current all-or-nothing approach. Consent unbundling is being rolled out in all Google OAuth applications. Google Ads scripts already runs a static analysis on your code before presenting the OAuth consent screen, and only requests the specific features that are required to run the script. Therefore, when you authorize Google Ads scripts, ensure that you select all the boxes on that screen, or ..read more

With v18 of the Google Ads API, you can now use the Recommendations.GenerateRecommendations method during campaign construction to retrieve optimized budget suggestions for Performance Max and Search campaigns. When using the GenerateRecommendations method with a recommendation type of CAMPAIGN_BUDGET, you can supply inputs, such as final URL and bidding strategy, which Google machine learning models will use to generate budget recommendations. Google Ads API users that provide a campaign creation interface can provide budget prefills that fit into the campaign creation workflow. As with many ..read more