Learn more about migrating to the Google Ads API by watching our latest webinar

Release Notes

v8.0 (2021-06-09)

The functionality and changes below were added in v8.0.

Account Management

Ads

Asset

  • Set response_content_type to MUTABLE_RESOURCE as a request parameter to return all the fields mutated in a mutate request for CustomerAssetService, CampaignAssetService and AdGroupAssetService.
  • Added support for the following metrics for CustomerAsset, CampaignAsset and AdGroupAsset:
    • absolute_top_impression_percentage
    • all_conversions
    • all_conversions_from_interactions_rate
    • all_conversions_value
    • average_cost
    • average_cpc
    • average_cpe
    • average_cpm
    • average_cpv
    • clicks
    • conversions
    • conversions_from_interactions_rate
    • conversions_value
    • cost_micros
    • cost_per_all_conversions
    • cost_per_conversion
    • cross_device_conversions
    • ctr
    • engagement_rate
    • engagements
    • interactions
    • interaction_event_types
    • interaction_rate
    • impressions
    • top_impression_percentage
    • value_per_all_conversions
    • value_per_conversion
    • video_view_rate
    • video_views
  • Added segments.asset_interaction_target for CustomerAsset, CampaignAsset and AdGroupAsset to indicate if the interactions are on the asset itself.
  • Added AssetFieldTypeViewService to support retrieving metrics for each asset field type when the asset is used as extension.
  • Updated the following values of LeadFormFieldUserInputType:
    • Replaced GIVEN_NAME with FIRST_NAME.
    • Replaced FAMILY_NAME with LAST_NAME.
  • Asset-based extensions

Audiences

  • Added TransactionAttribute.item_attribute to support associate information about a sold item with a transaction.
  • Added the following fields to UserAttribute:
    • last_purchase_date_time
    • average_purchase_count
    • average_purchase_value_micros
    • acquisition_date_time
  • Added the following values to OfflineUserDataJobError:
    • FUTURE_TIME_NOT_ALLOWED
    • LAST_PURCHASE_TIME_LESS_THAN_ACQUISITION_TIME

Bidding

  • Updated Maximize_conversion_value.target_roas to support an optional Target ROAS setting on the Maximize Conversion Value portfolio and standard bidding strategies for Search campaigns. This field will become mutable for all customers at a future date. We will post a notification on the Google Ads Developer blog when developers can update this field.
  • Updated Maximize_conversions.target_cpa to support an optional Target CPA setting on the Maximize Conversions portfolio and standard bidding strategies for Search campaigns. This field will become mutable for all customers at a future date. We will post a notification on the Google Ads Developer blog when developers can update this field.
  • Added support for creating and managing cross-account bidding strategies in manager accounts, and the ability to attach them to campaigns in customer accounts:
    • Added BiddingStrategy.currency_code for bidding strategies in manager customers, which can be set on creation and defaults to the manager customer's currency. For serving customers, this field cannot be set; all strategies in a serving customer implicitly use the serving customer's currency. In all cases the effective_currency_code field returns the currency used by the strategy.
    • Added AccessibleBiddingStrategy to represent a view of all BiddingStrategies owned by and shared with the customer.
    • Added AccessibleBiddingStrategyService to read accessible bidding strategies.
    • Added Campaign.accessible_bidding_strategy for retrieving the fields of the portfolio bidding strategy identified by bidding_strategy.When a campaign uses a cross-account bidding strategy, this will be a subset of the properties normally defined for a bidding strategy, since certain properties are only accessible by a bidding strategy’s owner.

Campaigns

Conversions

Criteria

Feeds

Recommendations

v7.0 (2021-04-28)

The functionality and changes below were added in v7.0.

Account Management

Ads

Assets

Audiences

Batch Jobs

Bidding

Campaigns

Campaign Drafts and Experiments

Conversions

Criteria

Feeds

Hotel Ads

  • Added hotel_check_in_date_range to AdGroupBidModifier. By setting the range of dates, the bid will be modified if the user's check-in date falls within the range.

Planning

Protos

  • Updated the method comments in the proto library to include a list of possible errors that can be thrown for each method.

Recommendations

Reporting

Resources

  • Added support for returning errors that specifically say which resources has exceeded the limit when ResourceCountLimitExceededError.RESOURCE_LIMIT is returned:
    • Added ResourceLimitTypeEnum to include which resource limit was exceeded.
    • Added resource_count_details to ErrorDetails to include details of the maximum limit of the resource and the current count of the resource type in the account.

Tools

Video

6.1.0 (2021-02-10)

The functionality and changes below were added in v6.1.0.

Account Management

Ads

Campaigns

Change History

Conversions

Criteria

Feeds

Hotel Ads

Recommendations

Reporting

Resources

  • Improved an error message thrown when a malformed resource name is passed by also showing the correct form. For example, customers/{customer_id}/customerUserAccesses/{user_id} instead of customers/{part_1}/customerUserAccesses/{part_2}.

6.0.0 (2020-11-05)

The functionality and changes below were added in v6.0.0.

Account Management

Ads

Audiences

Bidding

Billing

  • Added the following fields to Invoice:
    • adjustments_subtotal_amount_micros
    • adjustments_tax_amount_micros
    • adjustments_total_amount_micros
    • regulatory_costs_subtotal_amount_micros
    • regulatory_costs_tax_amount_micros
    • regulatory_costs_total_amount_micros
  • Removed Invoice.invoice_level_adjustment_micros.

Campaigns

Change History

  • Added the resource ChangeEvent to retrieve the Change History of a Google Ads account. This is similar to Change History in the UI, including retrieving what interface made the change and who made the change.

Client libraries

  • The API finished moving towards using field presence such as optional string and optional double instead of wrapper types such as StringValue and DoubleValue. Your code will be easier to use and more concise with payloads that are significantly smaller. Approximately half of our resources have been updated in this release; the other half was updated in v5. The full list is in the migration guide, and our code examples have been updated.
  • Added a separator (~) for compound IDs in resource name patterns. For example, in ad_group_ad.proto, customers/{customer}/adGroupAds/{ad_group_ad} changed to customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}.

Criteria

Feeds

  • Set response_content_type to MUTABLE_RESOURCE as a request parameter to return all the fields mutated in a mutate request for FeedItemTargetService.

Planning

Recommendations

  • Added Customer.optimization_score_weight. This is only available for non-manager accounts and is used to determine the overall optimization score of the manager account. Retrieve the optimization score and optimization score weight of sub-accounts and multiply them (Customer.optimization_score * Customer.optimization_score_weight) to determine the overall optimization score.
  • Added support for the recommendation type FORECASTING_CAMPAIGN_BUDGET.

Reporting