Sunsetted versions

For archival purposes, so links on this page might not work.

v15 (2023-10-18)

The following new features and updates were introduced in v15.

Account Management

Assets

Audiences

  • For Customer Match, added CustomerMatchUserListMetadata.consent to support providing a consent. Starting on March 6, 2024 if consent is missing for EEA users, then the consent value is determined as not consented. Data from unconsented EEA users won't be processed and cannot be used for ad personalization using Customer Match. Check out our Customer Match guide for more details.
  • For Store Sales, added UserData.consent to support providing a consent. Check out our Store Sales guide for more details. If you are using Customer Match with store sales, review the FAQ for additional information.
  • Added UserList.lookalike_user_list to support creating a Lookalike segment, an audience created based on the provided existing seed audience. Lookalike segments can be used in a Demand Gen campaign only.

Campaigns

Conversions

Hotel & Travel

Local Services Ads

Planning

Recommendations

Reporting

Shopping

Unified Goals

Videos

The following new features and updates were introduced in v14.1.

Account Management

Assets

  • New fields in AssetGroup to show whether the asset group is serving or the reasons why it's not serving:
    • primary_status
    • primary_status_reasons
  • New fields in AssetGroupAsset to show whether the asset group asset is serving or the reasons why it's not serving:
    • primary_status
    • primary_status_details
    • primary_status_reasons
  • New values in the CallToActionType enum:
    • BUY_NOW
    • DONATE_NOW
    • ORDER_NOW
    • PLAY_NOW
    • SEE_MORE
    • START_NOW
    • VISIT_SITE
    • WATCH_NOW
  • New values in the AssetLinkError enum:
    • CUSTOMER_NOT_VERIFIED
    • UNSUPPORTED_CALL_TO_ACTION
    • PAGE_FEED_INVALID_LABEL_TEXT

Billing

  • New fields in Invoice and AccountSummary:
    • export_charge_subtotal_amount_micros
    • export_charge_tax_amount_micros
    • export_charge_total_amount_micros

Campaigns

Criteria

Experiments

  • New values in the ExperimentError enum:
    • DUPLICATE_EXPERIMENT_CAMPAIGN_NAME
    • CANNOT_REMOVE_IN_CREATION_EXPERIMENT
    • CANNOT_ADD_CAMPAIGN_WITH_DEPRECATED_AD_TYPES

Recommendations

Reporting

Shopping

Videos

v14 (2023-06-07)

The following new features and updates were introduced in v14.

Campaigns

Conversions

Criteria

Hotel Ads

Planning

Recommendations

Reporting

v13.1.0 (2023-04-26)

The following new features and updates were introduced in v13.1.

Assets

Audiences

  • New values in the UserListError enum:
    • APP_ID_NOT_ALLOWED
    • CANNOT_MUTATE_SYSTEM_LIST
    • MOBILE_APP_IS_SENSITIVE

Campaigns

Conversions

Planning

Recommendations

Reporting

v13 (2023-02-15)

The following new features and updates were introduced in v13.

Account Management

  • Added ProductLinkService to support adding and removing a link between a Google Ads account and another product. This is similar to the Linked accounts view in the Google Ads UI. In this version, only Customer Match data partner linking is supported.

Assets

Audiences

  • Removed CombinedRuleUserListInfo and ExpressionRuleUserListInfo and their references from RuleBasedUserListInfo. Use FlexibleUserListInfo instead.
  • Added QualifyingQuestion and qualifying_question to support returning details about qualifying questions of lead form assets. When advertisers suggest a qualifying question, it'll be reviewed and approved before being used in the lead forms.

Batch Jobs

Billing

Campaigns

  • Added SmartCampaignSettingService.GetSmartCampaignStatus for retrieving a more aggregated view of assets belonging to the Smart campaign. This should be preferred over other status fields—for example, Campaign.primary_status or Campaign.primary_status_reasons for Smart campaigns.
  • Replaced AdGroup.explorer_auto_optimizer_setting with AdGroup.optimized_targeting_enabled to support optimized targeting. This is for the following AdvertisingChannelType: DISPLAY, VIDEO, DISCOVERY. This field is for allowlisted customers only.
  • Added several new enum values to CampaignError:
    • AVERAGE_DAILY_SPEND_TOO_HIGH
    • CANNOT_ATTACH_TO_REMOVED_CAMPAIGN_GROUP
    • CANNOT_ATTACH_TO_BIDDING_STRATEGY
    • CANNOT_CHANGE_BUDGET_PERIOD
    • CANNOT_CREATE_DRAFT_CAMPAIGN
    • CANNOT_CREATE_MORE_THAN_ONE_DRAFT_CAMPAIGN
    • NOT_ENOUGH_CONVERSIONS
    • CANNOT_SET_MORE_THAN_ONE_CONVERSION_ACTION
    • NOT_COMPATIBLE_WITH_BUDGET_TYPE
    • NOT_COMPATIBLE_WITH_UPLOAD_CLICKS_CONVERSION
    • TRIAL_MUST_USE_SAME_BUDGET_AS_BASE
    • INVALID_EXCLUDED_PARENT_ASSET_SET_TYPE

Conversions

Criteria

Errors

Hotel & Travel

Recommendations

Shopping

Video

12.0.0 (2022-10-26)

The features and changes below were added in v12.

Account Management

  • Added a new account link type, ADVERTISING_PARTNER for linking a customer account to another one. This is preparation for an upcoming feature in a following release.
  • Added AccountLinkError.PERMISSION_DENIED for the case where a non-admin user tries to create an account link.

Ads

Assets

Audiences

Bidding

Billing

Campaigns

Conversions

Criteria

  • Added the following asset set fields to LocationGroupInfo for test accounts:

    • enable_customer_level_location_asset_set
    • location_group_asset_sets
  • Added the following values to CriterionError:

    • CANNOT_SET_ASSET_SET_FIELD_FOR_CUSTOMER
    • CANNOT_SET_ASSET_SETS_WITH_FEED_ITEM_SETS
    • CANNOT_SET_BOTH_ASSET_SET_AND_FEED
    • CANNOT_SET_FEED_OR_FEED_ITEM_SETS_FOR_CUSTOMER
    • CANNOT_SET_GEO_TARGET_CONSTANTS_WITH_ASSET_SETS
    • INVALID_LOCATION_GROUP_ASSET_SETS

Errors

Previous ErrorNew Error
BiddingError.BID_TOO_BIG RangeError.TOO_HIGH
BiddingError.BID_TOO_SMALL RangeError.TOO_LOW
FieldError.INVALID_VALUE ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT
BiddingStrategyError.CANNOT_CHANGE_BIDDING_STRATEGY_TYPE FieldError.IMMUTABLE_FIELD
MutateError.RESOURCE_READ_ONLY MutateError.MUTATE_NOT_ALLOWED
OperationAccessDeniedError.MUTATE_ACTION_NOT_PERMITTED_FOR_CLIENT MutateError.MUTATE_NOT_ALLOWED

Experiments

Feeds

Planning

Recommendations

Reporting

Video

11.1.0 (2022-08-17)

The functionality and changes below were added in v11.1.

Assets

Audiences

Bidding

Campaigns

  • Added support for the following metrics in the campaign report:
    • all_conversions_from_click_to_call
    • all_conversions_from_directions
    • all_conversions_from_menu
    • all_conversions_from_order
    • all_conversions_from_other_engagement
    • all_conversions_from_store_visit
    • all_conversions_from_store_website
  • Made metrics.phone_call compatible with segments.hour in the campaign report.

Experiments

Planning

Recommendations

11.0 (2022-06-08)

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

Assets

Audiences

  • Removed DateSpecificRuleUserListInfo and RuleBasedUserListInfo.date_specific_rule_user_list.

Bidding

Campaigns

Conversions

Criteria

Experiments

  • Removed ExperimentType.SMART_DISPLAY.

Planning

Recommendation

Reporting

Shopping

  • Added ShoppingSetting.feed_label, a more flexible way of matching campaigns with Merchant feeds. This field replaces the functionality of ShoppingSetting.sales_country. Only one of these fields can be used at a time, but both fields are supported. This is available to allowlisted accounts only.

10.1.0 (2022-04-27)

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

Assets

Audiences

Batch Jobs

Campaigns

Change History

Conversions

Criteria

Experiments

Hotel Ads

Planning

Reporting

Video

10.0 (2022-02-09)

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

All Services

The get method and any services that exclusively had a get method have been removed. Retrieve objects with Search and SearchStream from GoogleAdsService.

Account Management

Ads

  • Renamed Video TrueView Discovery Ad format to In-Feed Video Ad:
    • VideoTrueViewDiscoveryAdInfo is renamed to InFeedVideoAdInfo.
    • AdType.VIDEO_TRUEVIEW_DISCOVERY_AD is renamed to AdType.IN_FEED_VIDEO_AD.
  • Renamed MutateOperation.customizer_customizer_operation to MutateOperation.customer_customizer_operation.

Assets

  • Added support for ad_group_ad_asset_combination_view for responsive search ads.
  • Added support for reporting the performance of App pre registration ads in ad_group_ad_asset_view.
  • For Image and Media Bundle assets (Asset that has image_asset and media_bundle_asset set, respectively):
    • Made name required.
    • Added support for auto-renaming the asset names on creation. If an asset exists with the same name but different content, it is renamed by appending the specified name with a timestamp and a counter.
  • For the following asset types, if an asset with a different name having the same content already exists then the asset uploaded will be silently dropped.
  • Added the following values related to asset sets to ResourceLimitType:
    • PAGE_FEED_ASSET_SETS_PER_CUSTOMER
    • DYNAMIC_EDUCATION_FEED_ASSET_SETS_PER_CUSTOMER
    • ASSET_PER_PAGE_FEED_ASSET_SET
    • ASSET_PER_DYNAMIC_EDUCATION_FEED_ASSET_SET
  • Added the following values to AssetError:
    • MOBILE_APP_INVALID_APP_ID
    • MOBILE_APP_INVALID_FINAL_URL_FOR_APP_DOWNLOAD_URL
    • NAME_REQUIRED_FOR_ASSET_TYPE

Audiences

Bidding

Campaigns

Conversions

Experiments

Hotel Ads

Recommendations

Reporting

RMF

  • Added new requirements for Performance Max and Smart campaigns. We are also documenting the required minimum functionality for other developer tools such as shopping, hotel and app campaigns, and simplifying standard shopping campaigns to align with full service campaigns.

9.0 (2021-11-03)

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

Account Management

Ads

Assets

  • Added the following asset types, which will be available in all accounts by the end of 2021:
    • Added price_asset to Asset to support price assets.
    • Added hotel_callout_asset to Asset to support hotel callout assets.
    • Added mobile_app_asset to Asset to support mobile app assets.
    • Added call_asset to Asset to support call assets.
    • Added call_to_action to Asset to support call to action assets.
  • Added support for asset groups for Performance Max:
  • Added support for asset sets:
  • Added support for reporting the performance of the following ad types in ad_group_ad_asset_view:
  • Added AssetLinkError.YOUTUBE_VIDEO_DURATION_NOT_DEFINED.
  • Added FeedError.LEGACY_EXTENSION_TYPE_READ_ONLY for extension types migrated to Asset.
  • TextAsset is now read/write.
  • Added values to AssetError:
    • CALL_CARRIER_SPECIFIC_SHORT_NUMBER_NOT_ALLOWED
    • CALL_CUSTOMER_CONSENT_FOR_CALL_RECORDING_REQUIRED
    • CALL_DISALLOWED_NUMBER_TYPE
    • CALL_INVALID_CONVERSION_ACTION
    • CALL_INVALID_COUNTRY_CODE
    • CALL_INVALID_DOMESTIC_PHONE_NUMBER_FORMAT
    • CALL_INVALID_PHONE_NUMBER
    • CALL_PHONE_NUMBER_NOT_SUPPORTED_FOR_COUNTRY
    • CALL_PREMIUM_RATE_NUMBER_NOT_ALLOWED
    • CALL_VANITY_PHONE_NUMBER_NOT_ALLOWED
    • PRICE_HEADER_SAME_AS_DESCRIPTION

Audiences

Bidding

Billing

Campaigns

  • Added support for Performance Max campaigns, which is a new campaign type that provides a unified buying service to virtually all Google Ads inventory.
  • Changes in Smart campaigns:

    • Smart campaigns have entered open beta and users no longer need to be allowlisted to use them.
    • Added SmartCampaignSuggestService.SuggestKeywordThemes to generate keyword theme suggestions for Smart campaigns based on the business details provided.

      This provides more comprehensive suggestions than SuggestKeywordThemeConstants, and is now the recommended way to generate keyword themes for a Smart campaign.

    • Improved error handling and additional user-facing error codes.

Conversions

  • Added support for conversion goals to help you more easily optimize towards your advertising objects.
  • Changes related to ConversionAdjustmentUploadService:
  • Changes related to ConversionUploadService:
  • Made UserIdentifier.user_identifier_source optional.
  • Improved ConversionUploadService and ConversionAdjustmentService to report an error if the ClickConversion, CallConversion, or ConversionAdjustment in a mutate operation already exists or is a duplicate to another one in the same mutate operation. Prior to v9, the Google Ads API would silently ignore such operations. The error returned by each service will be as follows:
    • For ConversionUploadService:
      • For a click conversion: a ConversionUploadError with CLICK_CONVERSION_ALREADY_EXISTS or DUPLICATE_CLICK_CONVERSION_IN_REQUEST
      • For a call conversion: a ConversionUploadError with CALL_CONVERSION_ALREADY_EXISTS or DUPLICATE_CALL_CONVERSION_IN_REQUEST
    • For ConversionAdjustmentService:
      • For a restatement: a ConversionAdjustmentUploadError with RESTATEMENT_ALREADY_EXISTS or DUPLICATE_ADJUSTMENT_IN_REQUEST
      • For an enhancement: a ConversionAdjustmentUploadError with CONVERSION_ALREADY_ENHANCED or DUPLICATE_ENHANCEMENT_IN_REQUEST
  • Removed INVALID_USER_IDENTIFIER_SOURCE from ConversionAdjustmentUploadError and ConversionUploadError.

Feeds

  • Deprecated extension setting services:

    • AdGroupExtensionSettingService
    • CampaignExtensionSettingService
    • CustomerExtensionSettingService
    • ExtensionFeedItemService
  • Deprecated most use cases of feed service in favor of assets:

    • All extensions apart from location extensions should migrate to assets.
    • DSA page feed should migrate to assets.
    • Dynamic remarketing for education should migrate to assets. Other dynamic remarketing types will follow in a release.
    • Ad customizers are the only non-deprecated use case for feeds.

Hotel Ads

  • Added support for retrieving hotel_reconciliation resources, which contain booking information to reconcile bookings from commission campaigns.
  • Removed HOTEL_ADS_COMMISSION from BudgetType.

Mutates

Planning

Reporting

  • A value for any of the following date-related segments in the WHERE clause must be the start of the field's period:

    Fields Allowed filter values
    segments.week YYYY-MM-DD where DD is the date that is Monday and YYYY and MM are valid year and month values, respectively.
    segments.month YYYY-MM-01 where YYYY and MM are valid year and month values, respectively.
    segments.quarter YYYY-01-01 or YYYY-04-01 or YYYY-07-01 or YYYY-10-01.

    Failing to set the correct values will result in a MISALIGNED_DATE_FOR_FILTER error.

  • segments.sk_ad_network_conversion_value now supports distinguishing between 0 conversion value and conversion value missing from the postback received from Apple. Note that this feature will only be available for SKAdNetwork conversions received after September 20th, 2021.

  • Published the phone_calls, phone_impressions, and phone_through_rate metric fields in the following resources:

RMF

Video

8.1.0 (2021-08-11)

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

Ads

  • Added action_items to AdGroupAd to provide you with feedback to improve your ad strength.

Bidding

  • Added support for seasonality adjustments and data exclusions, which can be applied to specific campaigns, to all campaigns that belong to specific channel types, or to specific devices:
    • Added BiddingSeasonalityAdjustment to let Smart Bidding apply conversion rate adjustments for future events such as promotions or sales.
    • Added BiddingDataExclusion to let Smart Bidding exclude data from specific dates when there are issues with an account's conversion tracking.
  • Added BiddingStrategyType.INVALID to indicate a campaign does not have a bidding strategy and cannot serve. This can occur if a campaign was previously using a manager-owned bidding strategy before being unlinked from the manager account. In this case, the campaign would transition to the INVALID bidding strategy type.

Campaigns

Change History

  • Added the following resource types to ChangeEventResourceType:
    • AD_GROUP_ASSET
    • ASSET
    • CAMPAIGN_ASSET
    • CUSTOMER_ASSET
  • Added the following new resource types to ChangeStatusResourceType:
    • AD_GROUP_ASSET
    • ASSET
    • CAMPAIGN_ASSET
    • CAMPAIGN_SHARED_SET
    • CUSTOMER_ASSET
    • SHARED_SET

Conversions

Criteria

Planning

8.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

7.0 (2021-04-28)

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

Account Management

Ads

Assets

Audiences

Batch Jobs

Bidding

Campaigns

  • Added CampaignError.PAYMENT_MODE_NOT_COMPATIBLE_WITH_VIEW_THROUGH_CONVERSION to report incompatibilities with view through conversions setup.

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

5.0.0 (2020-08-26)

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

Account Management

Ads

Audiences

Batch jobs

Bidding

Campaigns

Client libraries

  • The API is 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 full list is in the migration guide, and our code examples have been updated. The rest of the resources will change to field presence in a future release.

Constants

Conversions

Feeds

Hotel Ads

Limits

  • Added more detailed errors when a developer is exceeding either the account rate limits or the developer token rate limits. The error will include if it was the account or the developer token with details on the limit that was reached.

Planning

Recommendations

Reporting

Request Parameters

  • Set response_content_type to MUTABLE_RESOURCE as a request parameter to return all the fields mutated in a mutate request. This was added to some services including GoogleAdsService.Mutate. By default only the resource name is returned on a mutate.

Resources

Shopping

Video

4.0.0 beta (2020-07-08)

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

Account Management

  • Added ThirdPartyAppAnalyticsLinkService and AccountLinkService. This lets users create a link between a third-party app and Google Ads. A user can use these links to import data and view metrics to manage campaigns.
  • Added linked-customer-id to the request header. This header is only required for methods that update the resources of an entity when permissioned using Linked Accounts in the Google Ads UI (AccountLink resource in the Google Ads API). Set this value to the customer ID of the data provider that updates the resources of the specified customer ID. It should be set without dashes, for example 1234567890 instead of 123-456-7890. Learn more about Linked Accounts.
  • Added CreateCustomerClientResponse.invitation_link, which is a link for inviting users to access the created customer. This is accessible to allowlisted customers only, and the allowlist is currently closed.

Ads

Audiences

Batch Jobs

  • Renamed MutateJobService to BatchJobService. This service is not yet available for general use, but you can start coding against the service.

Bidding

  • Added support for Target ROAS in simulations:
  • Updated AdGroup, AgeRangeView, KeywordView, and ParentalStatusView to be selectable with BiddingStrategy.

Billing

Campaigns

Conversions

  • Added new values to ConversionActionType to include:
    • FIREBASE_ANDROID_FIRST_OPEN
    • FIREBASE_ANDROID_IN_APP_PURCHASE
    • FIREBASE_ANDROID_CUSTOM
    • FIREBASE_IOS_FIRST_OPEN
    • FIREBASE_IOS_IN_APP_PURCHASE
    • FIREBASE_IOS_CUSTOM
    • STORE_SALES
    • STORE_SALES_DIRECT_UPLOAD
    • THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN
    • THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE
    • THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM
    • THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN
    • THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE
    • THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM
  • Added CREATION_NOT_SUPPORTED to ConversionActionError.

Criteria

  • Added disapproval_reasons to AdGroupCriterion.
  • Added income_range_view to retrieve income range metrics.

Hotel Ads

Planning

Recommendations

Reporting

  • Starting in v4, segments.date, segments.week, segments.month, segments.quarter, and segments.year will function as follows:
    • These segments can be filtered in the WHERE clause without being required in the SELECT clause.
    • If any of these segments are in the SELECT clause, at least one of these segments should have a finite date range specified in the WHERE clause.

Shopping

  • Moved errors from AdGroupCriterionError to CriterionError:
    • INVALID_LISTING_GROUP_HIERARCHY
    • LISTING_GROUP_UNIT_CANNOT_HAVE_CHILDREN
    • LISTING_GROUP_SUBDIVISION_REQUIRES_OTHERS_CASE
    • LISTING_GROUP_REQUIRES_SAME_DIMENSION_TYPE_AS_SIBLINGS
    • LISTING_GROUP_ALREADY_EXISTS
    • LISTING_GROUP_DOES_NOT_EXIST
    • LISTING_GROUP_CANNOT_BE_REMOVED
    • INVALID_LISTING_GROUP_TYPE
    • LISTING_GROUP_ADD_MAY_ONLY_USE_TEMP_ID
  • Renamed the following errors inside CriterionError:
    • PRODUCT_FILTER_TOO_LONG -> LISTING_SCOPE_TOO_LONG
    • PRODUCT_SCOPE_TOO_MANY_DIMENSIONS -> LISTING_SCOPE_TOO_MANY_DIMENSIONS
    • PRODUCT_PARTITION_TOO_LONG -> LISTING_GROUP_TOO_LONG
    • PRODUCT_PARTITION_TOO_MANY_DIMENSIONS -> LISTING_GROUP_TREE_TOO_DEEP
    • INVALID_PRODUCT_DIMENSION -> INVALID_LISTING_DIMENSION
    • INVALID_PRODUCT_DIMENSION_TYPE -> INVALID_LISTING_DIMENSION_TYPE
  • Merged the following errors in CriterionError:
    • INVALID_PRODUCT_FILTER and INVALID_PRODUCT_DIMENSION -> INVALID_LISTING_DIMENSION
    • PRODUCT_SCOPE_TOO_LONG and PRODUCT_FILTER_TOO_LONG -> LISTING_SCOPE_TOO_LONG

3.1.0 beta (2020-04-29)

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

Account Management

Ads

Audiences

Billing

Conversions

Criteria

Hotel Ads

Recommendations

Reporting

Video

3.0.0 beta (2020-02-27)

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

Account Management

Ads

Billing

Campaigns

Constants

Conversions

Criteria

Feeds

Hotel Ads

Reach Forecasting

Reporting

Shopping

Video

2.2.0 beta (2019-09-25)

The functionality and changes below were added in v2.2.0.

Billing

  • Added a restricted-access InvoiceService for retrieving information about monthly invoices for a specified billing setup. This service is currently not open for sign-ups.

Reporting

2.1.0 beta (2019-08-08)

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

Account Management

  • Added time_zone, test_account, manager, descriptive_name, currency_code, and id to CustomerClient to make it easier to retrieve customers in an account hierarchy.

Ads

Audiences

Hotel Ads

Labels

Reach Forecasting

  • Introduced a restricted access ReachPlanService, which lets users accurately forecast the commercial reach of video campaigns on YouTube and Google Video Partner inventory. For more details, refer to the Reach Forecasting guide.

Reporting

Querying

2.0.0 (2019-06-26)

The functionality and changes below were added in v2.0.0. This release contains breaking changes. For breaking changes, see the migration guide.

Account Management

  • Updated CustomerService to allow users to add roles and emails on account creation. This is for allowlisted customers only and is not currently open for any new customers.

Ads

Bidding

Campaigns

Criteria

Feeds

Hotel Ads

Labels

  • Added the ability to retrieve all label resource names associated with the AdGroup resource using AdGroup.labels.

Reporting

Video

1.3.0 (2019-05-22)

The functionality and changes below were added in v1.3.0.

Bidding

  • When updating bidding strategies, you are no longer required to set required fields when updating non-required fields.

Campaign drafts and experiments

  • Added support for campaign drafts and experiments with the CampaignDraft and CampaignExperiment resources (equivalent to Campaign Drafts and Experiments in the AdWords API).

Conversions

  • Added the ability to turn on validation only for the methods UploadClickConversions, UploadCallConversions, and UploadConversionAdjustments.

Criteria

  • Added CONNECTED_TV to Device.

Feeds

  • Added campaign (targeted_campaign), ad group (targeted_ad_group), and location (targeted_geo_target_constant) targeting to ExtensionFeedItem.

Hotel Ads

  • Added the following segments:
    • segments.hotel_rate_rule_id
    • segments.hotel_rate_type

Labels

  • Added the ability to retrieve all label resource names associated with the Campaign resource using Campaign.labels.

Shopping

  • Added support for Comparison Listing Ads:
    • SHOPPING_COMPARISON_LISTING_ADS campaign advertising channel sub type
    • SHOPPING_COMPARISON_LISTING_ADS ad group type
    • SHOPPING_COMPARISON_LISTING_AD ad type
    • COMPARISON_LISTING_AD click type
  • Access is restricted to Comparison Shopping Service customers.

1.2.0 (2019-04-29)

The functionality and changes below were added in v1.2.0.

Ads

  • Added AppEngagementAdInfo for managing App Campaigns for Engagement.
  • Added DisplayUploadAdInfo for retrieving and managing ads of the following types:
    • HTML5_UPLOAD_AD
    • DYNAMIC_HTML5_EDUCATION_AD
    • DYNAMIC_HTML5_FLIGHT_AD
    • DYNAMIC_HTML5_HOTEL_RENTAL_AD
    • DYNAMIC_HTML5_JOB_AD
    • DYNAMIC_HTML5_LOCAL_AD
    • DYNAMIC_HTML5_REAL_ESTATE_AD
    • DYNAMIC_HTML5_CUSTOM_AD
    • DYNAMIC_HTML5_TRAVEL_AD
    • DYNAMIC_HTML5_HOTEL_AD
  • Added the ability to select AdParameter in GoogleAdsService.
  • Added TextAsset for retrieving text assets in ads.
  • Added FULLY_LIMITED to PolicyTopicEntryType.

Campaigns

  • Create App Campaigns for engagement by creating a Campaign and setting the advertising_channel_type to MULTI_CHANNEL and the advertising_channel_sub_type to APP_CAMPAIGN_FOR_ENGAGEMENT. This feature is currently allowlisted.

Bidding

  • Added the ability to use pay-per-conversion bidding with PaymentMode.CONVERSIONS.
  • Added simulations (equivalent to Bid Landscapes in the AdWords API) for:
    • Campaign criteria: CampaignCriterionSimulation.
    • Ad group criteria: AdGroupCriterionSimulation.
    • Ad groups: AdGroupSimulation.

Criteria

Feeds

  • Added ad_schedules and device to ExtensionFeedItem.
  • Added month_of_year, day_of_week, and cross_device_conversion segmentation to ExtensionFeedItem and FeedItem.
  • Added the ability to select AdGroupAd with FeedItem.
  • Added LocationFeedItem and AffiliateLocationFeedItem for read-only retrieval.
  • Updated PromotionFeedItem.redemption_start and PromotionFeedItem.end_time to make them selectable in a flat ExtensionFeedItem.

Hotel Ads

  • Added segment segments.hotel_user_set_dates to CampaignAudienceView and AdGroupAudienceView.
  • Added the commission bidding strategy for hotel campaigns. In order to use this bidding strategy, you will need to set up a hotel Campaign with the following fields:
    • campaign_budget being the resource name for CampaignBudget of type HOTEL_ADS_COMMISSION
    • payment_mode set to CONVERSION_VALUE
    • commission defining the commission rate

Parameters in Google Ads Query Language

  • A new component called PARAMETERS has been added to the Google Ads Query Language grammar. In this version, users can include campaign drafts when creating a query by including the parameter include_drafts. An example would be:
    • SELECT campaign.name, campaign.experiment_type, FROM campaign PARAMETERS include_drafts = true

Recommendations

  • Added new Recommendations:
    • CallExtensionRecommendation
    • CalloutExtensionRecommendation
    • SitelinkExtensionRecommendation

Reporting

  • Local Campaigns - Per store report
    • Added metrics for Local Campaigns known as the Per Store Report in the Locations tab of the UI. This report has conversion metrics for feed items; used for location and affiliate location feed items.
    • Added the following metrics for Campaign, Customer, and ExtensionFeedItem:
      • metrics.all_conversions_from_click_to_call
      • metrics.all_conversions_from_directions
      • metrics.all_conversions_from_menu
      • metrics.all_conversions_from_order
      • metrics.all_conversions_from_other_engagement
      • metrics.all_conversions_from_store_visit
      • metrics.all_conversions_from_store_website
  • Views - Feed Placeholder View
    • Added the ability to select AdGroupAd, AdGroup, and Campaign with FeedPlaceholderView.
  • Views - Geographic
    • Added the ability to select segments.geo_target_city, segments.geo_target_metro, and segments.geo_target_region with segments.date.
    • Added segments:
      • segments.geo_target_airport
      • segments.geo_target_county
      • segments.geo_target_district
      • segments.geo_target_most_specific_location
      • segments.geo_target_postal_code
      • segments.geo_target_state
  • Views - Location View
    • Added segments to LocationView:
      • segments.month_of_year
      • segments.average_cpe
      • segments.engagement_rate
      • segments.engagements
  • Views - Landing Pages
    • Added new LandingPageView and ExpandedLandingPageView resources (enhanced version of Landing Page Report in the AdWords API) along with related metrics:
      • metrics.mobile_friendly_clicks_percentage
      • metrics.speed_score
      • metrics.valid_accelerated_mobile_pages_clicks_percentage
  • View - Search Terms
    • Added a new PaidOrganicSearchTermView resource (equivalent to Paid Organic Query Report in the AdWords API), along with the following new metrics and segments intended for use with this resource:
      • Segments:
        • segments.search_engine_results_page_type
      • Metrics:
        • metrics.combined_clicks
        • metrics.combined_clicks_per_query
        • metrics.combined_queries
        • metrics.organic_clicks
        • metrics.organic_clicks_per_query
        • metrics.organic_impressions
        • metrics.organic_impressions_per_query
        • metrics.organic_queries
    • The SearchTermView resource can now be segmented by the AdGroupAd resource.
    • segments.search_term_match_type is now compatible with segments.keyword.ad_group_criterion, segments.keyword.info.match_type, and segments.keyword.info.text.

1.1.0 (2019-03-27)

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

Ads

Campaigns

  • Create App Campaigns (equivalent to UniveralAppCampaignInfo in AdWords API) by creating a Campaign and setting the advertising_channel_type to MULTI_CHANNEL and the advertising_channel_sub_type to APP_CAMPAIGN.
  • Create search dynamic ad groups by creating an ad group of type SEARCH_DYNAMIC_ADS.

Conversions

  • Adjust conversions with the new ConversionAdjustmentUploadService.
  • Upload call conversions with the UploadCallConversionsRequest in the ConversionUploadService.

Criteria

  • AdGroupCriterion now includes exempt_policy_violation_keys for exemption requests.
  • AdGroupCriterion now includes approval_status.
  • SharedCriterion, CampaignCriterion, and AdGroupCriterion now include support for mobile_application.

Hotel Ads

  • Added conversion metrics into HotelPerformanceView and HotelGroupView, including:
    • all_conversions
    • all_conversions_from_interactions_rate
    • all_conversions_from_interactions_value_per_interaction
    • all_conversions_value
    • all_conversions_value_per_cost
    • conversions
    • conversions_from_interactions_rate
    • conversions_from_interactions_value_per_interaction
    • conversions_value
    • conversions_value_per_cost
    • cost_per_all_conversions
    • cost_per_conversion
    • cross_device_conversions
    • value_per_all_conversions
    • value_per_conversion
  • Added impression share metrics into HotelPerformanceView and HotelGroupView, including:
    • search_absolute_top_impression_share
    • search_budget_lost_absolute_top_impression_share
    • search_budget_lost_impression_share
    • search_budget_lost_top_impression_share
    • search_impression_share
    • search_rank_lost_absolute_top_impression_share
    • search_rank_lost_impression_share
    • search_rank_lost_top_impression_share
    • search_top_impression_share

Recommendations

  • Added 2 Recommendation types:
    • MoveUnusedBudgetRecommendation
    • KeywordMatchTypeRecommendation

Reporting

1.0.0 (2019-02-27)

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

Terms of Service

  • The Terms and Conditions has changed. You'll need to accept the new Terms and Conditions and update your contact information in the API center. If you don't, you will get an error when trying to access v1.

    1. Sign in to the manager account where you have your developer token at ads.google.com.
    2. Click TOOLS & SETTINGS at the top of the page.
    3. Under SETUP, select API Center.
    4. Scroll down to API contact email, and update it.
    5. Scroll down to Principal place of business, accept the new conditions, and click Save.

Resource Names

  • The delimiter separating IDs in all resource names has changed from underscore _ to tilde ~. When parsing resource names, update your code to take into account the new delimiter.

Account Management

  • Added support for Labels.
    • The new LabelService lets developers add, modify, remove, and view labels.
    • Labels can be applied to and removed from resources using the AdGroupAdLabelService, AdGroupCriterionLabelService, AdGroupLabelService, CampaignLabelService, and CustomerLabelService.
  • Introduced MerchantCenterLinkService for management of links between Google Ads and Google Merchant Center.

Ads

  • Added Responsive Search Ads with ResponsiveSearchAdInfo.
  • Renamed ResponsiveDisplayAdInfo to LegacyResponsiveDisplayAdInfo. Check out the recent blog post on Display ads for more details.
  • Removed DynamicSearchAdInfo. If you are using DynamicSearchAdInfo, migrate your ads to ExpandedDynamicSearchAdInfo by March 6, 2019.
  • Added product_images and product_videos to GmailAdInfo.
  • Added ad_id_to_copy_image_from to ImageAdInfo.
  • Added ad_strength to AdGroupAd.
  • Added ad.system_managed_entity_source to AdGroupAd.

Audiences

  • Introduced the CustomInterestService.

Batch Jobs

  • Access to the batch jobs feature is currently restricted. We have released the services so you can start coding against this interface. Subscribe to the Google Ads API blog for updates when this feature will be available.
  • Added MutateJobService to support submitting and monitoring asynchronous jobs containing large numbers of operations. Operations that are supported in the new service are documented in MutateOperation.

Bidding

Billing

  • The proposal_type field in the AccountBudgetProposal resource now returns a value for resources that previously returned UNKNOWN.
  • The AccountBudgetProposalService no longer returns errors if a valid billing setup resource name is specified for operations that mutate an existing budget.

Campaigns

  • Introduced DomainCategory to retrieve categories for a website.
  • Added geo_target_type_setting to Campaign.

Change History

  • ChangeStatusService now provides support for AdGroupBidModifier, AdGroupFeed, and CampaignFeed resources.

Conversions

Criteria

  • Introduced CustomerNegativeCriterionService.
  • The AdGroupCriterion resource now has final_mobile_urls, final_url_suffix, and system_serving_status. This makes the system_serving_status available with the keyword_view.
  • Added support for mobile_device in CampaignCriterion.
  • Introduced the LanguageConstant.targetable field.
  • Introduced support for CustomIntent and CustomAffinity criteria.

Feeds

  • Introduced the CustomerExtensionSettingService, CampaignExtensionSettingService, and AdGroupExtensionSettingService to manage app, call, callout, message, price, promotion, review, sitelink, and structured snippet extensions.
  • Introduced the ExtensionFeedItemService.
  • Introduced the FeedItemTargetService.
  • Introduced support for managing matching functions using structured objects/protos instead of strings in CustomerFeed, CampaignFeed, and AdGroupFeed.
  • Campaign.dynamic_search_ad_setting.feed_ids was changed to campaign.dynamic_search_ads_setting.feeds so that feed IDs can be replaced by feed resources.
  • FeedItemValidationError.extra_information was renamed to FeedItemValidationError.extra_info.
  • In FeedItem, the type of the price_value field was changed from Price to Money.

Hotel Ads

  • Added Hotel Ads click types to segments.click_type: HOTEL_PRICE, HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION.

Reporting

  • Query Grammar
    • Changed the meaning of metrics and segments in GoogleAdsFieldService. These are now only returned for artifacts of category RESOURCE and they only contain the metrics and segments that are selectable when the given resource is in the FROM clause.
  • Segments

  • Views - Ads

    • A new ClickView resource has been added. This is the equivalent of the Click Performance Report in the AdWords API. Consistent with the Click Performance Report, requests including the ClickView resource must specify a filter on a single day in the past 90 days.
    • Introduced the DynamicSearchAdsSearchTermView resource (equivalent to Keywordless Query Report in the AdWords API).
  • Views - Bidding

  • Views - Feeds

    • Introduced the FeedPlaceholderView (equivalent of the Placeholder Report in the AdWords API).
    • Added more metrics and segments in FeedItem.
    • Added metrics for ExtensionFeedItem.
  • Views - Geographic

    • Introduced the GeographicView resource (equivalent to the Geo Performance Report where isTargetingLocation is true OR there is no predicate on isTargetingLocation in the AdWords API).
    • Introduced the LocationView resource (equivalent to Campaign Location Target Report in the AdWords API).
  • Zero Rows

    • Search queries that include at least one segment will no longer return rows where all selected metrics equal zero. Queries that don't include any segments are unchanged and will continue to return rows where all metrics equal zero. Unlike the existing AdWords API, there is no way to disable this behavior.

Shopping

  • Added ProductBiddingCategoryConstantService (equivalent to Shopping Performance Report in the AdWords API).
  • Bidding Categories are now supported in ListingDimensionInfo as a part of ListingGroups and ListingScopes.
  • Added the ShoppingPerformanceView resource (equivalent to Shopping Performance Report in the AdWords API) which includes the following metrics and segments:
    • Metrics:
      • all_conversions
      • all_conversions_from_interactions_rate
      • all_conversions_value
      • average_cpc
      • clicks
      • conversions
      • conversions_from_interactions_rate
      • conversions_value
      • cost_micros
      • cost_per_all_conversions
      • cost_per_conversion
      • cross_device_conversions
      • ctr
      • impressions
      • search_absolute_top_impression_share
      • search_click_share
      • search_impression_share
      • value_per_all_conversions
      • value_per_conversion
    • Segments:
      • ad_group (resource)
      • ad_network_type
      • campaign (resource)
      • click_type
      • conversion_action
      • conversion_action_category
      • conversion_action_name
      • date
      • day_of_week
      • device
      • external_conversion_source
      • month
      • product_aggregator_id
      • product_bidding_category_level1
      • product_bidding_category_level2
      • product_bidding_category_level3
      • product_bidding_category_level4
      • product_bidding_category_level5
      • product_brand
      • product_channel
      • product_channel_exclusivity
      • product_condition
      • product_country
      • product_custom_attribute0
      • product_custom_attribute1
      • product_custom_attribute2
      • product_custom_attribute3
      • product_custom_attribute4
      • product_item_id
      • product_language
      • product_merchant_id
      • product_store_id
      • product_title
      • product_type_l1
      • product_type_l2
      • product_type_l3
      • product_type_l4
      • product_type_l5
      • quarter
      • week
      • year

Video

  • Updated MediaVideo.ad_duration_millis to have millisecond precision as the precision used to only be out to the second while ending in 000.
  • Added more metrics and segments compatible with Video (equivalent to Video Performance Report in the AdWords API).
  • For reporting, added video types for Ad and MediaVideo.
  • Added the ability to report on target CPM bidding strategies.

0.7.0 (2019-01-30)

The functionality and changes below were added in v0.7.0.

Ads
Audiences
  • Added support for the targeting setting in campaigns and ad groups.
  • Added support for rule based, logical, and basic user lists.
  • Added support for managing remarketing actions for a basic user list.
Billing
  • Support for retrieving account-level budget proposals that were previously cancelled or rejected.
Campaigns
  • CampaignGroups has been removed.
Change History
Client Accounts
  • Introduced signal to identify if a customer is a test account.
  • Introduced signal to identify if a customer is a manager account.
  • Exposed conversion tracking settings of a customer.
Conversions
Criteria and Location
  • Added ability to create criterion with CriterionType MOBILE_APP_CATEGORY, WEBPAGE, OPERATING_SYSTEM_VERSION, and APP_PAYMENT_MODEL to identify when and where to show ads.
  • Added ability to retrieve the canonical_name from the GeoTargetConstant.
Feeds
  • Ad customizer stats are now returned with FeedItem stats.
Manager Accounts
Request Parameters
  • Set validate_only to true as a request parameter to only validate the request, but not perform it. This was added to all services including GoogleAdsService.Mutate.
  • Set partial_failure to true as a mutate parameter to continue on failure and commit valid operations even if other operations in the same request failed.
Reporting
  • All segment fields are now in a segments, which means all queries must be updated to include segments. before the segment field name.
  • Additional metrics were added for ad groups, campaigns, budgets, campaign negative keywords, keywords, shared set criteria, campaign ad schedule targets, and bid goals including: absolute_top_impression_percentage, active_view_cpm, active_view_ctr, active_view_impressions, active_view_measurability, active_view_measurable_cost_micros, active_view_measurable_impressions, active_view_viewability, average_frequency, average_page_views, average_time_on_site, benchmark_average_max_cpc, cost_per_current_model_attributed_conversion, current_model_attributed_conversions, current_model_attributed_conversions_from_interactions_rate, current_model_attributed_conversions_from_interactions_value_per_interaction, current_model_attributed_conversions_value, current_model_attributed_conversions_value_per_cost, gmail_forwards, gmail_saves, gmail_secondary_clicks, historical_creative_quality_score, historical_landing_page_quality_score, historical_quality_score, historical_search_predicted_ctr, impression_reach, interaction_types, search_budget_lost_absolute_top_impression_share, search_click_share, search_rank_lost_absolute_top_impression_share, search_rank_lost_top_impression_share, search_top_impression_share, top_impression_percentage, and value_per_current_model_attributed_conversion.
Shopping
Video

0.6.0 (2018-11-29)

The functionality and changes below were added in v0.6.0.

Account Management
  • CustomerClient resource
    • Returns the list of clients managed by the selected customer.
  • CustomerService
  • CustomerService now supports mutates.
  • New fields available in the [Customer](/google-ads/api/reference/rpc/v18/Customer) arefinal_url_suffixandtracking_url_template`.
  • Descriptive name, currency, time_zone, final_url_suffix, tracking_url_template, auto_tagging_enabled, call_reporting_setting are now mutable.
Ads
Audiences
Billing
Conversions
  • Conversion actions return AMP tag snippets.
Criteria
  • You can now create criteria with CriterionType LANGUAGE, CARRIER, USER_LIST, USER_INTEREST, and IP_BLOCK.
Feeds
Hotel Ads
  • Made following derived metrics compatible with the existing HotelGroupView resource:
    • average_cpc
    • average_cpm
    • ctr
  • Added the HotelPerformanceViewService.
  • Added the HotelPerformanceView resource
    • Note that the resource name for HotelPerformanceView is customers/<customer_id>/hotelPerformanceView
  • Made HotelPerformanceView compatible with following metrics:

    • average_cpc
    • average_cpm
    • average_position
    • clicks
    • cost_micros
    • ctr
    • impressions
    • hotel_average_lead_value_micros

    These metrics can be segmented by

    • ad_network_type
    • date
    • day_of_week
    • device
    • hotel_booking_window_days
    • hotel_center_id
    • hotel_check_in_date
    • hotel_check_in_day_of_week
    • hotel_city
    • hotel_class
    • hotel_country
    • hotel_date_selection_type
    • hotel_length_of_stay
    • hotel_state
    • hour
    • month
    • partner_hotel_id
    • quarter
    • week
    • year

    The above metrics can also be segmented by the campaign and ad group resources. For example:

    select campaign.id, metrics.clicks from hotel_performance_view
    select ad_group.id, metrics.impressions from hotel_performance_view
    
Keyword Planning
  • Published improved and extended version of Keyword Planning services keeping parity with Keyword Planner.

    • In order to accomplish this, we have introduced the Keyword Plan as a key concept. As with Keyword Planner, API users will be able to create Keyword Plans that can be accessed and modified at a later time. A Keyword Plan is much like any other Google Ads entity. As such, it is structured similarly to a standard serving campaign (KeywordPlan > KeywordPlanCampaign > KeywordPlanAdGroup > KeywordPlanKeyword).

      Much like campaigns, the full set of Keyword Plan entities need to be created in order to get Forecasted Metrics or Historical Metrics (Search Volume Data).

  • KeywordPlanService.GenerateForecastMetrics

    • This service replaces the AdWords API's TrafficEstimatorService.get. It returns forecast metrics for all the keywords present in your KeywordPlan. It returns consistent forecast data with Keyword Planner offering forecast metrics at the keyword, ad group or campaign level.
  • KeywordPlanService.GenerateHistoricalMetrics

    • This service replaces the AdWords API's TargetingIdeaService.get with RequestType=STATS; it returns historical metrics for all the canonicalized keywords present in your Keyword Plan. This means that if multiple KeywordPlanKeyword items are close variants of the same canonical keyword, a single version of the KeywordPlanKeyword will be returned along with historical metrics. This is consistent with Keyword Planner.
  • [KeywordPlanIdeaService.GenerateKeywordIdeas](/google-ads/api/reference/rpc/v18/KeywordPlanService#generatekeywordideas`

    • This service replaces TargetingIdeaService.get with RequestType=IDEAS; it returns canonicalized keyword suggestions along with historical metrics. These keywords can be added to your Keyword Plans for forecasting or obtaining overall historical metrics for your plan. This is the only service which does not require a Keyword Plan to be created because it provides keyword suggestions to assist with plan creation.
Mutates
Recommendations
Reports
Shopping
Video
  • The average_cpv metric is now available for tracking video stats.

0.5.0 (2018-10-31)

The functionality and changes below were added in v0.5.0.

Account Management
Billing
  • BillingSetupService
    • Create a new billing setup.
    • Cancel an approved billing setup that is scheduled to start in the future.
    • Cancel a pending billing setup that is not yet approved.
  • AccountBudgetService
    • View all approved account-level budgets, including budget adjustments.
    • View currently pending account-level budget proposals (if any).
  • AccountBudgetProposalService
    • Create account-level budget proposal to update a budget or create a new budget.
    • View all account-level budget proposals. All approved values and proposed budget values are visible. Approved values are prefixed with approved_.
Campaigns
  • Create campaigns with AdvertisingChannelSubType DISPLAY_GMAIL_AD for Gmail Ad campaigns and DISPLAY_SMART_CAMPAIGN for Smart Display campaigns.
  • Query more Metrics for accounts, campaigns, ad groups, keywords, and bidding strategies.
Change history
Creatives
  • MediaFileService
    • A service to upload media to be used in ads.
  • Create call-only ads with CallOnlyAdInfo.
  • Set and create the ad rotation mode on an ad group.
  • Query Metrics such as impressions, clicks, cost, conversions, and average position for ads.
Conversion tracking
  • Lets you measure the performance of your advertising against your business goals.
  • Conversion actions
    • Set up and edit the settings associated with your conversion actions, including website tracking and call conversion tracking.
Hotel Ads
  • Use Google Ads Query Language to query hotel group stats. For each hotel group:
    • Read the corresponding listing group case value.
    • Read direct child listing groups' types.
    • Read the parent listing group ID.
    • Read the listing group path, which contains the case value from the root node of the hotel group tree to the current hotel group.
Location, Demographics, and Criteria
  • `GeoTargetConstantService
    • A service for retrieving geo constants and suggesting geo constants based on input.
  • Create criterion with CriterionType AGE_RANGE, GENDER, INCOME_RANGE, PARENTAL_STATUS, PLACEMENT, PROXIMITY, TOPIC, YOUTUBE_CHANNEL, and YOUTUBE_VIDEO to identify when and where to show ads.
  • Define placement in SharedCriterion.
  • Retrieve Metrics for audiences, age ranges, display keywords, gender, parental status, and display topics.
Shopping
  • `ProductGroupView resource
    • Supported metrics
      • all_conversions_from_interactions_rate
      • all_conversions
      • all_conversions_value
      • average_cpc
      • average_cpm
      • benchmark_average_max_cpc
      • clicks
      • conversions_from_interactions_rate
      • conversions
      • conversions_value
      • cost_micros
      • cost_per_all_conversions
      • cost_per_conversion
      • cross_device_conversions
      • ctr
      • impressions
      • search_click_share
      • search_impression_share
      • value_per_all_conversions
      • value_per_conversion
      • view_through_conversions
    • Supported segments
      • ad_network_type
      • date
      • day_of_week
      • device
      • month
      • month_of_year
      • quarter
      • week
      • Year

0.4.0 (2018-09-21)

The functionality and changes below were added in v0.4.0.

Allowlist removed

The allowlist for API access has been removed. All API users who have an existing developer token in the AdWords API can use that developer token for the Google Ads API.

Billing
  • BillingSetupService

    • Designate the business entity responsible for an account's accrued costs.
    • Each billing setup is associated with a Payments account. All billing setups pointing to the same Payments account will appear on a single monthly invoice.
    • You can cancel a pending or future approved billing setup. Note that not all settable fields are exposed yet, including the billing setup's start and end times.
    • Note that creating or changing billing setups is not supported yet.
  • AccountBudgetProposalService

    • Create new budgets and make changes to existing budgets, including:
      • edit existing budgets
      • end a currently running budget
      • remove a budget (approved to start in the future)
    • Cancel proposals that are still pending.
    • There are some fields that are currently settable, but are not yet selectable.
    • Approved values (where there is a discrepancy between the proposed budget value and the approved value) will be exposed as fields prefixed with approved_ in a future version.
    • Reads for account-level budgets managed by these proposals will be supported in a future version. Use BudgetOrderService until then.
Campaigns
Change history
  • ChangeStatus in GoogleAdService.Search
    • Retrieves the current status of resources that have changed since a requested time.
    • Supported resources are:
      • AD_GROUP
      • AD_GROUP_AD
      • AD_GROUP_CRITERION
      • CAMPAIGN
      • CAMPAIGN_CRITERION
Creatives
  • The field policy_validation_parameter has been added to the AdGroupAdOperation. It enables setting policy topics that should be ignored so the ad can be saved despite having policy validations.
  • The field policy_summary has been added to AdGroupAd to display the current approval status of an ad (including any policy violations ignored).
  • The fields ad.added_by_google_ads and ad.device_preference were added in AdGroupAd.
Conversion tracking

Conversion tracking lets you measure the performance of your advertising against your business goals. The API will allow you to set up and edit your conversion tracking setup.

  • With ConversionAction, you can set up and edit the settings associated with your conversion actions including website tracking and call conversion tracking.
Shopping
  • Standard Shopping Campaigns
    • CampaignService
      • Create standard Shopping campaigns with SHOPPING.advertising_channel_type.
      • Supported bidding strategy types: MANUAL_CPC, TARGET_SPEND, TARGET_ROAS.
    • BiddingStrategyService
      • Create portfolio bidding strategy of types ENHANCED_CPC, TARGET_SPEND, TARGET_ROAS.
    • AdGroupService
      • Create ad groups of type SHOPPING_PRODUCT_ADS.
    • AdGroupAdService
      • Create ads of type SHOPPING_PRODUCT_AD.
    • AdGroupCriterionService
      • Subdivide product offers through listing groups, which represent product groups.
      • Supported listing dimension types:
        • Product Condition
        • Product Type
        • Listing Brand
        • Custom Attribute (L0-4)
        • Product Channel
        • Product Channel Exclusivity
        • Product Offer Id
Video
  • GoogleAdsService
  • Video Ads
    • Video specific metrics
      • Video views, video view rate
      • Video quartiles
      • View-through conversions
  • Video creatives
  • ManualCPV bidding strategy

0.3.0 (2018-08-29)

Campaigns

The following were added or changed.

Creatives
  • For ad disapproval error handling, PolicyFindingDetails replaces PolicyViolationDetails for expanded text ads.
Hotel Ads
  • The parent_criterion_id (int64) in ListingGroupInfo has been replaced with parent_criterion. The new field is a string that contains the resource name of the parent criterion.
Queries
Recommendations
  • Recommendations added:
  • MaximizeConversionsOptInRecommendation
  • EnhancedCpcOptInRecommendation
  • MaximizeClicksOptInRecommendation
  • SearchPartnersOptInRecommendation
  • OptimizeAdRotationRecommendation
  • The dismissed field was added to Recommendation resource to allow you to search, get, and apply dismissed recommendations.
Shopping
  • Smart Shopping Campaigns
    • CampaignService
      • Create campaigns with advertising_channel_sub_type SHOPPING_SMART_ADS.
      • Supported bidding strategy type: MAXIMIZE_CONVERSION_VALUE.
    • AdGroupService
      • Create ad groups of type SHOPPING_SMART_ADS.
    • AdGroupAdService
      • Create ads of type SHOPPING_SMART_AD.
    • AdGroupCriterionService
      • Subdivide product offers through listing groups, which represent product groups.
        • Supported listing dimension types:
          • Product Condition
          • Product Type
          • Listing Brand
          • Custom Attribute (L0-4)

0.2.0 (2018-06-14)

Hotel Ads

0.1.0 (2018-06-05)

Campaigns
Search Campaigns
Hotel Ads
Recommendations
  • Recommendations include:
    • Keyword
    • CampaignBudget
    • TextAd (expanded text ads)
    • TargetCpaOptIn
  • GoogleAdsService.Search
    • Search for Recommendations supports filtering and selecting with ad group, campaign, or campaign budget (depending on the Recommendation).
  • RecommendationService
    • Apply Recommendations applies the recommendation as-is or overrides and applies the recommendation.
    • GetRecommendation retrieves one recommendation at a time and is meant for exploratory use rather than the retrieval of multiple recommendations. To retrieve multiple campaigns in one call, use GoogleAdsService.
Customer

0.0.0 (2018-04-23)

GoogleAdsFieldService
  • GoogleAdsFieldService provides a catalog of all queryable fields. The metadata on these fields includes descriptions, types, and compatibility with other fields. Learn more.
GoogleAdsService
  • GoogleAdsService is meant for retrieving multiple resources in a single query. Queryable resources include:

    • Customer
    • Campaign
    • AdGroup
    • AdGroupAd
    • CampaignBudget
    • BiddingStrategy
  • Metrics such as impressions and clicks can also be retrieved using GoogleAdsService for these resources:

    • Customer
    • Campaign
    • AdGroup
    • AdGroupAd
    • CampaignBudget
    • BiddingStrategy
    • KeywordView (Keyword)
  • GoogleAdsService segments by fields, such as date fields. Learn more.

Services for resources
CampaignService
  • MutateCampaigns creates, updates, or removes search campaigns. It can also configure network settings and bidding strategies.

  • GetCampaign retrieves one campaign at a time. It is meant for exploratory use rather than for retrieval of multiple campaigns. To retrieve multiple campaigns in a single call, use GoogleAdsService. Learn more.

CampaignBudgetService
  • MutateCampaignBudgets creates, updates, or removes campaign budgets.

  • GetCampaignBudget is meant for exploratory use rather than for retrieval of multiple campaign budgets. To retrieve multiple campaign budgets, use GoogleAdsService. Learn more.

AdGroupService
  • MutateAdGroups creates, updates, or removes ad groups under search campaigns. It can also set bids on ad groups.

  • GetAdGroup retrieves one ad group at a time. It is meant for exploratory use rather than for retrieval of multiple ad groups. To retrieve multiple ad groups, use GoogleAdsService. Learn more.

AdGroupAdService
  • MutateAdGroupAds creates, updates, or removes ads in search campaigns. Supported ads are listed in AdType and include:

    • TEXT_AD
    • EXPANDED_TEXT_AD
    • DYNAMIC_SEARCH_AD
    • CALL_ONLY_AD
    • EXPANDED_DYNAMIC_SEARCH_AD
  • GetAdGroupAd retrieves one ad at a time. It is meant for exploratory use rather than for retrieval of multiple ads. To retrieve multiple ads, use GoogleAdsService. Learn more.

BiddingStrategyService
  • MutateBiddingStrategies creates, updates, or removes search campaign bidding strategies. Both standard and portfolio bidding strategies are supported.

  • GetBiddingStrategy retrieves one bidding strategy at a time. It is meant for exploratory use rather than for retrieval of multiple bidding strategies. To retrieve multiple bidding strategies, use GoogleAdsService. Learn more.

CampaignCriterionService and AdGroupCriterionService
  • MutateCampaignCriteria and MutateAdGroupCriteria create, update, or remove keyword criteria in search campaigns.

  • GetCampaignCriterion and GetAdGroupCriterion retrieve one criterion at a time. They are meant for exploratory use rather than for retrieval of multiple criteria. To retrieve multiple criteria, use GoogleAdsService. Learn more.

CustomerService
  • GetCustomer retrieves specific details about an account.