AdWords API

Release Notes

v201402

What's New

ClientLogin is no longer supported

Use OAuth2 instead.

Shopping campaigns

Shopping campaign management is now available in the API.

Review, Application and Location extensions

Feed services have been extended to include new types of feeds. Now you can create Review Extensions to include user feedback in your ads. We've also added an option to create Location Extensions and App Extensions via Feeds.

Search Network and Display Select

New fields have been added to create, get, or modify this new type of campaign. We've also added a new Channel type field to simplify networks targeting. Fields for these new features are available in reports.

New reports
New report types introduced in this release:
  • Bid Goal Performance Report
  • Paid and Organic Query Report
  • Shopping Performance Report
  • Product Partition Report
New report fields
Several new report fields were introduced including:
  • Search funnels fields
  • Google Analytics fields
  • Call metric fields
New bidding strategy

Target ROAS (Return on Ad Spend)

New template ad

The App Promotion Image Ad template is available for mobile app developers who want to run image ads promoting mobile and tablet apps. This ad format makes it easier for people to download your mobile app from Google Play or iTunes.

ReturnMoneyMicros defaults to true

Money fields will be returned in micros by default. You can enable the old behavior by sending the ReturnMoneyMicros header with the value of false. Note: This field will be removed in the future.

New targeting options

The API now allows you to target by Places of Interest, Demographic Locations and Similar Audiences.

Network targets

You can now specify IP addresses and networks to exclude from serving ads.

AWQL across all services

The AdWords Query Language is now supported by all API services.

Auto-tagging

You can set auto-tagging with the autoTaggingEnabled field.

GclId field length

Starting March 31st 2014, the value of GclId can be up to 100 characters long. As a result of this change, the Click Performance report will only be available for dates up to 90 days before the time of a request.

Affinity Interest IDs

Affinity Interest IDs are now available via ConstantDataService.

Flexible conversion tracking

You can now programmatically change your conversion type between one-per-click and many-per-click. We've updated reports to accommodate this; as a result, many conversion column names have changed.

Conversion Tracker service

You can now set a default conversion value in your conversion tracker just like in the AdWords UI. The default conversion value is 1 unless otherwise specified. You can also designate whether the default conversion value should always be used.

AdGroupCreativeId replaced with CreativeId

If you've been requesting or storing AdGroupCreativeId locally, make sure to replace it with the new, correct value.

Out of Beta
These formerly Beta features are now generally available:
Deprecated
  • DomainInfoExtension is no longer supported; set domain info for DSA via DynamicSearchAdsSetting instead
  • ClickId has been removed from Click Performance Report; use GclId instead
  • EnhancedCpc setting can no longer be enabled for Manual CPC bidding strategy
  • Call Conversion Duration Threshold placeholder field
  • BudgetOptimizer bidding strategy
  • CampaignSharedSetService, SharedCriterionService, and SharedSetService
Migration guide

Breaking changes introduced in this version are summarized in the v201402 migration guide.

API Changes

  1. - CampaignSharedSetService
  2. - SharedCriterionService
  3. - SharedSetService
  4. + CustomerFeedService
  5. AdGroupAdService (4 new, 9 changed, 3 removed)
    1. + type ExperimentError
    2. + enum ExperimentError.Reason
    3. + type RejectedError
    4. + enum RejectedError.Reason
    5. enum AdError.Reason
      1. value UNSUPPORTED_PARENT_CAMPAIGN_FOR_DEVICE_PREFERENCE
    6. enum EntityCountLimitExceeded.Reason
      1. + value SHARED_SET_LIMIT
    7. type ExperimentError
      1. + field reason
    8. enum FunctionError.Reason
      1. + value INVALID_FUNCTION_FORMAT
      2. + value INVALID_FUNCTION_FOR_PLACEHOLDER
    9. enum ImageError.Reason
      1. + value FLASH_ERROR_AFTER_FIXING_CLICK_TAG
    10. type NotWhitelistedError
      1. field reason
    11. type RejectedError
      1. + field reason
    12. enum SelectorError.Reason
      1. + value TOO_MANY_PREDICATE_VALUES
    13. type TemplateAd
      1. + field adAsImage
    14. type BetaError
    15. type NotWhitelistedError
    16. enum NotWhitelistedError.Reason
  6. AdGroupBidModifierService (5 new, 7 changed, 2 removed)
    1. + type QueryError
    2. + enum QueryError.Reason
    3. + type RejectedError
    4. + enum RejectedError.Reason
    5. + operation query
    6. enum Criterion.Type
      1. + value PRODUCT_PARTITION
      2. + value IP_BLOCK
      3. + value LOCATION_GROUPS
      4. + value PRODUCT_SCOPE
      5. + value PRODUCT_SALES_CHANNEL
    7. enum CriterionError.Reason
      1. + value BID_MODIFIER_ALREADY_EXISTS
      2. + value PRODUCT_SCOPE_TOO_LONG
      3. + value PRODUCT_SCOPE_TOO_MANY_DIMENSIONS
      4. + value PRODUCT_PARTITION_TOO_LONG
      5. + value PRODUCT_PARTITION_TOO_MANY_DIMENSIONS
      6. + value INVALID_PRODUCT_DIMENSION
      7. + value INVALID_PRODUCT_DIMENSION_TYPE
      8. + value INVALID_PRODUCT_BIDDING_CATEGORY
      9. + value MISSING_SHOPPING_SETTING
      10. + value INVALID_MATCHING_FUNCTION
      11. value CANNOT_ADD_BID_MODIFIER_FOR_BIDDING_STRATEGY
      12. value CANNOT_BID_MODIFY_DESKTOP
    8. type NotWhitelistedError
      1. field reason
    9. type QueryError
      1. + field reason
    10. type RejectedError
      1. + field reason
    11. enum SelectorError.Reason
      1. + value TOO_MANY_PREDICATE_VALUES
    12. operation query
      1. + parameter query
      2. + response rval
    13. type NotWhitelistedError
    14. enum NotWhitelistedError.Reason
  7. AdGroupCriterionService (18 new, 15 changed, 3 removed)
    1. + type ExperimentError
    2. + enum ExperimentError.Reason
    3. + type ProductAdwordsGrouping
    4. + type ProductAdwordsLabels
    5. + type ProductBiddingCategory
    6. + type ProductBrand
    7. + type ProductCanonicalCondition
    8. + enum ProductCanonicalCondition.Condition
    9. + type ProductCustomAttribute
    10. + type ProductDimension
    11. + enum ProductDimensionType
    12. + type ProductLegacyCondition
    13. + type ProductOfferId
    14. + type ProductPartition
    15. + enum ProductPartitionType
    16. + type ProductType
    17. + type ProductTypeFull
    18. + type TargetRoasBiddingScheme
    19. enum AdGroupCriterionError.Reason
      1. + value INVALID_PRODUCT_PARTITION_HIERARCHY
      2. + value PRODUCT_PARTITION_UNIT_CANNOT_HAVE_CHILDREN
      3. + value PRODUCT_PARTITION_SUBDIVISION_REQUIRES_OTHERS_CASE
      4. + value PRODUCT_PARTITION_REQUIRES_SAME_DIMENSION_TYPE_AS_SIBLINGS
      5. + value PRODUCT_PARTITION_ALREADY_EXISTS
      6. + value PRODUCT_PARTITION_DOES_NOT_EXIST
      7. + value PRODUCT_PARTITION_CANNOT_BE_REMOVED
      8. + value INVALID_PRODUCT_PARTITION_TYPE
      9. + value PRODUCT_PARTITION_ADD_MAY_ONLY_USE_TEMP_ID
      10. + value OPERATIONS_FOR_TOO_MANY_SHOPPING_ADGROUPS