Wednesday, October 16, 2024
Today, we're announcing the v18 release of the [Google Ads API](https://developers.google.com/google-ads/api). To use the v18 features, you will need to upgrade your [client libraries](https://developers.google.com/google-ads/api/docs/client-libs.md.txt) and client code. The updated client libraries and code examples will be published next week.  

<br />

[Video](https://www.youtube.com/watch?v=RZt_hrvUvk4)

Here are the highlights:

- You can now use [`GenerateRecommendations`](https://developers.google.com/google-ads/api/reference/rpc/latest/RecommendationService#generaterecommendations) during campaign construction to retrieve optimized budget suggestions for Performance Max and Search campaigns.
- A new [`performance_max_placement_view`](https://developers.google.com/google-ads/api/fields/latest/performance_max_placement_view) report allows developers to query performance data for a given placement where Performance Max ads served.
- Replaced the `summary_row_setting` and `return_total_results_count` fields of [`SearchGoogleAdsRequest`](https://developers.google.com/google-ads/api/reference/rpc/latest/SearchGoogleAdsRequest) with the [`search_settings`](https://developers.google.com/google-ads/api/reference/rpc/latest/SearchGoogleAdsRequest#search_settings) field, which allow developers to freely specify if `summary_row`, `total_results_count` and `results` will be returned with [`SearchGoogleAdsResponse`](https://developers.google.com/google-ads/api/reference/rpc/latest/SearchGoogleAdsResponse).
- Added new segments for [`campaign`](https://developers.google.com/google-ads/api/fields/latest/campaign) and [`ad_group`](https://developers.google.com/google-ads/api/fields/latest/ad_group) reports to allow for segmenting performance data based on a specific destination, such as a city or a country, for Hotel and Search campaigns.
- Added support for [Travel Feeds in Search Ads](https://support.google.com/google-ads/answer/15265488) with a new click type ([`ClickType.TRAVEL_ASSETS`](https://developers.google.com/google-ads/api/reference/rpc/latest/ClickTypeEnum.ClickType#travel_assets)) and a new asset type ([`AssetSetType.TRAVEL_FEED`](https://developers.google.com/google-ads/api/reference/rpc/latest/AssetSetTypeEnum.AssetSetType#travel_feed)).
- Added [`DataLinkService.CreateDataLink`](https://developers.google.com/google-ads/api/reference/rpc/latest/DataLinkService#createdatalink), which allows customers to link their Google Ads account to creator videos and enables running partnership ads.
- Added [`content_criterion_view`](https://developers.google.com/google-ads/api/fields/latest/content_criterion_view) which returns performance metrics of [targeted contents](https://support.google.com/google-ads/answer/1704368#Content-Targeting), such as keywords, placements and topics, for Display, Demand Gen and Video campaigns.
- `Renamed AssetType.DISCOVERY_CAROUSEL_CARD` to [`AssetType.DEMAND_GEN_CAROUSEL_CARD`](https://developers.google.com/google-ads/api/reference/rpc/latest/AssetTypeEnum.AssetType#demand_gen_carousel_card).
- Added [`AdGroup.exclude_demographic_expansion`](https://developers.google.com/google-ads/api/reference/rpc/latest/AdGroup#exclude_demographic_expansion) which allows excluding demographics from being expanded when [`optimized_targeting_enabled`](https://developers.google.com/google-ads/api/reference/rpc/latest/AdGroup#exclude_demographic_expansion) is true, a feature that was previously only supported for Demand Gen.
- [`PhoneCallDetails.call_recording_url`](https://developers.google.com/google-ads/api/reference/rpc/v17/PhoneCallDetails#call_recording_url) will be empty instead of providing an invalid URL if the call recording doesn't exist for the given Local Services lead conversation.
- Added new metrics related to invalid clicks which can be queried with the [`campaign`](https://developers.google.com/google-ads/api/fields/latest/campaign) report.

<br />

**Where can I learn more?**   

The following resources can help you get started:

- [Release Notes](https://developers.google.com/google-ads/api/docs/release-notes.md.txt)
- [Guides](https://developers.google.com/google-ads/api/docs)
- [Reference](https://developers.google.com/google-ads/api/reference/rpc)
- [Diff between v17 and v18](https://developers.google.com/google-ads/api/docs/diff)

<br />

If you have any questions or need additional help, contact us via the [forum](https://groups.google.com/forum/#!forum/adwords-api).  

![Portrait of the author](https://developers.google.com/static/ads/blog/images/photo_1.jpg) - Thanet Knack Praneenararat, on behalf of the Google Ads API Team


**Labels:**

[google-ads-api](https://developers.google.com/ads/blog/feeds/labels/google-ads-api.md.txt),

[release](https://developers.google.com/ads/blog/feeds/labels/release.md.txt)