Now Available: Google Ads API Version 10

 The Google Ads API version 10.0 has been made available by Google. Remember that the AdWords API will cease to exist on April 27, 2022, which is quickly approaching. So what has changed in Google Ads API version 10? Several things, including smart campaigns, improvements to performance max campaigns, adjustments to local service ads, and much more.

A new diff page that lists the prototypes that were added, deleted, and modified in the most recent Google Ads API release was also created by Google. Once the protos are published, you can click the links to view them on our GitHub repository. The Changed tab allows you to view both fast and full-context diffs.

Account Management

• added Customer.status and CustomerClient.status, both of which have the type CustomerStatus and display the account status.
• When utilizing CustomerService, all account types can now be retrievedGoogleAdsService.Search, ListAccessibleCustomers, and GoogleAdsService.SearchStream. They used to just return test accounts and ENABLED accounts.

Ads

• Video TrueView Discovery has a new name VideoTrueViewDiscoveryAdInfo is changed to InFeedVideoAdInfo as the ad format for In-Feed Video Ad.
• It is now called AdType.VIDEO TRUEVIEW DISCOVERY AD.
• IN FEED VIDEO AD.
• Changed the name of the operation to MutateOperation.customer customizer operation.

Assets

• Ad group ad asset combination view has been made available for responsive search advertisements.
• Ad group ad asset view now includes support for reporting the effectiveness of App pre-registration ads.
• For assets that have image asset and media bundle asset set, respectively, for images and media bundles:
• Made name necessary.
• Support for automatically renaming assets at creation has been added. The asset is renamed by adding the supplied name, a timestamp, and a counter if it already has the same name but different content.
• For the following asset types, the uploaded asset will be discreetly deleted if another asset with a different name and the same content already exists. Text, call to action, call-to-action button, and image Google Books
• The following values for asset sets have been added to ResourceLimitType: ASSET PER PAGE FEED ASSET SET, ASSET PER DYNAMIC EDUCATION FEED ASSET SET, and DYNAMIC EDUCATION FEED ASSET SETS PER CUSTOMER.
• The following values have been added to AssetError: NAME REQUIRED FOR ASSET TYPE, MOBILE APP INVALID APP ID, and MOBILE APP INVALID FINAL URL FOR APP DOWNLOAD URL.

Audiences

• Support has been added for Audience, which is used to target users based on created dimensions such user interests, memberships in user lists, or demographics:
• Service to the Audience: AudienceService
• Other resources' fields: Campaign.audience setting, AdGroup.audience setting, GoogleAdsRow.audience, and AdGroupCriterion.audience
• CriterionType and AudienceError are enums.AUIDIENCE

Bidding

• Removed support for creating seasonality adjustments on manager accounts.
• Added the following values to BiddingError: BIDDING_STRATEGY_AND_BUDGET_MUST_BE_ALIGNED, BIDDING_STRATEGY_AND_BUDGET_MUST_BE_ATTACHED_TO_THE_SAME_CAMPAIGNS_TO_ALIGN, BIDDING_STRATEGY_AND_BUDGET_MUST_BE_REMOVED_TOGETHER

Campaigns

• Smart campaigns have left open beta and are now available to everyone.
• Campaigns for Local Services Ads now have open beta support.
• They have LOCAL SERVICES as their AdvertisingChannelType.
• Support for locating these campaigns through Search and SearchStream has been added.
• Support for modifying their amount micros and status has been added. CampaignBudget objects that are related.
• Advertisers may now use Performance Max Campaigns' asset group signals to tell the campaign which users are most likely to convert.
• For Smart Shopping campaigns, Campaign.use vehicle inventory has been included.

Conversions

• The conversion tracking setting attribute of Customer now includes the following fields:
• If the customer is using conversion tracking, conversion tracking status shows that information, along with the conversion tracking owner.
• Accepted customer data terms shows whether the conversion tracking owner has agreed to the conditions governing the use of customer data.
• If a customer has selected improved conversions for leads, it will say enhanced conversions for leads enabled.
• ConversionAction.primary for goal was changed to be optional in order to facilitate setting the value to false while performing create operations.
• Immutability was added to ConversionValueRuleSet.attachment type.
• To allow conversion value rules for store visits and store purchases, the variables ConversionValueRuleSet.conversion action categories and ValueRuleSetDimension.NO CONDITION were added.
• ConversionValueRuleSetError now includes the following values: DIMENSION NO CONDITION NOT ALLOWED, INELIGIBLE CONVERSION ACTION CATEGORIES, and DIMENSION NO CONDITION USED WITH OTHER DIMENSIONS
• LEAD has been replaced with the new values listed below in the ConversionActionCategory enum in place of LEAD: the leads QUALIFIED LEAD and CONVERTED LEAD
• Addition of ExternalConversionSource.DISPLAY AND VIDEO 360 FLOODLIGHT

Experiments

• added a new ExperimentService that replaces campaign experiments and has a number of new resources.

Hotel Ads

• The following metrics have been supported: metrics.hotel expected commission cost and metrics.hotel commission rate micros. Hotel reconciliation.campaign has also been added.

Recommendations

• Support for ResponsiveSearchAdAssetRecommendation has been added.
• Additional backing for returning UseBroadMatchKeywordRecommendation.

Reporting

• Fixed errors where some reports' segmentation selections would return rows with zero metrics. Now, zero-metric rows will always be ignored in reports that choose metrics and segments, as expected.
• added the omit unselected resource names meta argument. When set to true, the SELECT clause of your query's answer from GoogleAdsService will only include resource name fields that you specifically request.
• Campaign.start date and Campaign.end date are always retrieved with the customer's supplied customer id of the SearchGoogleAdsRequest or SearchGoogleAdsStreamRequest, and the date received is always formatted according to that customer's time zone. Previously, the date that was returned could differ depending on the manager account's set time zone in login-customer-id.
• Support for metrics.top impression percentage and metrics.absolute top impression percentage has been added, along with geographic view and segments.hour.
• Support has been added for the following metrics.sk ad network conversions (SKAdNetwork conversions) segments, which are accessible when obtaining customer or campaign data: Segments include Sk Ad Network User Type, Sk Ad Network Ad Event Type, and Sk Ad Network Source App Id.
• Metrics for "biddable app install conversions" and "biddable app post install conversions" have been added.

RMF

• New specifications have been added for Performance Max and Smart campaigns. We are also streamlining typical shopping campaigns to correspond with full service campaigns and defining the necessary minimal functionality for additional developer tools like shopping, hotel, and app campaigns.