Release Notes

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