Wednesday, February 21, 2024 Today, we're announcing the v16 release of the [Google Ads API](https://developers.google.com/google-ads/api). To use some of the v16 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.
[Video](https://www.youtube.com/watch?v=Vn5_DBvpABA) Here are the highlights: - Added the following recommendation types: [`MAXIMIZE_CONVERSION_VALUE_OPT_IN`](https://developers.google.com/google-ads/api/reference/rpc/latest/RecommendationTypeEnum.RecommendationType#maximize_conversion_value_opt_in), [`IMPROVE_GOOGLE_TAG_COVERAGE`](https://developers.google.com/google-ads/api/reference/rpc/latest/RecommendationTypeEnum.RecommendationType#improve_google_tag_coverage), [`PERFORMANCE_MAX_FINAL_URL_OPT_IN`](https://developers.google.com/google-ads/api/reference/rpc/latest/RecommendationTypeEnum.RecommendationType#performance_max_final_url_opt_in), [`REFRESH_CUSTOMER_MATCH_LIST`](https://developers.google.com/google-ads/api/reference/rpc/latest/RecommendationTypeEnum.RecommendationType#refresh_customer_match_list), [`CUSTOM_AUDIENCE_OPT_IN`](https://developers.google.com/google-ads/api/reference/rpc/latest/RecommendationTypeEnum.RecommendationType#custom_audience_opt_in), [`LEAD_FORM_ASSET`](https://developers.google.com/google-ads/api/reference/rpc/latest/RecommendationTypeEnum.RecommendationType#lead_form_asset), [`IMPROVE_DEMAND_GEN_AD_STRENGTH`](https://developers.google.com/google-ads/api/reference/rpc/latest/RecommendationTypeEnum.RecommendationType#improve_demand_gen_ad_strength) - Added [`RecommendationService.GenerateRecommendations()`](https://developers.google.com/google-ads/api/reference/rpc/latest/RecommendationService#generaterecommendations) which returns recommendations based on your specified settings, such as recommendation types or advertising channel types. This could be helpful when creating a campaign. - Added support for time-related segments, such as [`segments.year`](https://developers.google.com/google-ads/api/fields/latest/segments#segments.year) and [`segments.month`](https://developers.google.com/google-ads/api/fields/latest/segments#segments.month)%7B:.external%7D), to [`asset_group`](https://developers.google.com/google-ads/api/fields/latest/asset_group). - Migrated `advertising_partner` from [`AccountLink`](https://developers.google.com/google-ads/api/reference/rpc/latest/AccountLink) to [`ProductLink`](https://developers.google.com/google-ads/api/reference/rpc/latest/ProductLink#advertising_partner) and [`ProductLinkInvitation`](https://developers.google.com/google-ads/api/reference/rpc/latest/ProductLinkInvitation#advertising_partner), and also removed support for `data_partner` and `google_ads` from [`AccountLink`](https://developers.google.com/google-ads/api/reference/rpc/latest/AccountLink). - Added `primary_status` and `primary_status_reasons` to [`AdGroup`](https://developers.google.com/google-ads/api/reference/rpc/latest/AdGroup) and [`AdGroupAd`](https://developers.google.com/google-ads/api/reference/rpc/latest/AdGroupAd), respectively, to provide insight into why an ad group or an ad group ad is serving or not serving. - Added support for [advertiser verification](https://support.google.com/adspolicy/answer/9870201) by adding [`IdentityVerificationService`](https://developers.google.com/google-ads/api/reference/rpc/latest/IdentityVerificationService) to allow for programmatically starting a verification session using the provided [`verification_program`](https://developers.google.com/google-ads/api/reference/rpc/latest/StartIdentityVerificationRequest#verification_program) and for retrieving all identity verifications. - Added support for setting [`Campaign.shopping_setting`](https://developers.google.com/google-ads/api/reference/rpc/latest/Campaign#shopping_setting) to an existing Demand Gen campaign. The following new fields are added specifically for Demand Gen campaigns: - [`ShoppingSetting.disable_product_feed`](https://developers.google.com/google-ads/api/reference/rpc/latest/Campaign.ShoppingSetting#disable_product_feed) to disable the optional product feed. - [`Ad.demand_gen_product_ad`](https://developers.google.com/google-ads/api/reference/rpc/latest/Ad#demand_gen_product_ad) containing information about the Demand Gen product ad, such as the business name and headline. - Added [`Experiment.sync_enabled`](https://developers.google.com/google-ads/api/reference/rpc/latest/Experiment#sync_enabled) to let you apply changes made to the original campaign to the experiment campaign, while the experiment is running. This saves time from manually applying changes to the experiment campaign. - Recommended keywords with unset keyword match type will now have [`recommended_match_type`](https://developers.google.com/google-ads/api/reference/rpc/latest/Recommendation.KeywordMatchTypeRecommendation#recommended_match_type) set to `UNSPECIFIED` instead of `UNKNOWN`. - Updated the operation types for customer life cycle goals and campaign life cycle goals to make them consistent with other operation types. - Added support for tracking the progress of the business registration verification process of Local Services using [`LocalServicesVerificationArtifact.business_registration_check_verification_artifact`](https://developers.google.com/google-ads/api/reference/rpc/latest/LocalServicesVerificationArtifact#business_registration_check_verification_artifact). - Added a new report [`local_services_employee`](https://developers.google.com/google-ads/api/fields/latest/local_services_employee) that lets you retrieve the employee information you've added.
**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 v15 and v16](https://developers.google.com/google-ads/api/docs/diff)
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)