AdWords API
Feedback on this document

Release Notes

v201306

What's New

MutateJobService

MutateJobService now supports AdGroupBidModifiers and Feeds.

Replacement

UserListService is now AdwordsUserListService.

New location types for TargetingIdeaService

You can now use any location type, except for Airport and Postal Code, for LocationSearchParameter when requesting stats in TargetingIdeaService.

FeedService

Feeds can now be targeted to Mobile or Desktop.

Display Keyword Performance report

The Display Keyword Performance report is no longer Beta and is available to all users.

New reports

The following are new report types introduced in v201306:

  • CAMPAIGN_AD_SCHEDULE_TARGET_REPORT
  • CAMPAIGN_PLATFORM_TARGET_REPORT
  • CAMPAIGN_LOCATION_TARGET_REPORT Beta
Deprecated

The PreferredPosition and BottomPosition columns have been removed from reports.

Flexible Bid Strategies Beta

Shared Bid strategies are now available as a Beta feature. A new BiddingStrategyService was added to manage and configure strategies.

Geo Bid Adjustment Beta

Geo bid adjustment is now available at the campaign level.

Scheduling of feedsBeta

Feeds can now be targeted to particular days and times.

Bid multipler on ad group level criteriaBeta

BidMultiplier is now available for all ad group level criteria relevant to Display campaigns.

Migration Guide

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

API Changes

  1. - UserListService
  2. + AdwordsUserListService
  3. + BiddingStrategyService
  4. AdExtensionOverrideService (0 new, 0 changed, 1 removed)
    1. type ProductExtension
  5. AdGroupAdService (0 new, 4 changed, 0 removed)
    1. enum AdError.Reason
      1. + value CUSTOMER_NOT_ELIGIBLE
    2. enum FunctionError.Reason
      1. + value INVALID_CONJUNCTION_OPERANDS
      2. + value INVALID_OPERAND
      3. + value MISSING_CONSTANT_OPERAND_VALUE
    3. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
    4. type RichMediaAd
      1. + field adAttributes
  6. AdGroupBidModifierService (0 new, 2 changed, 0 removed)
    1. enum Criterion.Type
      1. value POLYGON
    2. enum CriterionError.Reason
      1. + value CANNOT_ADD_DISPLAY_ONLY_LISTS_TO_SEARCH_ONLY_CAMPAIGNS
  7. AdGroupCriterionService (4 new, 7 changed, 0 removed)
    1. + type EnhancedCpcBiddingScheme
    2. + type PageOnePromotedBiddingScheme
    3. + type TargetCpaBiddingScheme
    4. + type TargetSpendBiddingScheme
    5. type BiddableAdGroupCriterion
      1. + field bidModifier
    6. enum BiddingErrors.Reason
      1. + value BIDDING_STRATEGY_AVAILABLE_FOR_ENHANCED_CAMPAIGN_ONLY
      2. + value BIDDING_STRATEGY_NOT_COMPATIBLE_WITH_ADGROUP_OVERRIDES
      3. + value BIDDING_STRATEGY_NOT_COMPATIBLE_WITH_ADGROUP_CRITERIA_OVERRIDES
      4. + value CAMPAIGN_BIDDING_STRATEGY_CANNOT_BE_OVERRIDDEN
      5. + value ADGROUP_BIDDING_STRATEGY_CANNOT_BE_OVERRIDDEN
      6. + value CANNOT_ATTACH_BIDDING_STRATEGY_TO_ADGROUP
      7. + value CANNOT_ATTACH_BIDDING_STRATEGY_TO_ADGROUP_CRITERIA
      8. + value INVALID_ANONYMOUS_BIDDING_STRATEGY_TYPE
      9. + value INVALID_BIDDING_STRATEGY_TYPE
      10. + value MISSING_BIDDING_STRATEGY_TYPE
      11. + value CANNOT_ATTACH_POP_BIDDING_STRATEGY_FOR_CONTENT_NETWORK_ONLY_CAMPAIGN
      12. + value CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_AD_GROUP_LEVEL_POP_BIDDING_STRATEGY
      13. + value CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_CAMPAIGN_LEVEL_POP_BIDDING_STRATEGY
      14. + value BIDDING_STRATEGY_NOT_SUPPORTED_WITH_AD_SCHEDULE
      15. + value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
    7. type BiddingStrategyConfiguration
      1. + field biddingStrategyId
      2. + field biddingStrategyName
      3. + field biddingStrategySource
    8. enum BiddingStrategyType
      1. + value PAGE_ONE_PROMOTED
      2. + value TARGET_SPEND
      3. + value ENHANCED_CPC
      4. + value TARGET_CPA
      5. + value NONE
    9. enum Criterion.Type
      1. value POLYGON
    10. enum CriterionError.Reason
      1. + value CANNOT_ADD_DISPLAY_ONLY_LISTS_TO_SEARCH_ONLY_CAMPAIGNS
    11. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
  8. AdGroupFeedService (1 new, 4 changed, 0 removed)
    1. + type FunctionOperand
    2. enum Function.Operator
      1. + value AND
    3. enum FunctionError.Reason
      1. + value INVALID_CONJUNCTION_OPERANDS
      2. + value INVALID_OPERAND
      3. + value MISSING_CONSTANT_OPERAND_VALUE
    4. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
    5. enum RequestContextOperand.ContextType
      1. + value DEVICE_PLATFORM
  9. AdGroupService (4 new, 4 changed, 0 removed)
    1. + type EnhancedCpcBiddingScheme
    2. + type PageOnePromotedBiddingScheme
    3. + type TargetCpaBiddingScheme
    4. + type TargetSpendBiddingScheme
    5. enum BiddingErrors.Reason
      1. + value BIDDING_STRATEGY_AVAILABLE_FOR_ENHANCED_CAMPAIGN_ONLY
      2. + value BIDDING_STRATEGY_NOT_COMPATIBLE_WITH_ADGROUP_OVERRIDES
      3. + value BIDDING_STRATEGY_NOT_COMPATIBLE_WITH_ADGROUP_CRITERIA_OVERRIDES
      4. + value CAMPAIGN_BIDDING_STRATEGY_CANNOT_BE_OVERRIDDEN
      5. + value ADGROUP_BIDDING_STRATEGY_CANNOT_BE_OVERRIDDEN
      6. + value CANNOT_ATTACH_BIDDING_STRATEGY_TO_ADGROUP
      7. + value CANNOT_ATTACH_BIDDING_STRATEGY_TO_ADGROUP_CRITERIA
      8. + value INVALID_ANONYMOUS_BIDDING_STRATEGY_TYPE
      9. + value INVALID_BIDDING_STRATEGY_TYPE
      10. + value MISSING_BIDDING_STRATEGY_TYPE
      11. + value CANNOT_ATTACH_POP_BIDDING_STRATEGY_FOR_CONTENT_NETWORK_ONLY_CAMPAIGN
      12. + value CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_AD_GROUP_LEVEL_POP_BIDDING_STRATEGY
      13. + value CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_CAMPAIGN_LEVEL_POP_BIDDING_STRATEGY
      14. + value BIDDING_STRATEGY_NOT_SUPPORTED_WITH_AD_SCHEDULE
      15. + value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
    6. type BiddingStrategyConfiguration
      1. + field biddingStrategyId
      2. + field biddingStrategyName
      3. + field biddingStrategySource
    7. enum BiddingStrategyType
      1. + value PAGE_ONE_PROMOTED
      2. + value TARGET_SPEND
      3. + value ENHANCED_CPC
      4. + value TARGET_CPA
      5. + value NONE
    8. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
  10. AdParamService (0 new, 1 changed, 0 removed)
    1. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
  11. = AlertService (no changes)
  12. BudgetOrderService (0 new, 1 changed, 0 removed)
    1. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
  13. BudgetService (0 new, 3 changed, 0 removed)
    1. type Budget
      1. field associatedCampaigns
    2. enum BudgetError.Reason
      1. value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_SHARED_BY_BUDGET_OPTIMIZER_CAMPAIGN
    3. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
  14. CampaignAdExtensionService (0 new, 2 changed, 1 removed)
    1. enum AdExtensionError.Reason
      1. + value INVALID_ADEXTENSION_TYPE
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
    3. type ProductExtension
  15. CampaignCriterionService (0 new, 3 changed, 1 removed)
    1. enum Criterion.Type
      1. value POLYGON
    2. enum CriterionError.Reason
      1. + value CANNOT_ADD_DISPLAY_ONLY_LISTS_TO_SEARCH_ONLY_CAMPAIGNS
    3. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
    4. type Polygon
  16. CampaignFeedService (1 new, 4 changed, 0 removed)
    1. + type FunctionOperand
    2. enum Function.Operator
      1. + value AND
    3. enum FunctionError.Reason
      1. + value INVALID_CONJUNCTION_OPERANDS
      2. + value INVALID_OPERAND
      3. + value MISSING_CONSTANT_OPERAND_VALUE
    4. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
    5. enum RequestContextOperand.ContextType
      1. + value DEVICE_PLATFORM
  17. CampaignService (4 new, 7 changed, 0 removed)
    1. + type EnhancedCpcBiddingScheme
    2. + type PageOnePromotedBiddingScheme
    3. + type TargetCpaBiddingScheme
    4. + type TargetSpendBiddingScheme
    5. enum BiddingErrors.Reason
      1. + value BIDDING_STRATEGY_AVAILABLE_FOR_ENHANCED_CAMPAIGN_ONLY
      2. + value BIDDING_STRATEGY_NOT_COMPATIBLE_WITH_ADGROUP_OVERRIDES
      3. + value BIDDING_STRATEGY_NOT_COMPATIBLE_WITH_ADGROUP_CRITERIA_OVERRIDES
      4. + value CAMPAIGN_BIDDING_STRATEGY_CANNOT_BE_OVERRIDDEN
      5. + value ADGROUP_BIDDING_STRATEGY_CANNOT_BE_OVERRIDDEN
      6. + value CANNOT_ATTACH_BIDDING_STRATEGY_TO_ADGROUP
      7. + value CANNOT_ATTACH_BIDDING_STRATEGY_TO_ADGROUP_CRITERIA
      8. + value INVALID_ANONYMOUS_BIDDING_STRATEGY_TYPE
      9. + value INVALID_BIDDING_STRATEGY_TYPE
      10. + value MISSING_BIDDING_STRATEGY_TYPE
      11. + value CANNOT_ATTACH_POP_BIDDING_STRATEGY_FOR_CONTENT_NETWORK_ONLY_CAMPAIGN
      12. + value CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_AD_GROUP_LEVEL_POP_BIDDING_STRATEGY
      13. + value CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_CAMPAIGN_LEVEL_POP_BIDDING_STRATEGY
      14. + value BIDDING_STRATEGY_NOT_SUPPORTED_WITH_AD_SCHEDULE
      15. + value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
    6. type BiddingStrategyConfiguration
      1. + field biddingStrategyId
      2. + field biddingStrategyName
      3. + field biddingStrategySource
    7. enum BiddingStrategyType
      1. + value PAGE_ONE_PROMOTED
      2. + value TARGET_SPEND
      3. + value ENHANCED_CPC
      4. + value TARGET_CPA
      5. + value NONE
    8. type Budget
      1. field associatedCampaigns
    9. enum BudgetError.Reason
      1. value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_SHARED_BY_BUDGET_OPTIMIZER_CAMPAIGN
    10. enum CampaignError.Reason
      1. + value BUDGET_CANNOT_BE_SHARED
      2. + value CAMPAIGN_CANNOT_USE_SHARED_BUDGET
      3. value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_OPTIMIZER_CAMPAIGN
    11. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
  18. ConstantDataService (0 new, 1 changed, 0 removed)
    1. enum Criterion.Type
      1. value POLYGON
  19. ConversionTrackerService (0 new, 1 changed, 0 removed)
    1. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
  20. CustomerService (0 new, 1 changed, 0 removed)
    1. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
  21. CustomerSyncService (1 new, 5 changed, 0 removed)
    1. + type FeedChangeData
    2. type AdGroupChangeData
      1. + field changedAdGroupBidModifierCriteria
      2. + field changedFeeds
      3. + field deletedAdGroupBidModifierCriteria
      4. + field deletedFeeds
    3. type CampaignChangeData
      1. + field changedFeeds
      2. + field deletedFeeds
    4. type CustomerChangeData
      1. + field changedFeeds
    5. enum CustomerSyncError.Reason
      1. + value INVALID_FEED_ID
    6. type CustomerSyncSelector
      1. + field feedIds
  22. = DataService (no changes)
  23. ExperimentService (0 new, 3 changed, 0 removed)
    1. enum BudgetError.Reason
      1. value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_SHARED_BY_BUDGET_OPTIMIZER_CAMPAIGN
    2. enum ExperimentServiceError.Reason
      1. + value CANNOT_USE_EXPERIMENT_WITH_SHARED_BUDGET
    3. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
  24. FeedItemService (2 new, 3 changed, 0 removed)
    1. + type BetaError
    2. + enum BetaError.Reason
    3. type BetaError
      1. + field reason
    4. type FeedItem
      1. + field scheduling
    5. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
  25. FeedMappingService (0 new, 2 changed, 0 removed)
    1. enum FeedMappingError.Reason
      1. + value MULTIPLE_MAPPINGS_FOR_PLACEHOLDER_TYPE
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
  26. FeedService (0 new, 1 changed, 0 removed)
    1. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
  27. = GeoLocationService (no changes)
  28. LocationCriterionService (0 new, 2 changed, 0 removed)
    1. enum Criterion.Type
      1. value POLYGON
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
  29. ManagedCustomerService (0 new, 1 changed, 0 removed)
    1. enum ManagedCustomerServiceError.Reason
      1. + value ADD_CUSTOMER_FAILURE
      2. + value SAVE_CUSTOMERS_FAILURE
      3. + value TEST_ACCOUNT_LINK_ERROR
  30. MediaService (0 new, 1 changed, 0 removed)
    1. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
  31. MutateJobService (20 new, 23 changed, 2 removed)
    1. + type AdGroupBidModifier
    2. + type AdGroupBidModifierOperation
    3. + enum BidModifierSource
    4. + type EnhancedCpcBiddingScheme
    5. + type FeedItem
    6. + enum FeedItem.Status
    7. + type FeedItemAttributeError
    8. + type FeedItemAttributeValue
    9. + type FeedItemDevicePreference
    10. + type FeedItemError
    11. + enum FeedItemError.Reason
    12. + type FeedItemOperation
    13. + type FeedItemSchedule
    14. + type FeedItemScheduling
    15. + type FeedItemValidationDetail
    16. + enum FeedItemValidationDetail.ApprovalStatus
    17. + enum FeedItemValidationDetail.ValidationStatus
    18. + type PageOnePromotedBiddingScheme
    19. + type TargetCpaBiddingScheme
    20. + type TargetSpendBiddingScheme
    21. enum AdError.Reason
      1. + value CUSTOMER_NOT_ELIGIBLE
    22. enum AdExtensionError.Reason
      1. + value INVALID_ADEXTENSION_TYPE
    23. type AdGroupBidModifier
      1. + field bidModifierSource
    24. type AdGroupBidModifierOperation
      1. + field operand
    25. type BiddableAdGroupCriterion
      1. + field bidModifier
    26. enum BiddingErrors.Reason
      1. + value BIDDING_STRATEGY_AVAILABLE_FOR_ENHANCED_CAMPAIGN_ONLY
      2. + value BIDDING_STRATEGY_NOT_COMPATIBLE_WITH_ADGROUP_OVERRIDES
      3. + value BIDDING_STRATEGY_NOT_COMPATIBLE_WITH_ADGROUP_CRITERIA_OVERRIDES
      4. + value CAMPAIGN_BIDDING_STRATEGY_CANNOT_BE_OVERRIDDEN
      5. + value ADGROUP_BIDDING_STRATEGY_CANNOT_BE_OVERRIDDEN
      6. + value CANNOT_ATTACH_BIDDING_STRATEGY_TO_ADGROUP
      7. + value CANNOT_ATTACH_BIDDING_STRATEGY_TO_ADGROUP_CRITERIA
      8. + value INVALID_ANONYMOUS_BIDDING_STRATEGY_TYPE
      9. + value INVALID_BIDDING_STRATEGY_TYPE
      10. + value MISSING_BIDDING_STRATEGY_TYPE
      11. + value CANNOT_ATTACH_POP_BIDDING_STRATEGY_FOR_CONTENT_NETWORK_ONLY_CAMPAIGN
      12. + value CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_AD_GROUP_LEVEL_POP_BIDDING_STRATEGY
      13. + value CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_CAMPAIGN_LEVEL_POP_BIDDING_STRATEGY
      14. + value BIDDING_STRATEGY_NOT_SUPPORTED_WITH_AD_SCHEDULE
      15. + value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
    27. type BiddingStrategyConfiguration
      1. + field biddingStrategyId
      2. + field biddingStrategyName
      3. + field biddingStrategySource
    28. enum BiddingStrategyType
      1. + value PAGE_ONE_PROMOTED
      2. + value TARGET_SPEND
      3. + value ENHANCED_CPC
      4. + value TARGET_CPA
      5. + value NONE
    29. type Budget
      1. field associatedCampaigns
    30. enum BudgetError.Reason
      1. value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_SHARED_BY_BUDGET_OPTIMIZER_CAMPAIGN
    31. enum CampaignError.Reason
      1. + value BUDGET_CANNOT_BE_SHARED
      2. + value CAMPAIGN_CANNOT_USE_SHARED_BUDGET
      3. value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_OPTIMIZER_CAMPAIGN
    32. enum Criterion.Type
      1. value POLYGON
    33. enum CriterionError.Reason
      1. + value CANNOT_ADD_DISPLAY_ONLY_LISTS_TO_SEARCH_ONLY_CAMPAIGNS
    34. type FeedItem
      1. + field attributeValues
      2. + field devicePreference
      3. + field feedId
      4. + field feedItemId
      5. + field scheduling
      6. + field status
      7. + field validationDetails
    35. type FeedItemAttributeError
      1. + field feedAttributeIds
    36. type FeedItemAttributeValue
      1. + field feedAttributeId
    37. type FeedItemError
      1. + field reason
    38. type FeedItemOperation
      1. + field operand
    39. type FeedItemScheduling
      1. + field feedItemSchedules
    40. type FeedItemValidationDetail
      1. + field approvalStatus
      2. + field feedMappingId
      3. + field validationErrors
      4. + field validationStatus
    41. enum FunctionError.Reason
      1. + value INVALID_CONJUNCTION_OPERANDS
      2. + value INVALID_OPERAND
      3. + value MISSING_CONSTANT_OPERAND_VALUE
    42. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
    43. type RichMediaAd
      1. + field adAttributes
    44. type Polygon
    45. type ProductExtension
  32. ReportDefinitionService (0 new, 1 changed, 0 removed)
    1. enum ReportDefinition.ReportType
      1. + value CAMPAIGN_LOCATION_TARGET_REPORT
      2. + value CAMPAIGN_AD_SCHEDULE_TARGET_REPORT
      3. + value CAMPAIGN_PLATFORM_TARGET_REPORT
  33. SharedCriterionService (0 new, 2 changed, 0 removed)
    1. enum Criterion.Type
      1. value POLYGON
    2. enum CriterionError.Reason
      1. + value CANNOT_ADD_DISPLAY_ONLY_LISTS_TO_SEARCH_ONLY_CAMPAIGNS
  34. SharedSetService (0 new, 1 changed, 0 removed)
    1. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
  35. TargetingIdeaService (0 new, 4 changed, 0 removed)
    1. enum BudgetError.Reason
      1. value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_SHARED_BY_BUDGET_OPTIMIZER_CAMPAIGN
    2. enum Criterion.Type
      1. value POLYGON
    3. enum CriterionError.Reason
      1. + value CANNOT_ADD_DISPLAY_ONLY_LISTS_TO_SEARCH_ONLY_CAMPAIGNS
    4. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE
  36. TrafficEstimatorService (0 new, 2 changed, 0 removed)
    1. enum Criterion.Type
      1. value POLYGON
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE

AdGroupBidModifierService

What's New

We're introducing the new AdGroupBidModifierService (in both v201209 and v201302) for managing ad group level bid modifiers in enhanced campaigns. This service allows you to override campaign-level bids for certain criteria. As of this release, only HighEndMobile criterion (ID=30001) bids can be modified at the ad group level. Refer to the Ad Group Level Bid Modifiers guide for usage examples.

v201302

What's New

Enhanced campaigns management

An enhanced field was added to the Campaign object allowing for natively managed enhanced campaigns. Refer to the Enhanced Campaigns guide for more details.

Feed services

The eventual replacement for all ad extensions, Feed services allow for managing site, phone, and app link extensions through custom data feeds. Feeds are supported in the API through five new services:

For an example of how to use feeds, see Creating Sitelinks Using Feed Services.

New bidding structure

The new ad group and criteria bids setting structure is more flexible and simplifies the management of bidding transitions. See the Bidding guide for some examples.

Programmatic management of MCC to client account links

The new ManagedCustomerService methods enable you to invite accounts to be managed by your MCC, accept such invitations, revoke existing links, and move links between MCCs. See Managing Customer Accounts for more details.

Mobile preferred ad management

A devicePreference field was added to the Ad object allowing for mobile preferred ads submission.

Ability to select the bidding dimension for the Display Network

A change to the AdGroup object that allows you to select the contentBidCriterionTypeGroup for your absolute bids on the Content Network, instead of relying on the old fixed order of bids.

App promotion ads

A new template ad specifically meant for mobile app developers who want to run ads promoting mobile and tablet apps. This ad format, known as "click-to-download" or app promotion ads, makes it easier for people to download your mobile app from Google Play or iTunes. Version v201302 of the AdWords API adds support for this new ad format. To use this format, you first need to upgrade your campaign to enhanced campaigns.

Enhancements to TargetingIdeaService and TrafficEstimatorService

For TargetingIdeaService, new enhancements include the ability to filter by network through the NetworkSearchParameter and a new published metric: AVERAGE_CPC. For TrafficEstimatorService, keyword StatsEstimates now contain two new attributes: impressionsPerDay and clickThroughRate.

New reports

The following are new report types introduced in v201302:

  • AUDIENCE_PERFORMANCE_REPORT
  • BUDGET_PERFORMANCE_REPORT
  • CAMPAIGN_NEGATIVE_LOCATIONS_REPORT
  • DISPLAY_TOPICS_PERFORMANCE_REPORT
  • PLACEHOLDER_FEED_ITEM_REPORT
  • PLACEMENT_PERFORMANCE_REPORT
  • CAMPAIGN_SHARED_SET_REPORT Beta
  • KEYWORDLESS_CATEGORY_REPORT Beta
  • KEYWORDLESS_QUERY_REPORT Beta
  • SHARED_SET_CRITERIA_REPORT Beta
  • SHARED_SET_REPORT Beta
Deprecated

InfoService has been removed.

Migration Guide

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

Shared sets Beta

Support for Shared sets (negative keyword list and negative placements) through SharedSetService.

API Changes

  1. - InfoService
  2. + AdGroupFeedService
  3. + CampaignFeedService
  4. + CampaignSharedSetService
  5. + FeedItemService
  6. + FeedMappingService
  7. + FeedService
  8. + SharedCriterionService
  9. + SharedSetService
  10. AdExtensionOverrideService (2 new, 2 changed, 0 removed)
    1. + type IdError
    2. + enum IdError.Reason
    3. type IdError
      1. + field reason
    4. type Stats
      1. + field totalBudget
  11. AdGroupAdService (4 new, 8 changed, 0 removed)
    1. + type ForwardCompatibilityError
    2. + enum ForwardCompatibilityError.Reason
    3. + type StringLengthError
    4. + enum StringLengthError.Reason
    5. type Ad
      1. + field devicePreference
    6. enum AdError.Reason
      1. + value UNSUPPORTED_PARENT_CAMPAIGN_FOR_DEVICE_PREFERENCE
      2. + value INCOMPATIBLE_AD_TYPE_AND_DEVICE_PREFERENCE
    7. enum DateError.Reason
      1. + value INVALID_FIELD_VALUES_IN_DATE_TIME
    8. type EntityCountLimitExceeded
      1. + field accountLimitType
      2. + field existingCount
    9. enum EntityCountLimitExceeded.Reason
      1. + value MATCHING_FUNCTION_LIMIT
    10. type ForwardCompatibilityError
      1. + field reason
    11. type Stats
      1. + field totalBudget
    12. type StringLengthError
      1. + field reason
  12. AdGroupCriterionService (8 new, 11 changed, 0 removed)
    1. + type BiddingErrors
    2. + enum BiddingErrors.Reason
    3. + type ForwardCompatibilityError
    4. + enum ForwardCompatibilityError.Reason
    5. + type IdError
    6. + enum IdError.Reason
    7. + type StringLengthError
    8. + enum StringLengthError.Reason
    9. enum AdGroupCriterionLimitExceeded.CriteriaLimitType
      1. + value ADGROUP_CRITERION
      2. + value UNKNOWN
    10. type BiddableAdGroupCriterion
      1. + field biddingStrategyConfiguration
      2. field bids
    11. type BiddingErrors
      1. + field reason
    12. enum CriterionError.Reason
      1. + value CANNOT_ADD_BID_MODIFIER_FOR_BIDDING_STRATEGY
    13. enum DateError.Reason
      1. + value INVALID_FIELD_VALUES_IN_DATE_TIME
    14. type EntityCountLimitExceeded
      1. + field accountLimitType
      2. + field existingCount
    15. enum EntityCountLimitExceeded.Reason
      1. + value MATCHING_FUNCTION_LIMIT
    16. type ForwardCompatibilityError
      1. + field reason
    17. type IdError
      1. + field reason
    18. type Stats
      1. + field totalBudget
    19. type StringLengthError
      1. + field reason
  13. AdGroupService (8 new, 11 changed, 0 removed)
    1. + type BiddingErrors
    2. + enum BiddingErrors.Reason
    3. + type ForwardCompatibilityError
    4. + enum ForwardCompatibilityError.Reason
    5. + type IdError
    6. + enum IdError.Reason
    7. + type StringLengthError
    8. + enum StringLengthError.Reason
    9. type AdGroup
      1. + field biddingStrategyConfiguration
      2. + field contentBidCriterionTypeGroup
      3. field bids
    10. enum AdGroupServiceError.Reason
      1. + value INVALID_CONTENT_BID_CRITERION_TYPE_GROUP
    11. type BiddingErrors
      1. + field reason
    12. enum CriterionTypeGroup
      1. + value KEYWORD
    13. enum DateError.Reason
      1. + value INVALID_FIELD_VALUES_IN_DATE_TIME
    14. type EntityCountLimitExceeded
      1. + field accountLimitType
      2. + field existingCount
    15. enum EntityCountLimitExceeded.Reason
      1. + value MATCHING_FUNCTION_LIMIT
    16. type ForwardCompatibilityError
      1. + field reason
    17. type IdError
      1. + field reason
    18. type Stats
      1. + field totalBudget
    19. type StringLengthError
      1. + field reason
  14. AdParamService (4 new, 2 changed, 0 removed)
    1. + type IdError
    2. + enum IdError.Reason
    3. + type ReadOnlyError
    4. + enum ReadOnlyError.Reason
    5. type IdError
      1. + field reason
    6. type ReadOnlyError
      1. + field reason
  15. AlertService (2 new, 2 changed, 0 removed)
    1. + type IdError
    2. + enum IdError.Reason
    3. enum DateError.Reason
      1. + value INVALID_FIELD_VALUES_IN_DATE_TIME
    4. type IdError
      1. + field reason
  16. BudgetOrderService (2 new, 4 changed, 0 removed)
    1. + type CustomerOrderLineError
    2. + enum CustomerOrderLineError.Reason
    3. type BillingAccount
      1. + field primaryBillingId
      2. + field secondaryBillingId
    4. enum BudgetOrderError.Reason
      1. + value MCC_HIERARCHY_SIZE_TOO_LARGE
      2. + value INVALID_MCC_HIERARCHY
    5. type CustomerOrderLineError
      1. + field reason
    6. enum DateError.Reason
      1. + value INVALID_FIELD_VALUES_IN_DATE_TIME
  17. BudgetService (6 new, 9 changed, 0 removed)
    1. + type IdError
    2. + enum IdError.Reason
    3. + type OperationAccessDenied
    4. + enum OperationAccessDenied.Reason
    5. + type ReadOnlyError
    6. + enum ReadOnlyError.Reason
    7. type Budget
      1. + field associatedCampaigns
      2. + field isExplicitlyShared
    8. enum BudgetError.Reason
      1. + value BUDGET_DELETED
      2. + value BUDGET_IN_USE
      3. + value CANNOT_EDIT_SHARED_BUDGET
      4. + value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_SHARED_BY_BUDGET_OPTIMIZER_CAMPAIGN
      5. + value DUPLICATE_NAME
      6. value INVALID_BUDGET_SCHEDULE
    9. type BudgetReturnValue
      1. + field partialFailureErrors
    10. enum DateError.Reason
      1. + value INVALID_FIELD_VALUES_IN_DATE_TIME
    11. type EntityCountLimitExceeded
      1. + field accountLimitType
      2. + field existingCount
    12. enum EntityCountLimitExceeded.Reason
      1. + value MATCHING_FUNCTION_LIMIT
    13. type IdError
      1. + field reason
    14. type OperationAccessDenied
      1. + field reason
    15. type ReadOnlyError
      1. + field reason
  18. CampaignAdExtensionService (2 new, 4 changed, 0 removed)
    1. + type IdError
    2. + enum IdError.Reason
    3. type EntityCountLimitExceeded
      1. + field accountLimitType
      2. + field existingCount
    4. enum EntityCountLimitExceeded.Reason
      1. + value MATCHING_FUNCTION_LIMIT
    5. type IdError
      1. + field reason
    6. type Stats
      1. + field totalBudget
  19. CampaignCriterionService (2 new, 5 changed, 0 removed)
    1. + type IdError
    2. + enum IdError.Reason
    3. enum ContentLabelType
      1. + value UNKNOWN
    4. enum CriterionError.Reason
      1. + value CANNOT_ADD_BID_MODIFIER_FOR_BIDDING_STRATEGY
    5. type EntityCountLimitExceeded
      1. + field accountLimitType
      2. + field existingCount
    6. enum EntityCountLimitExceeded.Reason
      1. + value MATCHING_FUNCTION_LIMIT
    7. type IdError
      1. + field reason
  20. CampaignService (6 new, 13 changed, 1 removed)
    1. + type BiddingErrors
    2. + enum BiddingErrors.Reason
    3. + type ForwardCompatibilityError
    4. + enum ForwardCompatibilityError.Reason
    5. + type IdError
    6. + enum IdError.Reason
    7. type BiddingErrors
      1. + field reason
    8. type Budget
      1. + field associatedCampaigns
      2. + field isExplicitlyShared
    9. enum BudgetError.Reason
      1. + value BUDGET_DELETED
      2. + value BUDGET_IN_USE
      3. + value CANNOT_EDIT_SHARED_BUDGET
      4. + value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_SHARED_BY_BUDGET_OPTIMIZER_CAMPAIGN
      5. + value DUPLICATE_NAME
      6. value INVALID_BUDGET_SCHEDULE
    10. type Campaign
      1. + field biddingStrategyConfiguration
      2. + field enhanced
      3. field biddingStrategy
    11. enum CampaignError.Reason
      1. + value BIDDING_STRATEGY_NOT_SUPPORTED_WITH_BID_MODIFIER
      2. + value BIDDING_STRATEGY_NOT_SUPPORTED_WITH_AD_SCHEDULE
    12. type CampaignOperation
      1. field biddingTransition
    13. type CampaignPage
      1. field totalBudget
    14. enum DateError.Reason
      1. + value INVALID_FIELD_VALUES_IN_DATE_TIME
    15. type EntityCountLimitExceeded
      1. + field accountLimitType
      2. + field existingCount
    16. enum EntityCountLimitExceeded.Reason
      1. + value MATCHING_FUNCTION_LIMIT
    17. type ForwardCompatibilityError
      1. + field reason
    18. type IdError
      1. + field reason
    19. type Stats
      1. + field totalBudget
    20. type TargetRestrictSetting
  21. ConstantDataService (6 new, 4 changed, 0 removed)
    1. + type IdError
    2. + enum IdError.Reason
    3. + type ReadOnlyError
    4. + enum ReadOnlyError.Reason
    5. + type StringLengthError
    6. + enum StringLengthError.Reason
    7. enum DateError.Reason
      1. + value INVALID_FIELD_VALUES_IN_DATE_TIME
    8. type IdError
      1. + field reason
    9. type ReadOnlyError
      1. + field reason
    10. type StringLengthError
      1. + field reason
  22. ConversionTrackerService (5 new, 4 changed, 0 removed)
    1. + type AppConversion
    2. + type IdError
    3. + enum IdError.Reason
    4. + type StringLengthError
    5. + enum StringLengthError.Reason
    6. type AdWordsConversionTracker
      1. field httpProtocol
    7. enum DateError.Reason
      1. + value INVALID_FIELD_VALUES_IN_DATE_TIME
    8. type IdError
      1. + field reason
    9. type StringLengthError
      1. + field reason
  23. CustomerSyncService (2 new, 2 changed, 0 removed)
    1. + type IdError
    2. + enum IdError.Reason
    3. enum DateError.Reason
      1. + value INVALID_FIELD_VALUES_IN_DATE_TIME
    4. type IdError
      1. + field reason
  24. DataService (6 new, 4 changed, 0 removed)
    1. + type IdError
    2. + enum IdError.Reason
    3. + type ReadOnlyError
    4. + enum ReadOnlyError.Reason
    5. + type StringLengthError
    6. + enum StringLengthError.Reason
    7. enum DateError.Reason
      1. + value INVALID_FIELD_VALUES_IN_DATE_TIME
    8. type IdError
      1. + field reason
    9. type ReadOnlyError
      1. + field reason
    10. type StringLengthError
      1. + field reason
  25. ExperimentService (2 new, 3 changed, 0 removed)
    1. + type IdError
    2. + enum IdError.Reason
    3. enum BudgetError.Reason
      1. + value BUDGET_DELETED
      2. + value BUDGET_IN_USE
      3. + value CANNOT_EDIT_SHARED_BUDGET
      4. + value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_SHARED_BY_BUDGET_OPTIMIZER_CAMPAIGN
      5. + value DUPLICATE_NAME
      6. value INVALID_BUDGET_SCHEDULE
    4. enum DateError.Reason
      1. + value INVALID_FIELD_VALUES_IN_DATE_TIME
    5. type IdError
      1. + field reason
  26. GeoLocationService (8 new, 4 changed, 0 removed)
    1. + type DatabaseError
    2. + enum DatabaseError.Reason
    3. + type DistinctError
    4. + enum DistinctError.Reason
    5. + type IdError
    6. + enum IdError.Reason
    7. + type ReadOnlyError
    8. + enum ReadOnlyError.Reason
    9. type DatabaseError
      1. + field reason
    10. type DistinctError
      1. + field reason
    11. type IdError
      1. + field reason
    12. type ReadOnlyError
      1. + field reason
  27. LocationCriterionService (6 new, 4 changed, 0 removed)
    1. + type IdError
    2. + enum IdError.Reason
    3. + type ReadOnlyError
    4. + enum ReadOnlyError.Reason
    5. + type StringLengthError
    6. + enum StringLengthError.Reason
    7. enum DateError.Reason
      1. + value INVALID_FIELD_VALUES_IN_DATE_TIME
    8. type IdError
      1. + field reason
    9. type ReadOnlyError
      1. + field reason
    10. type StringLengthError
      1. + field reason
  28. ManagedCustomerService (12 new, 8 changed, 0 removed)
    1. + type IdError
    2. + enum IdError.Reason
    3. + type LinkOperation
    4. + enum LinkStatus
    5. + type MoveOperation
    6. + type MutateLinkResults
    7. + type MutateManagerResults
    8. + type PendingInvitation
    9. + type PendingInvitationSelector
    10. + operation getPendingInvitations
    11. + operation mutateLink
    12. + operation mutateManager
    13. enum DateError.Reason
      1. + value INVALID_FIELD_VALUES_IN_DATE_TIME
    14. type IdError
      1. + field reason
    15. type ManagedCustomer
      1. + field testAccount
    16. type ManagedCustomerLink
      1. + field linkStatus
      2. + field pendingDescriptiveName
    17. enum ManagedCustomerServiceError.Reason
      1. + value NOT_AUTHORIZED
    18. operation getPendingInvitations
      1. + response rval
      2. + parameter selector
    19. operation mutateLink
      1. + parameter operations
      2. + response rval
    20. operation mutateManager
      1. + parameter operations
      2. + response rval
  29. MediaService (6 new, 3 changed, 0 removed)
    1. + type DistinctError
    2. + enum DistinctError.Reason
    3. + type IdError
    4. + enum IdError.Reason
    5. + type StringLengthError
    6. + enum StringLengthError.Reason
    7. type DistinctError
      1. + field reason
    8. type IdError
      1. + field reason
    9. type StringLengthError
      1. + field reason
  30. MutateJobService (5 new, 20 changed, 1 removed)
    1. + type BiddingErrors
    2. + enum BiddingErrors.Reason
    3. + type BudgetOperation
    4. + type ForwardCompatibilityError
    5. + enum ForwardCompatibilityError.Reason
    6. type Ad
      1. + field devicePreference
    7. enum AdError.Reason
      1. + value UNSUPPORTED_PARENT_CAMPAIGN_FOR_DEVICE_PREFERENCE
      2. + value INCOMPATIBLE_AD_TYPE_AND_DEVICE_PREFERENCE
    8. type AdGroup
      1. + field biddingStrategyConfiguration
      2. + field contentBidCriterionTypeGroup
      3. field bids
    9. enum AdGroupCriterionLimitExceeded.CriteriaLimitType
      1. + value ADGROUP_CRITERION
      2. + value UNKNOWN
    10. enum AdGroupServiceError.Reason
      1. + value INVALID_CONTENT_BID_CRITERION_TYPE_GROUP
    11. type BiddableAdGroupCriterion
      1. + field biddingStrategyConfiguration
      2. field bids
    12. type BiddingErrors
      1. + field reason
    13. type Budget
      1. + field associatedCampaigns
      2. + field isExplicitlyShared
    14. enum BudgetError.Reason
      1. + value BUDGET_DELETED
      2. + value BUDGET_IN_USE
      3. + value CANNOT_EDIT_SHARED_BUDGET
      4. + value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_SHARED_BY_BUDGET_OPTIMIZER_CAMPAIGN
      5. + value DUPLICATE_NAME
      6. value INVALID_BUDGET_SCHEDULE
    15. type Campaign
      1. + field biddingStrategyConfiguration
      2. + field enhanced
      3. field biddingStrategy
    16. enum CampaignError.Reason
      1. + value BIDDING_STRATEGY_NOT_SUPPORTED_WITH_BID_MODIFIER
      2. + value BIDDING_STRATEGY_NOT_SUPPORTED_WITH_AD_SCHEDULE
    17. type CampaignOperation
      1. field biddingTransition
    18. enum ContentLabelType
      1. + value UNKNOWN
    19. enum CriterionError.Reason
      1. + value CANNOT_ADD_BID_MODIFIER_FOR_BIDDING_STRATEGY
    20. enum CriterionTypeGroup
      1. + value KEYWORD
    21. enum DateError.Reason
      1. + value INVALID_FIELD_VALUES_IN_DATE_TIME
    22. type EntityCountLimitExceeded
      1. + field accountLimitType
      2. + field existingCount
    23. enum EntityCountLimitExceeded.Reason
      1. + value MATCHING_FUNCTION_LIMIT
    24. type ForwardCompatibilityError
      1. + field reason
    25. type Stats
      1. + field totalBudget
    26. type TargetRestrictSetting
  31. ReportDefinitionService (2 new, 3 changed, 0 removed)
    1. + type IdError
    2. + enum IdError.Reason
    3. enum DateError.Reason
      1. + value INVALID_FIELD_VALUES_IN_DATE_TIME
    4. type IdError
      1. + field reason
    5. enum ReportDefinition.ReportType
      1. + value KEYWORDLESS_QUERY_REPORT
      2. + value KEYWORDLESS_CATEGORY_REPORT
      3. + value BUDGET_PERFORMANCE_REPORT
      4. + value PLACEHOLDER_FEED_ITEM_REPORT
      5. + value PLACEMENT_PERFORMANCE_REPORT
      6. + value CAMPAIGN_NEGATIVE_LOCATIONS_REPORT
      7. + value CAMPAIGN_LOCATION_TARGET_REPORT
      8. + value CAMPAIGN_AD_SCHEDULE_TARGET_REPORT
      9. + value CAMPAIGN_PLATFORM_TARGET_REPORT
      10. + value AUDIENCE_PERFORMANCE_REPORT
      11. + value DISPLAY_TOPICS_PERFORMANCE_REPORT
      12. value MANAGED_PLACEMENTS_PERFORMANCE_REPORT
  32. TargetingIdeaService (1 new, 7 changed, 1 removed)
    1. + type NetworkSearchParameter
    2. enum AdGroupCriterionLimitExceeded.CriteriaLimitType
      1. + value ADGROUP_CRITERION
      2. + value UNKNOWN
    3. enum AttributeType
      1. + value AVERAGE_CPC
      2. value NGRAM_GROUP
    4. enum BudgetError.Reason
      1. + value BUDGET_DELETED
      2. + value BUDGET_IN_USE
      3. + value CANNOT_EDIT_SHARED_BUDGET
      4. + value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_SHARED_BY_BUDGET_OPTIMIZER_CAMPAIGN
      5. + value DUPLICATE_NAME
      6. value INVALID_BUDGET_SCHEDULE
    5. enum CriterionError.Reason
      1. + value CANNOT_ADD_BID_MODIFIER_FOR_BIDDING_STRATEGY
    6. enum DateError.Reason
      1. + value INVALID_FIELD_VALUES_IN_DATE_TIME
    7. type EntityCountLimitExceeded
      1. + field accountLimitType
      2. + field existingCount
    8. enum EntityCountLimitExceeded.Reason
      1. + value MATCHING_FUNCTION_LIMIT
    9. type DeviceTypeSearchParameter
  33. TrafficEstimatorService (0 new, 3 changed, 0 removed)
    1. enum ContentLabelType
      1. + value UNKNOWN
    2. enum DateError.Reason
      1. + value INVALID_FIELD_VALUES_IN_DATE_TIME
    3. type StatsEstimate
      1. + field clickThroughRate
      2. + field impressionsPerDay
  34. UserListService (6 new, 3 changed, 0 removed)
    1. + type EntityNotFound
    2. + enum EntityNotFound.Reason
    3. + type IdError
    4. + enum IdError.Reason
    5. + type StringLengthError
    6. + enum StringLengthError.Reason
    7. type EntityNotFound
      1. + field reason
    8. type IdError
      1. + field reason
    9. type StringLengthError
      1. + field reason

Enhanced Campaigns

What's New

Retroactive for versions v201206 and v201209, we've added the ability to manage enhanced campaigns through the use of Forward Compatibility Maps. For a general overview of enhanced campaigns, refer to the Enhanced Campaign Site page. We outline the capabilities of enhanced campaigns below.

With the combination of forward compatibility maps in CampaignService and AdGroupAdService, and bid modifiers in CampaignCriterionService, you now can:

  • Create new enhanced campaigns
  • Set campaigns as enhanced campaigns
  • Submit mobile-preferred ads
  • Retrieve Google suggested bid adjustment
  • Set Mobile bid adjustments (known in the API as bid modifiers)

Each of these new capabilities is described below.

Create enhanced campaigns or convert existing ones to enhanced

Use the CampaignService, the Campaign.forwardCompatibilityMap field and the Campaign.enhanced key to create new enhanced campaigns or convert existing ones. This key can be read on get calls to check the enhanced state of a campaign. It can also be sent a value of true on mutate calls to enhance campaigns. Setting the value of the key to false after a campaign has been enhanced is not allowed. Keys and values in the forward compatibility map are always returned and should not be requested as part of the fields of the request selector. For sample code on how to do this, refer to the 'set campaign enhanced' example (located in the campaign management folder). This sample code is available across all client libraries.

Submit mobile preferred ads

Use the AdGroupAdService, the AdGroupAd.forwardCompatibilityMap field and the Ad.devicePreference key to submit new mobile preferred ads. This key is only accepted in mutate ADD calls for Ads of type TextAd, ImageAd, DynamicSearchAd, TemplateAd, and ThirdPartyRedirectAd. The value of this key can only be set to 30001, which refers to the HighEndMobile platform.

Retrieve Google's suggested mobile bid adjustment

Use the CampaignService, the Campaign.forwardCompatibilityMap field and the Campaign.suggestedMobileBidAdjustment key to retrieve the suggested mobile bid adjustment from the map. The key is read only and will be ignored if sent back in a mutate call. Keys and values in the forward compatibility map are always returned and should not be requested as part of the fields of the request selector.

Set mobile bid adjustments

Use the CampaignCriterionService and the CampaignCriterion.bidModifier field to set mobile bid adjustments. You may only set the bidModifier if the CampaignCriterion is of type AdSchedule or HighEndMobile Platform. Specifying -1 clears the field. For sample code on how to do this, refer to the 'set bid modifier' example (located in the campaign management folder). This sample code is available across all client libraries.

v201209

What's New

BudgetService
The new BudgetService allows you to add, remove, or update a Budget. This newly independent Budget object can be shared across multiple Campaigns.
Reports
  • Report download errors are now returned in an easier to parse XML format.
  • A version in the report download URL is required when downloading reports.
  • Report downloads using reportDefinitionId is no longer permitted. The only allowable method for downloading reports is AdHoc Reports.
Ad group-level demographic targeting
The demographic targeting criteria AgeRange and Gender are now available at the Ad group level.
Rotate indefinitely
CampaignService now has a fourth ad rotation option: ROTATE_INDEFINITELY.
Deprecated
BulkMutateJobService has been removed in favor of MutateJobService.
Migration Guide
Breaking changes introduced in this version are summarized in the v201209 migration guide.

API Changes

  1. - BulkMutateJobService
  2. + BudgetService
  3. AdExtensionOverrideService (0 new, 2 changed, 0 removed)
    1. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    2. enum InternalApiError.Reason
      1. + value DOWNTIME
  4. AdGroupAdService (0 new, 3 changed, 0 removed)
    1. type AdGroupAd
      1. + field forwardCompatibilityMap
    2. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    3. enum InternalApiError.Reason
      1. + value DOWNTIME
  5. AdGroupCriterionService (6 new, 6 changed, 0 removed)
    1. + type AgeRange
    2. + enum AgeRange.AgeRangeType
    3. + type Gender
    4. + enum Gender.GenderType
    5. + type MobileAppCategory
    6. + type MobileApplication
    7. type AdGroupCriterion
      1. + field forwardCompatibilityMap
    8. type AgeRange
      1. + field ageRangeType
    9. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    10. enum Criterion.Type
      1. + value MOBILE_APPLICATION
      2. + value MOBILE_APP_CATEGORY
    11. type Gender
      1. + field genderType
    12. enum InternalApiError.Reason
      1. + value DOWNTIME
  6. AdGroupService (0 new, 4 changed, 0 removed)
    1. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    2. type ConversionOptimizerAdGroupBids
      1. field deduplicationMode
    3. enum CriterionTypeGroup
      1. + value GENDER
      2. + value AGE_RANGE
    4. enum InternalApiError.Reason
      1. + value DOWNTIME
  7. AdParamService (0 new, 2 changed, 0 removed)
    1. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    2. enum InternalApiError.Reason
      1. + value DOWNTIME
  8. AlertService (0 new, 2 changed, 0 removed)
    1. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    2. enum InternalApiError.Reason
      1. + value DOWNTIME
  9. BudgetOrderService (1 new, 4 changed, 0 removed)
    1. + type BudgetOrderRequest
    2. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    3. type BudgetOrder
      1. + field billingAccountName
      2. + field budgetOrderName
      3. + field lastRequest
      4. + field poNumber
      5. + field primaryBillingId
      6. + field secondaryBillingId
    4. enum BudgetOrderError.Reason
      1. + value CUSTOMER_NOT_WHITELISTED_FOR_NEW_BILLING
    5. enum InternalApiError.Reason
      1. + value DOWNTIME
  10. CampaignAdExtensionService (0 new, 2 changed, 0 removed)
    1. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    2. enum InternalApiError.Reason
      1. + value DOWNTIME
  11. CampaignCriterionService (2 new, 4 changed, 0 removed)
    1. + type MobileAppCategory
    2. + type MobileApplication
    3. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    4. type CampaignCriterion
      1. + field forwardCompatibilityMap
    5. enum Criterion.Type
      1. + value MOBILE_APPLICATION
      2. + value MOBILE_APP_CATEGORY
    6. enum InternalApiError.Reason
      1. + value DOWNTIME
  12. CampaignService (1 new, 7 changed, 0 removed)
    1. + type TrackingSetting
    2. enum AdServingOptimizationStatus
      1. + value ROTATE_INDEFINITELY
    3. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    4. type Budget
      1. + field budgetId
      2. + field name
      3. + field referenceCount
      4. + field status
    5. type ConversionOptimizer
      1. field deduplicationMode
    6. type ConversionOptimizerAdGroupBids
      1. field deduplicationMode
    7. enum InternalApiError.Reason
      1. + value DOWNTIME
    8. type NetworkSetting
      1. field targetContentContextual
  13. ConstantDataService (0 new, 3 changed, 0 removed)
    1. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    2. enum Criterion.Type
      1. + value MOBILE_APPLICATION
      2. + value MOBILE_APP_CATEGORY
    3. enum InternalApiError.Reason
      1. + value DOWNTIME
  14. ConversionTrackerService (0 new, 2 changed, 0 removed)
    1. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    2. enum InternalApiError.Reason
      1. + value DOWNTIME
  15. CustomerService (0 new, 2 changed, 0 removed)
    1. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    2. enum InternalApiError.Reason
      1. + value DOWNTIME
  16. CustomerSyncService (0 new, 2 changed, 0 removed)
    1. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    2. enum InternalApiError.Reason
      1. + value DOWNTIME
  17. DataService (0 new, 2 changed, 0 removed)
    1. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    2. enum InternalApiError.Reason
      1. + value DOWNTIME
  18. ExperimentService (0 new, 2 changed, 0 removed)
    1. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    2. enum InternalApiError.Reason
      1. + value DOWNTIME
  19. GeoLocationService (0 new, 2 changed, 0 removed)
    1. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    2. enum InternalApiError.Reason
      1. + value DOWNTIME
  20. InfoService (0 new, 2 changed, 0 removed)
    1. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    2. enum InternalApiError.Reason
      1. + value DOWNTIME
  21. LocationCriterionService (2 new, 4 changed, 0 removed)
    1. + type OperationAccessDenied
    2. + enum OperationAccessDenied.Reason
    3. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    4. enum Criterion.Type
      1. + value MOBILE_APPLICATION
      2. + value MOBILE_APP_CATEGORY
    5. enum InternalApiError.Reason
      1. + value DOWNTIME
    6. type OperationAccessDenied
      1. + field reason
  22. ManagedCustomerService (0 new, 2 changed, 0 removed)
    1. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    2. enum InternalApiError.Reason
      1. + value DOWNTIME
  23. MediaService (0 new, 2 changed, 0 removed)
    1. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    2. enum InternalApiError.Reason
      1. + value DOWNTIME
  24. MutateJobService (3 new, 12 changed, 0 removed)
    1. + type MobileAppCategory
    2. + type MobileApplication
    3. + type TrackingSetting
    4. type AdGroupAd
      1. + field forwardCompatibilityMap
    5. type AdGroupCriterion
      1. + field forwardCompatibilityMap
    6. enum AdServingOptimizationStatus
      1. + value ROTATE_INDEFINITELY
    7. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    8. type Budget
      1. + field budgetId
      2. + field name
      3. + field referenceCount
      4. + field status
    9. type CampaignCriterion
      1. + field forwardCompatibilityMap
    10. type ConversionOptimizer
      1. field deduplicationMode
    11. type ConversionOptimizerAdGroupBids
      1. field deduplicationMode
    12. enum Criterion.Type
      1. + value MOBILE_APPLICATION
      2. + value MOBILE_APP_CATEGORY
    13. enum CriterionTypeGroup
      1. + value GENDER
      2. + value AGE_RANGE
    14. enum InternalApiError.Reason
      1. + value DOWNTIME
    15. type NetworkSetting
      1. field targetContentContextual
  25. ReportDefinitionService (0 new, 3 changed, 0 removed)
    1. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    2. enum InternalApiError.Reason
      1. + value DOWNTIME
    3. enum ReportDefinition.ReportType
      1. + value DISPLAY_KEYWORD_PERFORMANCE_REPORT
  26. TargetingIdeaService (2 new, 4 changed, 0 removed)
    1. + type MobileAppCategory
    2. + type MobileApplication
    3. enum AttributeType
      1. value AD_SHARE
      2. value SEARCH_SHARE
    4. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    5. enum Criterion.Type
      1. + value MOBILE_APPLICATION
      2. + value MOBILE_APP_CATEGORY
    6. enum InternalApiError.Reason
      1. + value DOWNTIME
  27. TrafficEstimatorService (2 new, 4 changed, 0 removed)
    1. + type MobileAppCategory
    2. + type MobileApplication
    3. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    4. enum Criterion.Type
      1. + value MOBILE_APPLICATION
      2. + value MOBILE_APP_CATEGORY
    5. enum InternalApiError.Reason
      1. + value DOWNTIME
    6. type NetworkSetting
      1. field targetContentContextual
  28. UserListService (0 new, 2 changed, 0 removed)
    1. enum AuthorizationError.Reason
      1. + value SERVICE_ACCESS_DENIED
    2. enum InternalApiError.Reason
      1. + value DOWNTIME

v201206

What's New

New CLICK_PERFORMANCE_REPORT type
This new report type publishes Period Click Stats that can be tied to ValueTrack.
Conversion-aware Creative Rotation (CaCR) campaign setting
CONVERSION_OPTIMIZE joins ROTATE and OPTIMIZE as possible AdServingOptimizationStatus values. CaCR uses conversion tracking data in determining ad delivery.
Reach and Frequency reports
Three new reports are available: ACCOUNT_REACH_FREQUENCY_REPORT, CAMPAIGN_REACH_FREQUENCY_REPORT, and ADGROUP_REACH_FREQUENCY_REPORT.
Target restrict setting migrated to ad group
Campaign target restriction has migrated to the ad group level with the introduction of CampaignService.TargetRestrictSetting and AdGroupService.TargetingSetting.
AdSchedule criterion
The new AdSchedule criterion in CampaignCriterionService allows you to specify day and time in targeting ads.
LocationTargetingStatus
The new targetingStatus field indicates whether a particular location is active, obsolete, or is about to become obsolete.
BiddingTransition
BiddingTransition no longer requires a default bid via explicitAdGroupBids.
AWQL
The AdWords Query Language (AWQL) is a SQL-like language that is now available on some services including AdHoc reports.
getUserInterests and getVerticals in ConstantDataService
You can retrieve a list of user interests and verticals with these two new methods.
Deprecated

CreateAccountService and ServicedAccountService have been replaced with CustomerService and ManagedCustomerService.

The following Stats fields have been removed from AdGroupCriterionService. They can be retrieved through reports instead.

  • avgCostForOfflineInteraction
  • conversionRate
  • conversionsManyPerClick
  • conversionRateManyPerClick
  • costPerConversion
  • costPerConversionManyPerClick
  • invalidClicks
  • invalidClickRate
  • numOfflineImpressions
  • numOfflineInteractions
  • offlineInteractionCost
  • offlineInteractionRate
  • totalConvValue
  • valuePerConv
  • valuePerConvManyPerClick

Migration Guide
Breaking changes introduced in this version are summarized in the v201206 migration guide.

API Changes

  1. - CreateAccountService
  2. - ServicedAccountService
  3. AdExtensionOverrideService (4 new, 3 changed, 0 removed)
    1. + type AdxError
    2. + enum AdxError.Reason
    3. + type DomainInfoExtension
    4. + type InAppLinkExtension
    5. type AdExtensionOverrideReturnValue
      1. + field partialFailureErrors
    6. type AdxError
      1. + field reason
    7. type Stats
      1. field avgCallDurationSecs
      2. field avgCostForOfflineInteraction
      3. field callDurationSecs
      4. field conversionRate
      5. field conversionRateManyPerClick
      6. field conversionsManyPerClick
      7. field costPerConversion
      8. field costPerConversionManyPerClick
      9. field invalidClickRate
      10. field invalidClicks
      11. field numCalls
      12. field numMissedCalls
      13. field numOfflineImpressions
      14. field numOfflineInteractions
      15. field numReceivedCalls
      16. field offlineInteractionCost
      17. field offlineInteractionRate
      18. field totalConvValue
      19. field valuePerConv
      20. field valuePerConvManyPerClick
  4. AdGroupAdService (9 new, 12 changed, 0 removed)
    1. + type AdxError
    2. + enum AdxError.Reason
    3. + type BetaError
    4. + enum BetaError.Reason
    5. + type DynamicSearchAd
    6. + type QueryError
    7. + enum QueryError.Reason
    8. + enum RichMediaAd.RichMediaAdType
    9. + operation query
    10. type Ad
      1. field approvalStatus
      2. field trademarkDisapproved
    11. enum AdError.Reason
      1. + value INVALID_DSA_URL_TAG
      2. + value MISSING_DESTINATION_URL_TAG
      3. + value URL_SCHEME_BEFORE_DSA_TAG
    12. type AdGroupAd
      1. + field approvalStatus
      2. + field trademarkDisapproved
    13. type AdxError
      1. + field reason
    14. type BetaError
      1. + field reason
    15. enum MediaError.Reason
      1. + value MEDIA_NOT_TRANSCODED
    16. type QueryError
      1. + field reason
    17. type RichMediaAd
      1. + field adDuration
      2. + field richMediaAdType
      3. + field sourceUrl
    18. enum SelectorError.Reason
      1. + value FILTER_BY_DATE_RANGE_NOT_SUPPORTED
    19. type Stats
      1. field avgCallDurationSecs
      2. field avgCostForOfflineInteraction
      3. field callDurationSecs
      4. field conversionRate
      5. field conversionRateManyPerClick
      6. field conversionsManyPerClick
      7. field costPerConversion
      8. field costPerConversionManyPerClick
      9. field invalidClickRate
      10. field invalidClicks
      11. field numCalls
      12. field numMissedCalls
      13. field numOfflineImpressions
      14. field numOfflineInteractions
      15. field numReceivedCalls
      16. field offlineInteractionCost
      17. field offlineInteractionRate
      18. field totalConvValue
      19. field valuePerConv
      20. field valuePerConvManyPerClick
    20. enum TemplateElementField.Type
      1. + value UNKNOWN
    21. operation query
      1. + parameter query
      2. + response rval
  5. AdGroupCriterionService (6 new, 10 changed, 0 removed)
    1. + type AdxError
    2. + enum AdxError.Reason
    3. + type QueryError
    4. + enum QueryError.Reason
    5. + type Webpage
    6. + operation query
    7. enum AdGroupCriterionError.Reason
      1. + value MISSING_DESTINATION_URL_TAG
    8. type AdxError
      1. + field reason
    9. type BiddableAdGroupCriterion
      1. + field disapprovalReasons
    10. enum Criterion.Type
      1. + value WEBPAGE
      2. + value MOBILE_DEVICE
      3. + value AD_SCHEDULE
    11. enum CriterionError.Reason
      1. + value YOUTUBE_VERTICAL_CHANNEL_DEPRECATED
      2. + value YOUTUBE_DEMOGRAPHIC_CHANNEL_DEPRECATED
      3. + value AD_SCHEDULE_TIME_INTERVALS_OVERLAP
      4. + value AD_SCHEDULE_INTERVAL_CANNOT_SPAN_MULTIPLE_DAYS
      5. + value AD_SCHEDULE_INVALID_TIME_INTERVAL
      6. + value AD_SCHEDULE_EXCEEDED_INTERVALS_PER_DAY_LIMIT
      7. + value AD_SCHEDULE_CRITERION_ID_MISMATCHING_FIELDS
      8. + value CANNOT_BID_MODIFY_CRITERION_TYPE
      9. + value CANNOT_BID_MODIFY_NEGATIVE_CRITERION
      10. + value ACCOUNT_INELIGIBLE_FOR_CRITERIA_TYPE
      11. + value CRITERIA_TYPE_INVALID_FOR_BIDDING_STRATEGY
    12. type QueryError
      1. + field reason
    13. enum SelectorError.Reason
      1. + value FILTER_BY_DATE_RANGE_NOT_SUPPORTED
    14. type Stats
      1. field avgCallDurationSecs
      2. field avgCostForOfflineInteraction
      3. field callDurationSecs
      4. field conversionRate
      5. field conversionRateManyPerClick
      6. field conversionsManyPerClick
      7. field costPerConversion
      8. field costPerConversionManyPerClick
      9. field invalidClickRate
      10. field invalidClicks
      11. field numCalls
      12. field numMissedCalls
      13. field numOfflineImpressions
      14. field numOfflineInteractions
      15. field numReceivedCalls
      16. field offlineInteractionCost
      17. field offlineInteractionRate
      18. field totalConvValue
      19. field valuePerConv
      20. field valuePerConvManyPerClick
    15. type Vertical
      1. + field verticalId
      2. + field verticalParentId
    16. operation query
      1. + parameter query
      2. + response rval
  6. AdGroupService (11 new, 13 changed, 0 removed)
    1. + type AdxError
    2. + enum AdxError.Reason
    3. + enum CriterionTypeGroup
    4. + type EntityCountLimitExceeded
    5. + enum EntityCountLimitExceeded.Reason
    6. + type QueryError
    7. + enum QueryError.Reason
    8. + type SettingError
    9. + enum SettingError.Reason
    10. + type TargetingSetting
    11. + operation query
    12. type AdGroup
      1. + field forwardCompatibilityMap
      2. + field settings
    13. type AdGroupReturnValue
      1. + field partialFailureErrors
    14. type AdxError
      1. + field reason
    15. type BudgetOptimizerAdGroupBids
      1. field proxySiteMaxCpc
    16. type EntityCountLimitExceeded
      1. + field reason
    17. type ManualCPCAdGroupBids
      1. field siteMaxCpc
    18. type QueryError
      1. + field reason
    19. enum SelectorError.Reason
      1. + value FILTER_BY_DATE_RANGE_NOT_SUPPORTED
    20. type SettingError
      1. + field reason
    21. enum SettingError.Reason
      1. + value TARGETING_SETTING_REQUIRES_CAMPAIGN_TARGET_RESTRICT_SETTING
      2. + value TARGET_RESTRICT_SETTING_CANNOT_BE_REVERSED
      3. + value TARGETING_SETTING_CONTAINS_INVALID_CRITERION_TYPE_GROUP
    22. type Stats
      1. field avgCallDurationSecs
      2. field avgCostForOfflineInteraction
      3. field callDurationSecs
      4. field conversionRate
      5. field conversionRateManyPerClick
      6. field conversionsManyPerClick
      7. field costPerConversion
      8. field costPerConversionManyPerClick
      9. field invalidClickRate
      10. field invalidClicks
      11. field numCalls
      12. field numMissedCalls
      13. field numOfflineImpressions
      14. field numOfflineInteractions
      15. field numReceivedCalls
      16. field offlineInteractionCost
      17. field offlineInteractionRate
      18. field totalConvValue
      19. field valuePerConv
      20. field valuePerConvManyPerClick
    23. type TargetingSettingDetail
      1. + field criterionTypeGroup
    24. operation query
      1. + parameter query
      2. + response rval
  7. AdParamService (2 new, 2 changed, 0 removed)
    1. + type AdxError
    2. + enum AdxError.Reason
    3. type AdxError
      1. + field reason
    4. enum SelectorError.Reason
      1. + value FILTER_BY_DATE_RANGE_NOT_SUPPORTED
  8. = AlertService (no changes)
  9. BudgetOrderService (0 new, 1 changed, 0 removed)
    1. enum SelectorError.Reason
      1. + value FILTER_BY_DATE_RANGE_NOT_SUPPORTED
  10. BulkMutateJobService (16 new, 36 changed, 0 removed)
    1. + type AdSchedule
    2. + type AdxError
    3. + enum AdxError.Reason
    4. + enum CriterionTypeGroup
    5. + type DomainInfoExtension
    6. + type DynamicSearchAd
    7. + type InAppLinkExtension
    8. + type MobileDevice
    9. + enum MobileDevice.DeviceType
    10. + type QueryError
    11. + enum QueryError.Reason
    12. + enum RichMediaAd.RichMediaAdType
    13. + type TargetRestrictSetting
    14. + type TargetingSetting
    15. + type UnknownBiddingStrategy
    16. + type Webpage
    17. type Ad
      1. field approvalStatus
      2. field trademarkDisapproved
    18. enum AdError.Reason
      1. + value INVALID_DSA_URL_TAG
      2. + value MISSING_DESTINATION_URL_TAG
      3. + value URL_SCHEME_BEFORE_DSA_TAG
    19. enum AdExtensionError.Reason
      1. + value CANNOT_HAVE_MULTIPLE_IN_APP_LINK_EXTENSIONS_PER_CAMPAIGN_PER_APPSTORE
    20. type AdGroup
      1. + field forwardCompatibilityMap
      2. + field settings
    21. type AdGroupAd
      1. + field approvalStatus
      2. + field trademarkDisapproved
    22. enum AdGroupCriterionError.Reason
      1. + value MISSING_DESTINATION_URL_TAG
    23. enum AdServingOptimizationStatus
      1. + value CONVERSION_OPTIMIZE
    24. type AdxError
      1. + field reason
    25. type BiddableAdGroupCriterion
      1. + field disapprovalReasons
    26. type BiddingTransition
      1. field explicitAdGroupBids
    27. enum Budget.BudgetPeriod
      1. value MONTHLY
    28. enum BudgetError.Reason
      1. value MONEY_AMOUNT_LESS_THAN_MAXIMUM_AD_GROUP_CPM
      2. value MONEY_AMOUNT_LESS_THAN_MAXIMUM_SITE_CPM
      3. value MONEY_AMOUNT_LESS_THAN_MINIMUM_AD_GROUP_CPC
      4. value MONEY_AMOUNT_LESS_THAN_MINIMUM_CRITERIA_CPC
    29. type BudgetOptimizerAdGroupBids
      1. field proxySiteMaxCpc
    30. enum BulkMutateJobError.Reason
      1. + value SERVICE_PROVIDED_NO_RESULT
      2. value TOO_FEW_OPERATIONS_IN_JOB
    31. type BulkMutateJobSelector
      1. field jobStatuses
    32. type Campaign
      1. + field forwardCompatibilityMap
    33. type CampaignCriterion
      1. + field bidModifier
    34. enum CampaignCriterionError.Reason
      1. + value LICENSED_USERLISTS_NOT_ALLOWED
      2. + value CANNOT_TARGET_AND_EXCLUDE
      3. + value OPERATOR_NOT_SUPPORTED_FOR_CRITERION_TYPE
    35. enum CampaignError.Reason
      1. + value MUST_SPECIFY_KEYWORD_MATCH_SETTINGS
      2. value FREQUENCY_CAP_TIME_UNIT_CANNOT_BE_NULL
      3. value FREQUENCY_CAP_LEVEL_CANNOT_BE_NULL
    36. enum Criterion.Type
      1. + value WEBPAGE
      2. + value MOBILE_DEVICE
      3. + value AD_SCHEDULE
    37. enum CriterionError.Reason
      1. + value YOUTUBE_VERTICAL_CHANNEL_DEPRECATED
      2. + value YOUTUBE_DEMOGRAPHIC_CHANNEL_DEPRECATED
      3. + value AD_SCHEDULE_TIME_INTERVALS_OVERLAP
      4. + value AD_SCHEDULE_INTERVAL_CANNOT_SPAN_MULTIPLE_DAYS
      5. + value AD_SCHEDULE_INVALID_TIME_INTERVAL
      6. + value AD_SCHEDULE_EXCEEDED_INTERVALS_PER_DAY_LIMIT
      7. + value AD_SCHEDULE_CRITERION_ID_MISMATCHING_FIELDS
      8. + value CANNOT_BID_MODIFY_CRITERION_TYPE
      9. + value CANNOT_BID_MODIFY_NEGATIVE_CRITERION
      10. + value ACCOUNT_INELIGIBLE_FOR_CRITERIA_TYPE
      11. + value CRITERIA_TYPE_INVALID_FOR_BIDDING_STRATEGY
    38. type Job
      1. field customerJobKey
    39. type Location
      1. + field targetingStatus
      2. field isObsolete
    40. type ManualCPCAdGroupBids
      1. field siteMaxCpc
    41. enum MediaError.Reason
      1. + value MEDIA_NOT_TRANSCODED
    42. type MobileDevice
      1. + field deviceType
    43. type OperatingSystemVersion
      1. + field name
      2. + field operatorType
      3. + field osMajorVersion
      4. + field osMinorVersion
    44. type QueryError
      1. + field reason
    45. type RichMediaAd
      1. + field adDuration
      2. + field richMediaAdType
      3. + field sourceUrl
    46. enum SelectorError.Reason
      1. + value FILTER_BY_DATE_RANGE_NOT_SUPPORTED
    47. enum SettingError.Reason
      1. + value TARGETING_SETTING_REQUIRES_CAMPAIGN_TARGET_RESTRICT_SETTING
      2. + value TARGET_RESTRICT_SETTING_CANNOT_BE_REVERSED
      3. + value TARGETING_SETTING_CONTAINS_INVALID_CRITERION_TYPE_GROUP
    48. type Stats
      1. field avgCallDurationSecs
      2. field avgCostForOfflineInteraction
      3. field callDurationSecs
      4. field conversionRate
      5. field conversionRateManyPerClick
      6. field conversionsManyPerClick
      7. field costPerConversion
      8. field costPerConversionManyPerClick
      9. field invalidClickRate
      10. field invalidClicks
      11. field numCalls
      12. field numMissedCalls
      13. field numOfflineImpressions
      14. field numOfflineInteractions
      15. field numReceivedCalls
      16. field offlineInteractionCost
      17. field offlineInteractionRate
      18. field totalConvValue
      19. field valuePerConv
      20. field valuePerConvManyPerClick
    49. enum TargetError.Reason
      1. + value CANNOT_MODIFY_CONTENT_CONTEXTUAL
      2. value TARGET_IS_ENCLOSED_BY_ANOTHER_TARGET
      3. value TARGET_IS_EXCLUDED_BY_ANOTHER_TARGET
    50. type TargetingSettingDetail
      1. + field criterionTypeGroup
    51. enum TemplateElementField.Type
      1. + value UNKNOWN
    52. type Vertical
      1. + field verticalId
      2. + field verticalParentId
  11. CampaignAdExtensionService (6 new, 6 changed, 0 removed)
    1. + type AdxError
    2. + enum AdxError.Reason
    3. + type DomainInfoExtension
    4. + type EntityCountLimitExceeded
    5. + enum EntityCountLimitExceeded.Reason
    6. + type InAppLinkExtension
    7. enum AdExtensionError.Reason
      1. + value CANNOT_HAVE_MULTIPLE_IN_APP_LINK_EXTENSIONS_PER_CAMPAIGN_PER_APPSTORE
    8. type AdxError
      1. + field reason
    9. type CampaignAdExtensionReturnValue
      1. + field partialFailureErrors
    10. type EntityCountLimitExceeded
      1. + field reason
    11. enum SelectorError.Reason
      1. + value FILTER_BY_DATE_RANGE_NOT_SUPPORTED
    12. type Stats
      1. field avgCallDurationSecs
      2. field avgCostForOfflineInteraction
      3. field callDurationSecs
      4. field conversionRate
      5. field conversionRateManyPerClick
      6. field conversionsManyPerClick
      7. field costPerConversion
      8. field costPerConversionManyPerClick
      9. field invalidClickRate
      10. field invalidClicks
      11. field numCalls
      12. field numMissedCalls
      13. field numOfflineImpressions
      14. field numOfflineInteractions
      15. field numReceivedCalls
      16. field offlineInteractionCost
      17. field offlineInteractionRate
      18. field totalConvValue
      19. field valuePerConv
      20. field valuePerConvManyPerClick
  12. CampaignCriterionService (11 new, 14 changed, 0 removed)
    1. + type AdSchedule
    2. + type AdxError
    3. + enum AdxError.Reason
    4. + enum DayOfWeek
    5. + enum MinuteOfHour
    6. + type MobileDevice
    7. + enum MobileDevice.DeviceType
    8. + type QueryError
    9. + enum QueryError.Reason
    10. + type Webpage
    11. + operation query
    12. type AdSchedule
      1. + field dayOfWeek
      2. + field endMinute
      3. + field startMinute
    13. type AdxError
      1. + field reason
    14. type CampaignCriterion
      1. + field bidModifier
    15. enum CampaignCriterionError.Reason
      1. + value LICENSED_USERLISTS_NOT_ALLOWED
      2. + value CANNOT_TARGET_AND_EXCLUDE
      3. + value OPERATOR_NOT_SUPPORTED_FOR_CRITERION_TYPE
    16. type CampaignCriterionReturnValue
      1. + field partialFailureErrors
    17. enum Criterion.Type
      1. + value WEBPAGE
      2. + value MOBILE_DEVICE
      3. + value AD_SCHEDULE
    18. enum CriterionError.Reason
      1. + value YOUTUBE_VERTICAL_CHANNEL_DEPRECATED
      2. + value YOUTUBE_DEMOGRAPHIC_CHANNEL_DEPRECATED
      3. + value AD_SCHEDULE_TIME_INTERVALS_OVERLAP
      4. + value AD_SCHEDULE_INTERVAL_CANNOT_SPAN_MULTIPLE_DAYS
      5. + value AD_SCHEDULE_INVALID_TIME_INTERVAL
      6. + value AD_SCHEDULE_EXCEEDED_INTERVALS_PER_DAY_LIMIT
      7. + value AD_SCHEDULE_CRITERION_ID_MISMATCHING_FIELDS
      8. + value CANNOT_BID_MODIFY_CRITERION_TYPE
      9. + value CANNOT_BID_MODIFY_NEGATIVE_CRITERION
      10. + value ACCOUNT_INELIGIBLE_FOR_CRITERIA_TYPE
      11. + value CRITERIA_TYPE_INVALID_FOR_BIDDING_STRATEGY
    19. type Location
      1. + field targetingStatus
      2. field isObsolete
    20. type MobileDevice
      1. + field deviceType
    21. type OperatingSystemVersion
      1. + field name
      2. + field operatorType
      3. + field osMajorVersion
      4. + field osMinorVersion
    22. type QueryError
      1. + field reason
    23. enum SelectorError.Reason
      1. + value FILTER_BY_DATE_RANGE_NOT_SUPPORTED
    24. type Vertical
      1. + field verticalId
      2. + field verticalParentId
    25. operation query
      1. + parameter query
      2. + response rval
  13. CampaignService (10 new, 18 changed, 0 removed)
    1. + type AdxError
    2. + enum AdxError.Reason
    3. + enum CriterionTypeGroup
    4. + type EntityCountLimitExceeded
    5. + enum EntityCountLimitExceeded.Reason
    6. + type QueryError
    7. + enum QueryError.Reason
    8. + type TargetRestrictSetting
    9. + type UnknownBiddingStrategy
    10. + operation query
    11. enum AdServingOptimizationStatus
      1. + value CONVERSION_OPTIMIZE
    12. type AdxError
      1. + field reason
    13. type BiddingTransition
      1. field explicitAdGroupBids
    14. enum Budget.BudgetPeriod
      1. value MONTHLY
    15. enum BudgetError.Reason
      1. value MONEY_AMOUNT_LESS_THAN_MAXIMUM_AD_GROUP_CPM
      2. value MONEY_AMOUNT_LESS_THAN_MAXIMUM_SITE_CPM
      3. value MONEY_AMOUNT_LESS_THAN_MINIMUM_AD_GROUP_CPC
      4. value MONEY_AMOUNT_LESS_THAN_MINIMUM_CRITERIA_CPC
    16. type BudgetOptimizerAdGroupBids
      1. field proxySiteMaxCpc
    17. type Campaign
      1. + field forwardCompatibilityMap
    18. enum CampaignError.Reason
      1. + value MUST_SPECIFY_KEYWORD_MATCH_SETTINGS
      2. value FREQUENCY_CAP_TIME_UNIT_CANNOT_BE_NULL
      3. value FREQUENCY_CAP_LEVEL_CANNOT_BE_NULL
    19. type CampaignReturnValue
      1. + field partialFailureErrors
    20. type EntityCountLimitExceeded
      1. + field reason
    21. type ManualCPCAdGroupBids
      1. field siteMaxCpc
    22. type QueryError
      1. + field reason
    23. enum SelectorError.Reason
      1. + value FILTER_BY_DATE_RANGE_NOT_SUPPORTED
    24. enum SettingError.Reason
      1. + value TARGETING_SETTING_REQUIRES_CAMPAIGN_TARGET_RESTRICT_SETTING
      2. + value TARGET_RESTRICT_SETTING_CANNOT_BE_REVERSED
      3. + value TARGETING_SETTING_CONTAINS_INVALID_CRITERION_TYPE_GROUP
    25. type Stats
      1. field avgCallDurationSecs
      2. field avgCostForOfflineInteraction
      3. field callDurationSecs
      4. field conversionRate
      5. field conversionRateManyPerClick
      6. field conversionsManyPerClick
      7. field costPerConversion
      8. field costPerConversionManyPerClick
      9. field invalidClickRate
      10. field invalidClicks
      11. field numCalls
      12. field numMissedCalls
      13. field numOfflineImpressions
      14. field numOfflineInteractions
      15. field numReceivedCalls
      16. field offlineInteractionCost
      17. field offlineInteractionRate
      18. field totalConvValue
      19. field valuePerConv
      20. field valuePerConvManyPerClick
    26. enum TargetError.Reason
      1. + value CANNOT_MODIFY_CONTENT_CONTEXTUAL
      2. value TARGET_IS_ENCLOSED_BY_ANOTHER_TARGET
      3. value TARGET_IS_EXCLUDED_BY_ANOTHER_TARGET
    27. type TargetingSettingDetail
      1. + field criterionTypeGroup
    28. operation query
      1. + parameter query
      2. + response rval
  14. ConstantDataService (13 new, 12 changed, 0 removed)
    1. + type AdxError
    2. + enum AdxError.Reason
    3. + type AgeRange
    4. + type BetaError
    5. + enum BetaError.Reason
    6. + type Gender
    7. + type MobileDevice
    8. + operation getAgeRangeCriterion
    9. + operation getGenderCriterion
    10. + operation getMobileDeviceCriterion
    11. + operation getOperatingSystemVersionCriterion
    12. + operation getUserInterestCriterion
    13. + operation getVerticalCriterion
    14. type AdxError
      1. + field reason
    15. type BetaError
      1. + field reason
    16. enum Criterion.Type
      1. + value WEBPAGE
      2. + value MOBILE_DEVICE
      3. + value AD_SCHEDULE
    17. type OperatingSystemVersion
      1. + field name
      2. + field operatorType
      3. + field osMajorVersion
      4. + field osMinorVersion
    18. enum SelectorError.Reason
      1. + value FILTER_BY_DATE_RANGE_NOT_SUPPORTED
    19. type Vertical
      1. + field verticalId
      2. + field verticalParentId
    20. operation getAgeRangeCriterion
      1. + response rval
    21. operation getGenderCriterion
      1. + response rval
    22. operation getMobileDeviceCriterion
      1. + response rval
    23. operation getOperatingSystemVersionCriterion
      1. + response rval
    24. operation getUserInterestCriterion
      1. + response rval
    25. operation getVerticalCriterion
      1. + response rval
  15. ConversionTrackerService (2 new, 4 changed, 0 removed)
    1. + type OperationAccessDenied
    2. + enum OperationAccessDenied.Reason
    3. type AdWordsConversionTracker
      1. + field trackingCodeType
    4. enum ConversionTrackingError.Reason
      1. + value CANNOT_CHANGE_APP_CONVERSION_TYPE
      2. + value CANNOT_CHANGE_APP_PLATFORM
      3. + value DUPLICATE_APP_ID
      4. + value INVALID_APP_ID
      5. + value MUST_SET_APP_PLATFORM_AND_APP_CONVERSION_TYPE_TOGETHER
    5. type OperationAccessDenied
      1. + field reason
    6. enum SelectorError.Reason
      1. + value FILTER_BY_DATE_RANGE_NOT_SUPPORTED
  16. = CustomerService (no changes)
  17. = CustomerSyncService (no changes)
  18. DataService (2 new, 2 changed, 0 removed)
    1. + type AdxError
    2. + enum AdxError.Reason
    3. type AdxError
      1. + field reason
    4. enum SelectorError.Reason
      1. + value FILTER_BY_DATE_RANGE_NOT_SUPPORTED
  19. ExperimentService (2 new, 3 changed, 0 removed)
    1. + type AdxError
    2. + enum AdxError.Reason
    3. type AdxError
      1. + field reason
    4. enum BudgetError.Reason
      1. value MONEY_AMOUNT_LESS_THAN_MAXIMUM_AD_GROUP_CPM
      2. value MONEY_AMOUNT_LESS_THAN_MAXIMUM_SITE_CPM
      3. value MONEY_AMOUNT_LESS_THAN_MINIMUM_AD_GROUP_CPC
      4. value MONEY_AMOUNT_LESS_THAN_MINIMUM_CRITERIA_CPC
    5. enum SelectorError.Reason
      1. + value FILTER_BY_DATE_RANGE_NOT_SUPPORTED
  20. = GeoLocationService (no changes)
  21. = InfoService (no changes)
  22. LocationCriterionService (2 new, 6 changed, 0 removed)
    1. + type AdxError
    2. + enum AdxError.Reason
    3. type AdxError
      1. + field reason
    4. enum Criterion.Type
      1. + value WEBPAGE
      2. + value MOBILE_DEVICE
      3. + value AD_SCHEDULE
    5. type Location
      1. + field targetingStatus
      2. field isObsolete
    6. type LocationCriterion
      1. + field countryCode
    7. enum LocationCriterionServiceError.Reason
      1. + value INVALID_COUNTRY_CODE
    8. enum SelectorError.Reason
      1. + value FILTER_BY_DATE_RANGE_NOT_SUPPORTED
  23. ManagedCustomerService (0 new, 1 changed, 0 removed)
    1. enum SelectorError.Reason
      1. + value FILTER_BY_DATE_RANGE_NOT_SUPPORTED
  24. MediaService (0 new, 2 changed, 0 removed)
    1. enum MediaError.Reason
      1. + value MEDIA_NOT_TRANSCODED
    2. enum SelectorError.Reason
      1. + value FILTER_BY_DATE_RANGE_NOT_SUPPORTED
  25. MutateJobService (16 new, 36 changed, 0 removed)
    1. + type AdSchedule
    2. + type AdxError
    3. + enum AdxError.Reason
    4. + enum CriterionTypeGroup
    5. + type DomainInfoExtension
    6. + type DynamicSearchAd
    7. + type InAppLinkExtension
    8. + type MobileDevice
    9. + enum MobileDevice.DeviceType
    10. + type QueryError
    11. + enum QueryError.Reason
    12. + enum RichMediaAd.RichMediaAdType
    13. + type TargetRestrictSetting
    14. + type TargetingSetting
    15. + type UnknownBiddingStrategy
    16. + type Webpage
    17. type Ad
      1. field approvalStatus
      2. field trademarkDisapproved
    18. enum AdError.Reason
      1. + value INVALID_DSA_URL_TAG
      2. + value MISSING_DESTINATION_URL_TAG
      3. + value URL_SCHEME_BEFORE_DSA_TAG
    19. enum AdExtensionError.Reason
      1. + value CANNOT_HAVE_MULTIPLE_IN_APP_LINK_EXTENSIONS_PER_CAMPAIGN_PER_APPSTORE
    20. type AdGroup
      1. + field forwardCompatibilityMap
      2. + field settings
    21. type AdGroupAd
      1. + field approvalStatus
      2. + field trademarkDisapproved
    22. enum AdGroupCriterionError.Reason
      1. + value MISSING_DESTINATION_URL_TAG
    23. enum AdServingOptimizationStatus
      1. + value CONVERSION_OPTIMIZE
    24. type AdxError
      1. + field reason
    25. type BiddableAdGroupCriterion
      1. + field disapprovalReasons
    26. type BiddingTransition
      1. field explicitAdGroupBids
    27. enum Budget.BudgetPeriod
      1. value MONTHLY
    28. enum BudgetError.Reason
      1. value MONEY_AMOUNT_LESS_THAN_MAXIMUM_AD_GROUP_CPM
      2. value MONEY_AMOUNT_LESS_THAN_MAXIMUM_SITE_CPM
      3. value MONEY_AMOUNT_LESS_THAN_MINIMUM_AD_GROUP_CPC
      4. value MONEY_AMOUNT_LESS_THAN_MINIMUM_CRITERIA_CPC
    29. type BudgetOptimizerAdGroupBids
      1. field proxySiteMaxCpc
    30. enum BulkMutateJobError.Reason
      1. + value SERVICE_PROVIDED_NO_RESULT
      2. value TOO_FEW_OPERATIONS_IN_JOB
    31. type BulkMutateJobSelector
      1. field jobStatuses
    32. type Campaign
      1. + field forwardCompatibilityMap
    33. type CampaignCriterion
      1. + field bidModifier
    34. enum CampaignCriterionError.Reason
      1. + value LICENSED_USERLISTS_NOT_ALLOWED
      2. + value CANNOT_TARGET_AND_EXCLUDE
      3. + value OPERATOR_NOT_SUPPORTED_FOR_CRITERION_TYPE
    35. enum CampaignError.Reason
      1. + value MUST_SPECIFY_KEYWORD_MATCH_SETTINGS
      2. value FREQUENCY_CAP_TIME_UNIT_CANNOT_BE_NULL
      3. value FREQUENCY_CAP_LEVEL_CANNOT_BE_NULL
    36. enum Criterion.Type
      1. + value WEBPAGE
      2. + value MOBILE_DEVICE
      3. + value AD_SCHEDULE
    37. enum CriterionError.Reason
      1. + value YOUTUBE_VERTICAL_CHANNEL_DEPRECATED
      2. + value YOUTUBE_DEMOGRAPHIC_CHANNEL_DEPRECATED
      3. + value AD_SCHEDULE_TIME_INTERVALS_OVERLAP
      4. + value AD_SCHEDULE_INTERVAL_CANNOT_SPAN_MULTIPLE_DAYS
      5. + value AD_SCHEDULE_INVALID_TIME_INTERVAL
      6. + value AD_SCHEDULE_EXCEEDED_INTERVALS_PER_DAY_LIMIT
      7. + value AD_SCHEDULE_CRITERION_ID_MISMATCHING_FIELDS
      8. + value CANNOT_BID_MODIFY_CRITERION_TYPE
      9. + value CANNOT_BID_MODIFY_NEGATIVE_CRITERION
      10. + value ACCOUNT_INELIGIBLE_FOR_CRITERIA_TYPE
      11. + value CRITERIA_TYPE_INVALID_FOR_BIDDING_STRATEGY
    38. type Job
      1. field customerJobKey
    39. type Location
      1. + field targetingStatus
      2. field isObsolete
    40. type ManualCPCAdGroupBids
      1. field siteMaxCpc
    41. enum MediaError.Reason
      1. + value MEDIA_NOT_TRANSCODED
    42. type MobileDevice
      1. + field deviceType
    43. type OperatingSystemVersion
      1. + field name
      2. + field operatorType
      3. + field osMajorVersion
      4. + field osMinorVersion
    44. type QueryError
      1. + field reason
    45. type RichMediaAd
      1. + field adDuration
      2. + field richMediaAdType
      3. + field sourceUrl
    46. enum SelectorError.Reason
      1. + value FILTER_BY_DATE_RANGE_NOT_SUPPORTED
    47. enum SettingError.Reason
      1. + value TARGETING_SETTING_REQUIRES_CAMPAIGN_TARGET_RESTRICT_SETTING
      2. + value TARGET_RESTRICT_SETTING_CANNOT_BE_REVERSED
      3. + value TARGETING_SETTING_CONTAINS_INVALID_CRITERION_TYPE_GROUP
    48. type Stats
      1. field avgCallDurationSecs
      2. field avgCostForOfflineInteraction
      3. field callDurationSecs
      4. field conversionRate
      5. field conversionRateManyPerClick
      6. field conversionsManyPerClick
      7. field costPerConversion
      8. field costPerConversionManyPerClick
      9. field invalidClickRate
      10. field invalidClicks
      11. field numCalls
      12. field numMissedCalls
      13. field numOfflineImpressions
      14. field numOfflineInteractions
      15. field numReceivedCalls
      16. field offlineInteractionCost
      17. field offlineInteractionRate
      18. field totalConvValue
      19. field valuePerConv
      20. field valuePerConvManyPerClick
    49. enum TargetError.Reason
      1. + value CANNOT_MODIFY_CONTENT_CONTEXTUAL
      2. value TARGET_IS_ENCLOSED_BY_ANOTHER_TARGET
      3. value TARGET_IS_EXCLUDED_BY_ANOTHER_TARGET
    50. type TargetingSettingDetail
      1. + field criterionTypeGroup
    51. enum TemplateElementField.Type
      1. + value UNKNOWN
    52. type Vertical
      1. + field verticalId
      2. + field verticalParentId
  26. ReportDefinitionService (0 new, 5 changed, 1 removed)
    1. type ReportDefinition
      1. field creationTime
      2. field hasAttachment
    2. enum ReportDefinition.ReportType
      1. + value ACCOUNT_REACH_FREQUENCY_REPORT
      2. + value CAMPAIGN_REACH_FREQUENCY_REPORT
      3. + value ADGROUP_REACH_FREQUENCY_REPORT
      4. + value CLICK_PERFORMANCE_REPORT
    3. enum ReportDefinitionError.Reason
      1. + value INVALID_DATE_RANGE_FOR_REPORT
    4. enum SelectorError.Reason
      1. + value FILTER_BY_DATE_RANGE_NOT_SUPPORTED
    5. operation get
      1. response rval
      2. parameter selector
    6. operation get
  27. TargetingIdeaService (4 new, 9 changed, 6 removed)
    1. + type AdSpecListAttribute
    2. + type AdSpecListSearchParameter
    3. + type RelatedToQuerySearchParameter
    4. + type Webpage
    5. enum AdGroupCriterionError.Reason
      1. + value MISSING_DESTINATION_URL_TAG
    6. enum AttributeType
      1. + value AD_TYPE_SPEC
      2. + value KEYWORD_TEXT
      3. + value SEARCH_VOLUME
      4. value AVERAGE_TARGETED_MONTHLY_SEARCHES
      5. value FORMATS
      6. value GLOBAL_MONTHLY_SEARCHES
    7. enum BudgetError.Reason
      1. value MONEY_AMOUNT_LESS_THAN_MAXIMUM_AD_GROUP_CPM
      2. value MONEY_AMOUNT_LESS_THAN_MAXIMUM_SITE_CPM
      3. value MONEY_AMOUNT_LESS_THAN_MINIMUM_AD_GROUP_CPC
      4. value MONEY_AMOUNT_LESS_THAN_MINIMUM_CRITERIA_CPC
    8. enum Criterion.Type
      1. + value WEBPAGE
      2. + value MOBILE_DEVICE
      3. + value AD_SCHEDULE
    9. enum CriterionError.Reason
      1. + value YOUTUBE_VERTICAL_CHANNEL_DEPRECATED
      2. + value YOUTUBE_DEMOGRAPHIC_CHANNEL_DEPRECATED
      3. + value AD_SCHEDULE_TIME_INTERVALS_OVERLAP
      4. + value AD_SCHEDULE_INTERVAL_CANNOT_SPAN_MULTIPLE_DAYS
      5. + value AD_SCHEDULE_INVALID_TIME_INTERVAL
      6. + value AD_SCHEDULE_EXCEEDED_INTERVALS_PER_DAY_LIMIT
      7. + value AD_SCHEDULE_CRITERION_ID_MISMATCHING_FIELDS
      8. + value CANNOT_BID_MODIFY_CRITERION_TYPE
      9. + value CANNOT_BID_MODIFY_NEGATIVE_CRITERION
      10. + value ACCOUNT_INELIGIBLE_FOR_CRITERIA_TYPE
      11. + value CRITERIA_TYPE_INVALID_FOR_BIDDING_STRATEGY
    10. type Location
      1. + field targetingStatus
      2. field isObsolete
    11. enum TargetError.Reason
      1. + value CANNOT_MODIFY_CONTENT_CONTEXTUAL
      2. value TARGET_IS_ENCLOSED_BY_ANOTHER_TARGET
      3. value TARGET_IS_EXCLUDED_BY_ANOTHER_TARGET
    12. enum TrafficEstimatorError.Reason
      1. + value KEYWORD_TOO_LONG
      2. + value KEYWORD_CONTAINS_BROAD_MATCH_MODIFIERS
    13. type Vertical
      1. + field verticalId
      2. + field verticalParentId
    14. type AdTypeSearchParameter
    15. type AverageTargetedMonthlySearchesSearchParameter
    16. type GlobalMonthlySearchesSearchParameter
    17. type KeywordMatchTypeSearchParameter
    18. type RelatedToKeywordSearchParameter
    19. enum SiteConstants.AdType
  28. TrafficEstimatorService (4 new, 7 changed, 0 removed)
    1. + type AdSchedule
    2. + type MobileDevice
    3. + enum MobileDevice.DeviceType
    4. + type Webpage
    5. enum Criterion.Type
      1. + value WEBPAGE
      2. + value MOBILE_DEVICE
      3. + value AD_SCHEDULE
    6. type Location
      1. + field targetingStatus
      2. field isObsolete
    7. type MobileDevice
      1. + field deviceType
    8. type OperatingSystemVersion
      1. + field name
      2. + field operatorType
      3. + field osMajorVersion
      4. + field osMinorVersion
    9. enum TargetError.Reason
      1. + value CANNOT_MODIFY_CONTENT_CONTEXTUAL
      2. value TARGET_IS_ENCLOSED_BY_ANOTHER_TARGET
      3. value TARGET_IS_EXCLUDED_BY_ANOTHER_TARGET
    10. enum TrafficEstimatorError.Reason
      1. + value KEYWORD_TOO_LONG
      2. + value KEYWORD_CONTAINS_BROAD_MATCH_MODIFIERS
    11. type Vertical
      1. + field verticalId
      2. + field verticalParentId
  29. UserListService (0 new, 1 changed, 0 removed)
    1. enum SelectorError.Reason
      1. + value FILTER_BY_DATE_RANGE_NOT_SUPPORTED

v201109_1

What's New

Phrase and exact match keyword control
The API now allows for control over the new campaign keyword matching options.
TargetingIdeaService attribute CATEGORY_PRODUCTS_AND_SERVICES
The attribute CATEGORY_PRODUCTS_AND_SERVICES is now exposed in TargetingIdeaService.
Location sync extension
LocationSyncExtension now has OAuth support.
Expandable directions for display ads
Expandable ads are now supported through ThirdPartyRedirectAd.ExpandingDirection.
Beta program launch
The following features are being tested through the invitation-only beta launch:
  • Zip code targeting
    Geo targeting that supports US Postal codes (zip codes).
  • Bid-per-call
    Supporting bid-per-call through PhoneInteractionBid, CALL_METRIC_CALL_DETAILS_REPORT, and various OfflineInteraction fields in reports.
  • topOfPageCpc support
    Making available the new estimated CPC bid needed for your ad to appear above the first page of Google search results when a query matches keywords exactly. Note that meeting this estimate is no guarantee of ad position, which still depends on many other factors.
  • Promoted impressions in bid landscape
    Exposing BidLandscape's promotedImpressions which corresponds to the Estimated Top Impressions field in the Bid Simulator UI.

API Changes

  1. - CampaignTargetService
  2. + CustomerService
  3. + ManagedCustomerService
  4. AdExtensionOverrideService (0 new, 3 changed, 0 removed)
    1. type LocationSyncExtension
      1. + field oAuthInfo
    2. type MobileExtension
      1. + field isCallTrackingEnabled
    3. type Stats
      1. + field avgCostForOfflineInteraction
      2. + field numOfflineImpressions
      3. + field numOfflineInteractions
      4. + field offlineInteractionCost
      5. + field offlineInteractionRate
  5. AdGroupAdService (1 new, 5 changed, 0 removed)
    1. + enum ThirdPartyRedirectAd.ExpandingDirection
    2. enum AdError.Reason
      1. + value INVALID_CHARACTER_FOR_URL
      2. + value INCONSISTENT_EXPANDABLE_SETTINGS
      3. + value INVALID_FIELD_TEXT
    3. enum ImageError.Reason
      1. + value FLASH_WITHOUT_HARD_CODED_CLICK_URL
      2. + value INVALID_FLASH_FILE
      3. + value FAILED_TO_FIX_CLICK_TAG_IN_FLASH
      4. + value FLASH_ACCESSES_NETWORK_RESOURCES
      5. + value FLASH_EXTERNAL_JS_CALL
      6. + value FLASH_EXTERNAL_FS_CALL
    4. enum SelectorError.Reason
      1. + value START_INDEX_IS_TOO_HIGH
    5. type Stats
      1. + field avgCostForOfflineInteraction
      2. + field numOfflineImpressions
      3. + field numOfflineInteractions
      4. + field offlineInteractionCost
      5. + field offlineInteractionRate
    6. type ThirdPartyRedirectAd
      1. + field expandingDirections
  6. AdGroupCriterionService (2 new, 5 changed, 0 removed)
    1. + type BetaError
    2. + enum BetaError.Reason
    3. type BetaError
      1. + field reason
    4. type BiddableAdGroupCriterion
      1. + field topOfPageCpc
    5. enum CriterionError.Reason
      1. + value PROXIMITY_GEOPOINT_AND_ADDRESS_BOTH_CANNOT_BE_NULL
      2. + value INVALID_PROXIMITY_ADDRESS
    6. enum SelectorError.Reason
      1. + value START_INDEX_IS_TOO_HIGH
    7. type Stats
      1. + field avgCostForOfflineInteraction
      2. + field numOfflineImpressions
      3. + field numOfflineInteractions
      4. + field offlineInteractionCost
      5. + field offlineInteractionRate
  7. AdGroupService (4 new, 4 changed, 0 removed)
    1. + type BetaError
    2. + enum BetaError.Reason
    3. + type InteractionBid
    4. + type PhoneInteractionBid
    5. type AdGroupBids
      1. + field interactionBids
    6. type BetaError
      1. + field reason
    7. enum SelectorError.Reason
      1. + value START_INDEX_IS_TOO_HIGH
    8. type Stats
      1. + field avgCostForOfflineInteraction
      2. + field numOfflineImpressions
      3. + field numOfflineInteractions
      4. + field offlineInteractionCost
      5. + field offlineInteractionRate
  8. AdParamService (0 new, 1 changed, 0 removed)
    1. enum SelectorError.Reason
      1. + value START_INDEX_IS_TOO_HIGH
  9. = AlertService (no changes)
  10. BudgetOrderService (0 new, 1 changed, 0 removed)
    1. enum SelectorError.Reason
      1. + value START_INDEX_IS_TOO_HIGH
  11. BulkMutateJobService (6 new, 12 changed, 0 removed)
    1. + type BetaError
    2. + enum BetaError.Reason
    3. + type InteractionBid
    4. + type KeywordMatchSetting
    5. + type PhoneInteractionBid
    6. + enum ThirdPartyRedirectAd.ExpandingDirection
    7. enum AdError.Reason
      1. + value INVALID_CHARACTER_FOR_URL
      2. + value INCONSISTENT_EXPANDABLE_SETTINGS
      3. + value INVALID_FIELD_TEXT
    8. type AdGroupBids
      1. + field interactionBids
    9. type BetaError
      1. + field reason
    10. type BiddableAdGroupCriterion
      1. + field topOfPageCpc
    11. type CampaignCriterion
      1. + field isNegative
    12. enum CriterionError.Reason
      1. + value PROXIMITY_GEOPOINT_AND_ADDRESS_BOTH_CANNOT_BE_NULL
      2. + value INVALID_PROXIMITY_ADDRESS
    13. enum ImageError.Reason
      1. + value FLASH_WITHOUT_HARD_CODED_CLICK_URL
      2. + value INVALID_FLASH_FILE
      3. + value FAILED_TO_FIX_CLICK_TAG_IN_FLASH
      4. + value FLASH_ACCESSES_NETWORK_RESOURCES
      5. + value FLASH_EXTERNAL_JS_CALL
      6. + value FLASH_EXTERNAL_FS_CALL
    14. type LocationSyncExtension
      1. + field oAuthInfo
    15. type MobileExtension
      1. + field isCallTrackingEnabled
    16. enum SelectorError.Reason
      1. + value START_INDEX_IS_TOO_HIGH
    17. type Stats
      1. + field avgCostForOfflineInteraction
      2. + field numOfflineImpressions
      3. + field numOfflineInteractions
      4. + field offlineInteractionCost
      5. + field offlineInteractionRate
    18. type ThirdPartyRedirectAd
      1. + field expandingDirections
  12. CampaignAdExtensionService (2 new, 5 changed, 0 removed)
    1. + type BetaError
    2. + enum BetaError.Reason
    3. type BetaError
      1. + field reason
    4. type LocationSyncExtension
      1. + field oAuthInfo
    5. type MobileExtension
      1. + field isCallTrackingEnabled
    6. enum SelectorError.Reason
      1. + value START_INDEX_IS_TOO_HIGH
    7. type Stats
      1. + field avgCostForOfflineInteraction
      2. + field numOfflineImpressions
      3. + field numOfflineInteractions
      4. + field offlineInteractionCost
      5. + field offlineInteractionRate
  13. CampaignCriterionService (2 new, 4 changed, 0 removed)
    1. + type BetaError
    2. + enum BetaError.Reason
    3. type BetaError
      1. + field reason
    4. type CampaignCriterion
      1. + field isNegative
    5. enum CriterionError.Reason
      1. + value PROXIMITY_GEOPOINT_AND_ADDRESS_BOTH_CANNOT_BE_NULL
      2. + value INVALID_PROXIMITY_ADDRESS
    6. enum SelectorError.Reason
      1. + value START_INDEX_IS_TOO_HIGH
  14. CampaignService (5 new, 4 changed, 0 removed)
    1. + type BetaError
    2. + enum BetaError.Reason
    3. + type InteractionBid
    4. + type KeywordMatchSetting
    5. + type PhoneInteractionBid
    6. type AdGroupBids
      1. + field interactionBids
    7. type BetaError
      1. + field reason
    8. enum SelectorError.Reason
      1. + value START_INDEX_IS_TOO_HIGH
    9. type Stats
      1. + field avgCostForOfflineInteraction
      2. + field numOfflineImpressions
      3. + field numOfflineInteractions
      4. + field offlineInteractionCost
      5. + field offlineInteractionRate
  15. ConstantDataService (0 new, 1 changed, 0 removed)
    1. enum SelectorError.Reason
      1. + value START_INDEX_IS_TOO_HIGH
  16. ConversionTrackerService (0 new, 1 changed, 0 removed)
    1. enum SelectorError.Reason
      1. + value START_INDEX_IS_TOO_HIGH
  17. = CreateAccountService (no changes)
  18. = CustomerSyncService (no changes)
  19. DataService (2 new, 3 changed, 0 removed)
    1. + type BetaError
    2. + enum BetaError.Reason
    3. type BetaError
      1. + field reason
    4. type BidLandscape.LandscapePoint
      1. + field promotedImpressions
    5. enum SelectorError.Reason
      1. + value START_INDEX_IS_TOO_HIGH
  20. ExperimentService (0 new, 1 changed, 0 removed)
    1. enum SelectorError.Reason
      1. + value START_INDEX_IS_TOO_HIGH
  21. = GeoLocationService (no changes)
  22. = InfoService (no changes)
  23. LocationCriterionService (0 new, 1 changed, 0 removed)
    1. enum SelectorError.Reason
      1. + value START_INDEX_IS_TOO_HIGH
  24. MediaService (0 new, 2 changed, 0 removed)
    1. enum ImageError.Reason
      1. + value FLASH_WITHOUT_HARD_CODED_CLICK_URL
      2. + value INVALID_FLASH_FILE
      3. + value FAILED_TO_FIX_CLICK_TAG_IN_FLASH
      4. + value FLASH_ACCESSES_NETWORK_RESOURCES
      5. + value FLASH_EXTERNAL_JS_CALL
      6. + value FLASH_EXTERNAL_FS_CALL
    2. enum SelectorError.Reason
      1. + value START_INDEX_IS_TOO_HIGH
  25. MutateJobService (6 new, 12 changed, 0 removed)
    1. + type BetaError
    2. + enum BetaError.Reason
    3. + type InteractionBid
    4. + type KeywordMatchSetting
    5. + type PhoneInteractionBid
    6. + enum ThirdPartyRedirectAd.ExpandingDirection
    7. enum AdError.Reason
      1. + value INVALID_CHARACTER_FOR_URL
      2. + value INCONSISTENT_EXPANDABLE_SETTINGS
      3. + value INVALID_FIELD_TEXT
    8. type AdGroupBids
      1. + field interactionBids
    9. type BetaError
      1. + field reason
    10. type BiddableAdGroupCriterion
      1. + field topOfPageCpc
    11. type CampaignCriterion
      1. + field isNegative
    12. enum CriterionError.Reason
      1. + value PROXIMITY_GEOPOINT_AND_ADDRESS_BOTH_CANNOT_BE_NULL
      2. + value INVALID_PROXIMITY_ADDRESS
    13. enum ImageError.Reason
      1. + value FLASH_WITHOUT_HARD_CODED_CLICK_URL
      2. + value INVALID_FLASH_FILE
      3. + value FAILED_TO_FIX_CLICK_TAG_IN_FLASH
      4. + value FLASH_ACCESSES_NETWORK_RESOURCES
      5. + value FLASH_EXTERNAL_JS_CALL
      6. + value FLASH_EXTERNAL_FS_CALL
    14. type LocationSyncExtension
      1. + field oAuthInfo
    15. type MobileExtension
      1. + field isCallTrackingEnabled
    16. enum SelectorError.Reason
      1. + value START_INDEX_IS_TOO_HIGH
    17. type Stats
      1. + field avgCostForOfflineInteraction
      2. + field numOfflineImpressions
      3. + field numOfflineInteractions
      4. + field offlineInteractionCost
      5. + field offlineInteractionRate
    18. type ThirdPartyRedirectAd
      1. + field expandingDirections
  26. ReportDefinitionService (4 new, 5 changed, 0 removed)
    1. + type BetaError
    2. + enum BetaError.Reason
    3. + type StringLengthError
    4. + enum StringLengthError.Reason
    5. type BetaError
      1. + field reason
    6. enum ReportDefinition.ReportType
      1. + value CALL_METRICS_CALL_DETAILS_REPORT
      2. value DEMOGRAPHIC_PERFORMANCE_REPORT
    7. type ReportDefinitionField
      1. + field isBeta
    8. enum SelectorError.Reason
      1. + value START_INDEX_IS_TOO_HIGH
    9. type StringLengthError
      1. + field reason
  27. = ServicedAccountService (no changes)
  28. TargetingIdeaService (0 new, 3 changed, 0 removed)
    1. enum AttributeType
      1. + value CATEGORY_PRODUCTS_AND_SERVICES
      2. value KEYWORD_CATEGORY
    2. type BidLandscape.LandscapePoint
      1. + field promotedImpressions
    3. enum CriterionError.Reason
      1. + value PROXIMITY_GEOPOINT_AND_ADDRESS_BOTH_CANNOT_BE_NULL
      2. + value INVALID_PROXIMITY_ADDRESS
  29. = TrafficEstimatorService (no changes)
  30. UserListService (0 new, 1 changed, 0 removed)
    1. enum SelectorError.Reason
      1. + value START_INDEX_IS_TOO_HIGH

v201109

What's New

ConstantDataService
The new ConstantDataService returns constant values used by the API.
LocationCriterionService
The new LocationCriterionService returns the ID of a location criterion.
MutateJobService
The new MutateJobService allows for the scheduling of large batch updates as asynchronous jobs. This service simplifies mutate jobs submissions and will eventually replace BulkMutateJobService.
Changes to reporting
  • The cross-client (MCC) reporting feature of ReportDefinitions will no longer be supported.
  • ReportDefinitionService is now read-only. You can still use it to retrieve reports that are already defined. To generate new reports, you can use AdHoc Reports.
XML validation
XML validation for API calls is turned on in production starting with v201109.
Negative keyword support
Negative keyword support has been added to TrafficEstimatorService.
Partial failure support
Partial failure has been extended to support AdGroupAdService.
Platform/Device Targeting
Tablet has been added as a Platform.
Deprecated
  • API versions v13, v200909, v201003, v201008, v201101. API version v13 AccountService is only available on a whitelist basis.
  • Cross-client (MCC) reporting.
  • Email address is no longer to be used as a client identifier; only Customer ID (available through InfoService or ServicedAccountService) is supported.
  • CampaignTargetService has been sunset (except for AdScheduleTargets). Its functionality has been merged into CampaignCriterionService.

API Changes

  1. + ConstantDataService
  2. + LocationCriterionService
  3. + MutateJobService
  4. AdExtensionOverrideService (0 new, 1 changed, 0 removed)
    1. type Stats
      1. + field avgCallDurationSecs
      2. + field callDurationSecs
      3. + field numCalls
      4. + field numMissedCalls
      5. + field numReceivedCalls
  5. = AdGroupAdService (no changes)
  6. AdGroupCriterionService (14 new, 10 changed, 0 removed)
    1. + type Address
    2. + type AgeRange
    3. + enum AgeRange.AgeRangeType
    4. + type Carrier
    5. + type Gender
    6. + enum Gender.GenderType
    7. + type GeoPoint
    8. + type Language
    9. + type Location
    10. + type OperatingSystemVersion
    11. + type Platform
    12. + type Polygon
    13. + type Proximity
    14. + enum Proximity.DistanceUnits
    15. type AgeRange
      1. + field ageRangeType
    16. enum BiddingError.Reason
      1. value BID_INCOMPATIBLE_WITH_ADGROUP
      2. value BID_UNIVERSAL_CRITERIA_EXPECTED
      3. value BIDS_DO_NOT_FULFILL_SPEC
      4. value NETWORK_NOT_OVERRIDEABLE
      5. value CURRENCY_MISMATCH
      6. value ADGROUPS_DO_NOT_MATCH_CONSTRAINT
      7. value NETWORK_SETTINGS_DO_NOT_SUPPORT_TRANSITION
      8. value UNSUPPORTED_STYLE_TRANSITION
      9. value UNSUPPORTED_PROXY_BIDDER_STRATEGY_TRANSITION
      10. value TRANSITION_DOES_NOT_SUPPORT_OPTION
      11. value TRANSITION_DOES_NOT_SUPPORT_GOAL
      12. value PROXY_BIDDER_STRATEGY_INCOMPATIBLE_WITH_STYLE
      13. value GOAL_DOES_NOT_FULFILL_SPEC
      14. value GOAL_VALIDATION_FAILED
      15. value UNSUPPORTED_STYLE
      16. value BAD_BID_COMBINATION
      17. value CANNOT_TARGET_UNIVERSE
      18. value NO_DESTINATION_URL_SPECIFIED
      19. value NO_EFFECTIVE_BID
      20. value CRITERION_NOT_TARGETED
      21. value CANNOT_EXCLUDE_DEFAULT
      22. value CANNOT_TARGET_AND_EXCLUDE
      23. value ILLEGAL_URL
      24. value BID_TO_POSITION_NOT_ENABLED
      25. value POSITION_PREFERENCE_NOT_ENABLED
      26. value POSITION_PREFERENCE_NOT_SUPPORTED_FOR_CRITERIA_TYPE
      27. value PREFERRED_POSITION_OUT_OF_RANGE
      28. value BOTTOM_POSITION_OUT_OF_RANGE
      29. value PREFERRED_POSITION_CANNOT_BE_HIGHER_THAN_BOTTOM
      30. value CAMPAIGN_ALREADY_SET
      31. value PROXY_NOT_ENABLED
      32. value CANNOT_UPDATE_SITE_BIDS_WHILE_PROXY_BIDDING
      33. value AUCTION_STRATEGY_INCOMPATIBLE_WITH_PROXY_BIDDER
    17. type Criterion
      1. + field type
    18. enum Criterion.Type
      1. + value LANGUAGE
      2. + value LOCATION
      3. + value AGE_RANGE
      4. + value CARRIER
      5. + value OPERATING_SYSTEM_VERSION
      6. + value GENDER
      7. + value POLYGON
      8. + value PROXIMITY
      9. + value PLATFORM
      10. + value UNKNOWN
    19. enum CriterionError.Reason
      1. + value CANNOT_ADD_CRITERIA_TYPE
      2. + value INVALID_CRITERION_ID
      3. + value CANNOT_TARGET_CRITERION
      4. + value CRITERION_ID_AND_TYPE_MISMATCH
      5. + value INVALID_PROXIMITY_RADIUS
      6. + value INVALID_PROXIMITY_RADIUS_UNITS
      7. + value INVALID_STREETADDRESS_LENGTH
      8. + value INVALID_CITYNAME_LENGTH
      9. + value INVALID_REGIONCODE_LENGTH
      10. + value INVALID_REGIONNAME_LENGTH
      11. + value INVALID_POSTALCODE_LENGTH
      12. + value INVALID_COUNTRY_CODE
      13. + value INVALID_LATITUDE
      14. + value INVALID_LONGITUDE
    20. type Gender
      1. + field genderType
    21. type ManualCPCAdGroupCriterionBids
      1. field positionPreferenceBids
    22. type Proximity
      1. + field address
      2. + field geoPoint
      3. + field radiusDistanceUnits
    23. enum SelectorError.Reason
      1. + value MISSING_PREDICATES
      2. + value INVALID_SORT_FIELD_NAME
      3. + value SELECTOR_ERROR
    24. type Stats
      1. + field avgCallDurationSecs
      2. + field callDurationSecs
      3. + field numCalls
      4. + field numMissedCalls
      5. + field numReceivedCalls
  7. AdGroupService (0 new, 3 changed, 0 removed)
    1. enum BiddingError.Reason
      1. value BID_INCOMPATIBLE_WITH_ADGROUP
      2. value BID_UNIVERSAL_CRITERIA_EXPECTED
      3. value BIDS_DO_NOT_FULFILL_SPEC
      4. value NETWORK_NOT_OVERRIDEABLE
      5. value CURRENCY_MISMATCH
      6. value ADGROUPS_DO_NOT_MATCH_CONSTRAINT
      7. value NETWORK_SETTINGS_DO_NOT_SUPPORT_TRANSITION
      8. value UNSUPPORTED_STYLE_TRANSITION
      9. value UNSUPPORTED_PROXY_BIDDER_STRATEGY_TRANSITION
      10. value TRANSITION_DOES_NOT_SUPPORT_OPTION
      11. value TRANSITION_DOES_NOT_SUPPORT_GOAL
      12. value PROXY_BIDDER_STRATEGY_INCOMPATIBLE_WITH_STYLE
      13. value GOAL_DOES_NOT_FULFILL_SPEC
      14. value GOAL_VALIDATION_FAILED
      15. value UNSUPPORTED_STYLE
      16. value BAD_BID_COMBINATION
      17. value CANNOT_TARGET_UNIVERSE
      18. value NO_DESTINATION_URL_SPECIFIED
      19. value NO_EFFECTIVE_BID
      20. value CRITERION_NOT_TARGETED
      21. value CANNOT_EXCLUDE_DEFAULT
      22. value CANNOT_TARGET_AND_EXCLUDE
      23. value ILLEGAL_URL
      24. value BID_TO_POSITION_NOT_ENABLED
      25. value POSITION_PREFERENCE_NOT_ENABLED
      26. value POSITION_PREFERENCE_NOT_SUPPORTED_FOR_CRITERIA_TYPE
      27. value PREFERRED_POSITION_OUT_OF_RANGE
      28. value BOTTOM_POSITION_OUT_OF_RANGE
      29. value PREFERRED_POSITION_CANNOT_BE_HIGHER_THAN_BOTTOM
      30. value CAMPAIGN_ALREADY_SET
      31. value PROXY_NOT_ENABLED
      32. value CANNOT_UPDATE_SITE_BIDS_WHILE_PROXY_BIDDING
      33. value AUCTION_STRATEGY_INCOMPATIBLE_WITH_PROXY_BIDDER
    2. enum SelectorError.Reason
      1. + value MISSING_PREDICATES
      2. + value INVALID_SORT_FIELD_NAME
      3. + value SELECTOR_ERROR
    3. type Stats
      1. + field avgCallDurationSecs
      2. + field callDurationSecs
      3. + field numCalls
      4. + field numMissedCalls
      5. + field numReceivedCalls
  8. AdParamService (2 new, 3 changed, 0 removed)
    1. + type SelectorError
    2. + enum SelectorError.Reason
    3. type SelectorError
      1. + field reason
    4. enum SelectorError.Reason
      1. + value MISSING_PREDICATES
      2. + value INVALID_SORT_FIELD_NAME
      3. + value SELECTOR_ERROR
    5. operation get
      1. + parameter serviceSelector
      2. parameter selector
  9. = AlertService (no changes)
  10. BulkMutateJobService (6 new, 14 changed, 0 removed)
    1. + type AgeRange
    2. + enum AgeRange.AgeRangeType
    3. + type Carrier
    4. + type Gender
    5. + enum Gender.GenderType
    6. + type Language
    7. enum AdServingOptimizationStatus
      1. + value CONVERSION_OPTIMIZE
    8. type AgeRange
      1. + field ageRangeType
    9. enum AgeTarget.Age
      1. + value UNKNOWN
    10. enum BiddingError.Reason
      1. value BID_INCOMPATIBLE_WITH_ADGROUP
      2. value BID_UNIVERSAL_CRITERIA_EXPECTED
      3. value BIDS_DO_NOT_FULFILL_SPEC
      4. value NETWORK_NOT_OVERRIDEABLE
      5. value CURRENCY_MISMATCH
      6. value ADGROUPS_DO_NOT_MATCH_CONSTRAINT
      7. value NETWORK_SETTINGS_DO_NOT_SUPPORT_TRANSITION
      8. value UNSUPPORTED_STYLE_TRANSITION
      9. value UNSUPPORTED_PROXY_BIDDER_STRATEGY_TRANSITION
      10. value TRANSITION_DOES_NOT_SUPPORT_OPTION
      11. value TRANSITION_DOES_NOT_SUPPORT_GOAL
      12. value PROXY_BIDDER_STRATEGY_INCOMPATIBLE_WITH_STYLE
      13. value GOAL_DOES_NOT_FULFILL_SPEC
      14. value GOAL_VALIDATION_FAILED
      15. value UNSUPPORTED_STYLE
      16. value BAD_BID_COMBINATION
      17. value CANNOT_TARGET_UNIVERSE
      18. value NO_DESTINATION_URL_SPECIFIED
      19. value NO_EFFECTIVE_BID
      20. value CRITERION_NOT_TARGETED
      21. value CANNOT_EXCLUDE_DEFAULT
      22. value CANNOT_TARGET_AND_EXCLUDE
      23. value ILLEGAL_URL
      24. value BID_TO_POSITION_NOT_ENABLED
      25. value CAMPAIGN_ALREADY_SET
      26. value PROXY_NOT_ENABLED
      27. value CANNOT_UPDATE_SITE_BIDS_WHILE_PROXY_BIDDING
      28. value AUCTION_STRATEGY_INCOMPATIBLE_WITH_PROXY_BIDDER
    11. type Criterion
      1. + field type
    12. enum Criterion.Type
      1. + value LANGUAGE
      2. + value CARRIER
      3. + value UNKNOWN
    13. enum DeprecatedAd.Type
      1. + value AUDIO_TEMPLATE
    14. type Gender
      1. + field genderType
    15. enum GenderTarget.Gender
      1. + value UNKNOWN
    16. type Job
      1. field context
    17. enum MediaError.Reason
      1. + value YOU_TUBE_VIDEO_HAS_NON_POSITIVE_DURATION
    18. enum PlatformType
      1. + value TABLET
    19. enum SelectorError.Reason
      1. + value MISSING_PREDICATES
    20. type Stats
      1. + field avgCallDurationSecs
      2. + field callDurationSecs
      3. + field numCalls
      4. + field numMissedCalls
      5. + field numReceivedCalls
  11. BulkOpportunityService (0 new, 4 changed, 0 removed)
    1. type Criterion
      1. + field type
    2. enum Criterion.Type
      1. + value LANGUAGE
      2. + value LOCATION
      3. + value AGE_RANGE
      4. + value CARRIER
      5. + value OPERATING_SYSTEM_VERSION
      6. + value GENDER
      7. + value POLYGON
      8. + value PROXIMITY
      9. + value PLATFORM
      10. + value UNKNOWN
    3. enum SiteConstants.AdFormat
      1. value AUDIO
    4. enum SiteConstants.PlacementType
      1. value AUDIO
  12. CampaignAdExtensionService (0 new, 2 changed, 0 removed)
    1. enum SelectorError.Reason
      1. + value MISSING_PREDICATES
      2. + value INVALID_SORT_FIELD_NAME
      3. + value SELECTOR_ERROR
    2. type Stats
      1. + field avgCallDurationSecs
      2. + field callDurationSecs
      3. + field numCalls
      4. + field numMissedCalls
      5. + field numReceivedCalls
  13. CampaignCriterionService (6 new, 5 changed, 0 removed)
    1. + type AgeRange
    2. + enum AgeRange.AgeRangeType
    3. + type Carrier
    4. + type Gender
    5. + enum Gender.GenderType
    6. + type Language
    7. type AgeRange
      1. + field ageRangeType
    8. type Criterion
      1. + field type
    9. enum Criterion.Type
      1. + value LANGUAGE
      2. + value CARRIER
      3. + value UNKNOWN
    10. type Gender
      1. + field genderType
    11. enum SelectorError.Reason
      1. + value MISSING_PREDICATES
  14. CampaignService (0 new, 5 changed, 0 removed)
    1. enum BiddingError.Reason
      1. value BID_INCOMPATIBLE_WITH_ADGROUP
      2. value BID_UNIVERSAL_CRITERIA_EXPECTED
      3. value BIDS_DO_NOT_FULFILL_SPEC
      4. value NETWORK_NOT_OVERRIDEABLE
      5. value CURRENCY_MISMATCH
      6. value ADGROUPS_DO_NOT_MATCH_CONSTRAINT
      7. value NETWORK_SETTINGS_DO_NOT_SUPPORT_TRANSITION
      8. value UNSUPPORTED_STYLE_TRANSITION
      9. value UNSUPPORTED_PROXY_BIDDER_STRATEGY_TRANSITION
      10. value TRANSITION_DOES_NOT_SUPPORT_OPTION
      11. value TRANSITION_DOES_NOT_SUPPORT_GOAL
      12. value PROXY_BIDDER_STRATEGY_INCOMPATIBLE_WITH_STYLE
      13. value GOAL_DOES_NOT_FULFILL_SPEC
      14. value GOAL_VALIDATION_FAILED
      15. value UNSUPPORTED_STYLE
      16. value BAD_BID_COMBINATION
      17. value CANNOT_TARGET_UNIVERSE
      18. value NO_DESTINATION_URL_SPECIFIED
      19. value NO_EFFECTIVE_BID
      20. value CRITERION_NOT_TARGETED
      21. value CANNOT_EXCLUDE_DEFAULT
      22. value CANNOT_TARGET_AND_EXCLUDE
      23. value ILLEGAL_URL
      24. value BID_TO_POSITION_NOT_ENABLED
      25. value POSITION_PREFERENCE_NOT_ENABLED
      26. value POSITION_PREFERENCE_NOT_SUPPORTED_FOR_CRITERIA_TYPE
      27. value PREFERRED_POSITION_OUT_OF_RANGE
      28. value BOTTOM_POSITION_OUT_OF_RANGE
      29. value PREFERRED_POSITION_CANNOT_BE_HIGHER_THAN_BOTTOM
      30. value CAMPAIGN_ALREADY_SET
      31. value PROXY_NOT_ENABLED
      32. value CANNOT_UPDATE_SITE_BIDS_WHILE_PROXY_BIDDING
      33. value AUCTION_STRATEGY_INCOMPATIBLE_WITH_PROXY_BIDDER
    2. enum CampaignError.Reason
      1. + value CANNOT_SET_END_DATE_BEFORE_EXPERIMENT_END_DATE
    3. type ManualCPC
      1. field positionPreference
    4. enum SelectorError.Reason
      1. + value MISSING_PREDICATES
      2. + value INVALID_SORT_FIELD_NAME
      3. + value SELECTOR_ERROR
    5. type Stats
      1. + field avgCallDurationSecs
      2. + field callDurationSecs
      3. + field numCalls
      4. + field numMissedCalls
      5. + field numReceivedCalls
  15. CampaignTargetService (0 new, 10 changed, 27 removed)
    1. type AgeTarget
      1. field age
    2. enum AgeTarget.Age
      1. + value UNKNOWN
    3. enum BiddingError.Reason
      1. value BID_INCOMPATIBLE_WITH_ADGROUP
      2. value BID_UNIVERSAL_CRITERIA_EXPECTED
      3. value BIDS_DO_NOT_FULFILL_SPEC
      4. value NETWORK_NOT_OVERRIDEABLE
      5. value CURRENCY_MISMATCH
      6. value ADGROUPS_DO_NOT_MATCH_CONSTRAINT
      7. value NETWORK_SETTINGS_DO_NOT_SUPPORT_TRANSITION
      8. value UNSUPPORTED_STYLE_TRANSITION
      9. value UNSUPPORTED_PROXY_BIDDER_STRATEGY_TRANSITION
      10. value TRANSITION_DOES_NOT_SUPPORT_OPTION
      11. value TRANSITION_DOES_NOT_SUPPORT_GOAL
      12. value PROXY_BIDDER_STRATEGY_INCOMPATIBLE_WITH_STYLE
      13. value GOAL_DOES_NOT_FULFILL_SPEC
      14. value GOAL_VALIDATION_FAILED
      15. value UNSUPPORTED_STYLE
      16. value BAD_BID_COMBINATION
      17. value CANNOT_TARGET_UNIVERSE
      18. value NO_DESTINATION_URL_SPECIFIED
      19. value NO_EFFECTIVE_BID
      20. value CRITERION_NOT_TARGETED
      21. value CANNOT_EXCLUDE_DEFAULT
      22. value CANNOT_TARGET_AND_EXCLUDE
      23. value ILLEGAL_URL
      24. value BID_TO_POSITION_NOT_ENABLED
      25. value POSITION_PREFERENCE_NOT_ENABLED
      26. value POSITION_PREFERENCE_NOT_SUPPORTED_FOR_CRITERIA_TYPE
      27. value PREFERRED_POSITION_OUT_OF_RANGE
      28. value BOTTOM_POSITION_OUT_OF_RANGE
      29. value PREFERRED_POSITION_CANNOT_BE_HIGHER_THAN_BOTTOM
      30. value CAMPAIGN_ALREADY_SET
      31. value PROXY_NOT_ENABLED
      32. value CANNOT_UPDATE_SITE_BIDS_WHILE_PROXY_BIDDING
      33. value AUCTION_STRATEGY_INCOMPATIBLE_WITH_PROXY_BIDDER
    4. enum CampaignError.Reason
      1. + value CANNOT_SET_END_DATE_BEFORE_EXPERIMENT_END_DATE
    5. type GenderTarget
      1. field gender
    6. enum GenderTarget.Gender
      1. + value UNKNOWN
    7. type NetworkTarget
      1. field networkCoverageType
    8. type PlatformTarget
      1. field platformType
    9. enum PlatformType
      1. + value TABLET
    10. type ProximityTarget
      1. field address
      2. field geoPoint
      3. field radiusDistanceUnits
    11. type Address
    12. type AgeTarget
    13. enum AgeTarget.Age
    14. type CityTarget
    15. type CountryTarget
    16. type DemographicTarget
    17. type DemographicTargetList
    18. type GenderTarget
    19. enum GenderTarget.Gender
    20. type GeoPoint
    21. type GeoTarget
    22. type GeoTargetList
    23. type LanguageTarget
    24. type LanguageTargetList
    25. type MetroTarget
    26. type MobileCarrierTarget
    27. type MobilePlatformTarget
    28. type MobileTarget
    29. type MobileTargetList
    30. enum NetworkCoverageType
    31. type PlatformTarget
    32. type PlatformTargetList
    33. enum PlatformType
    34. type PolygonTarget
    35. type ProvinceTarget
    36. type ProximityTarget
    37. enum ProximityTarget.DistanceUnits
  16. ConversionTrackerService (2 new, 2 changed, 0 removed)
    1. + type SelectorError
    2. + enum SelectorError.Reason
    3. type SelectorError
      1. + field reason
    4. enum SelectorError.Reason
      1. + value MISSING_PREDICATES
      2. + value INVALID_SORT_FIELD_NAME
      3. + value SELECTOR_ERROR
  17. = CustomerSyncService (no changes)
  18. DataService (0 new, 1 changed, 0 removed)
    1. enum SelectorError.Reason
      1. + value MISSING_PREDICATES
      2. + value INVALID_SORT_FIELD_NAME
      3. + value SELECTOR_ERROR
  19. ExperimentService (0 new, 2 changed, 0 removed)
    1. enum ExperimentServiceError.Reason
      1. + value EXPERIMENT_LIMIT_EXCEEDED
      2. value EXPERIMENT_LIMIT_EXCEEEDED
    2. enum SelectorError.Reason
      1. + value MISSING_PREDICATES
      2. + value INVALID_SORT_FIELD_NAME
      3. + value SELECTOR_ERROR
  20. = GeoLocationService (no changes)
  21. InfoService (0 new, 3 changed, 0 removed)
    1. enum ApiUsageError.Reason
      1. + value MAY_ONLY_SELECT_BY_EMAIL_OR_ID
      2. + value INVALID_CLIENT_CUSTOMER_ID
    2. type ApiUsageRecord
      1. + field clientCustomerId
    3. type InfoSelector
      1. + field clientCustomerIds
      2. + field includeSubAccounts
  22. MediaService (0 new, 2 changed, 0 removed)
    1. enum MediaError.Reason
      1. + value YOU_TUBE_VIDEO_HAS_NON_POSITIVE_DURATION
    2. enum SelectorError.Reason
      1. + value MISSING_PREDICATES
      2. + value INVALID_SORT_FIELD_NAME
      3. + value SELECTOR_ERROR
  23. ReportDefinitionService (2 new, 8 changed, 1 removed)
    1. + type RejectedError
    2. + enum RejectedError.Reason
    3. type ClientSelector
      1. + field customerId
      2. field login
      3. field predicates
    4. type RejectedError
      1. + field reason
    5. type ReportDefinition
      1. + field includeZeroImpressions
      2. field clientSelectors
      3. field crossClient
    6. enum ReportDefinition.ReportType
      1. + value CRITERIA_PERFORMANCE_REPORT
    7. enum ReportDefinitionError.Reason
      1. + value CLIENT_SELECTOR_NO_CUSTOMER_IDENTIFIER
      2. + value CLIENT_SELECTOR_INVALID_CUSTOMER_ID
      3. + value REPORT_DEFINITION_ERROR
    8. type ReportDefinitionField
      1. + field isEnumType
    9. enum SelectorError.Reason
      1. + value MISSING_PREDICATES
      2. + value INVALID_SORT_FIELD_NAME
      3. + value SELECTOR_ERROR
    10. operation mutate
      1. parameter operations
      2. response rval
    11. operation mutate
  24. ServicedAccountService (0 new, 2 changed, 1 removed)
    1. type Link
      1. field serviceType
    2. enum ServicedAccountError.Reason
      1. + value REQUESTS_TOO_FREQUENT
    3. enum ServiceType
  25. TargetingIdeaService (8 new, 8 changed, 7 removed)
    1. + type CategoryProductsAndServicesSearchParameter
    2. + type IdeaTextFilterSearchParameter
    3. + type Language
    4. + type LanguageSearchParameter
    5. + type Location
    6. + type LocationSearchParameter
    7. + type TrafficEstimatorError
    8. + enum TrafficEstimatorError.Reason
    9. enum BiddingError.Reason
      1. value BID_INCOMPATIBLE_WITH_ADGROUP
      2. value BID_UNIVERSAL_CRITERIA_EXPECTED
      3. value BIDS_DO_NOT_FULFILL_SPEC
      4. value NETWORK_NOT_OVERRIDEABLE
      5. value CURRENCY_MISMATCH
      6. value ADGROUPS_DO_NOT_MATCH_CONSTRAINT
      7. value NETWORK_SETTINGS_DO_NOT_SUPPORT_TRANSITION
      8. value UNSUPPORTED_STYLE_TRANSITION
      9. value UNSUPPORTED_PROXY_BIDDER_STRATEGY_TRANSITION
      10. value TRANSITION_DOES_NOT_SUPPORT_OPTION
      11. value TRANSITION_DOES_NOT_SUPPORT_GOAL
      12. value PROXY_BIDDER_STRATEGY_INCOMPATIBLE_WITH_STYLE
      13. value GOAL_DOES_NOT_FULFILL_SPEC
      14. value GOAL_VALIDATION_FAILED
      15. value UNSUPPORTED_STYLE
      16. value BAD_BID_COMBINATION
      17. value CANNOT_TARGET_UNIVERSE
      18. value NO_DESTINATION_URL_SPECIFIED
      19. value NO_EFFECTIVE_BID
      20. value CRITERION_NOT_TARGETED
      21. value CANNOT_EXCLUDE_DEFAULT
      22. value CANNOT_TARGET_AND_EXCLUDE
      23. value ILLEGAL_URL
      24. value BID_TO_POSITION_NOT_ENABLED
      25. value POSITION_PREFERENCE_NOT_ENABLED
      26. value POSITION_PREFERENCE_NOT_SUPPORTED_FOR_CRITERIA_TYPE
      27. value PREFERRED_POSITION_OUT_OF_RANGE
      28. value BOTTOM_POSITION_OUT_OF_RANGE
      29. value PREFERRED_POSITION_CANNOT_BE_HIGHER_THAN_BOTTOM
      30. value CAMPAIGN_ALREADY_SET
      31. value PROXY_NOT_ENABLED
      32. value CANNOT_UPDATE_SITE_BIDS_WHILE_PROXY_BIDDING
      33. value AUCTION_STRATEGY_INCOMPATIBLE_WITH_PROXY_BIDDER
    10. type Criterion
      1. + field type
    11. enum Criterion.Type
      1. + value LANGUAGE
      2. + value LOCATION
      3. + value AGE_RANGE
      4. + value CARRIER
      5. + value OPERATING_SYSTEM_VERSION
      6. + value GENDER
      7. + value POLYGON
      8. + value PROXIMITY
      9. + value PLATFORM
      10. + value UNKNOWN
    12. enum CriterionError.Reason
      1. + value CANNOT_ADD_CRITERIA_TYPE
      2. + value INVALID_CRITERION_ID
      3. + value CANNOT_TARGET_CRITERION
      4. + value CRITERION_ID_AND_TYPE_MISMATCH
      5. + value INVALID_PROXIMITY_RADIUS
      6. + value INVALID_PROXIMITY_RADIUS_UNITS
      7. + value INVALID_STREETADDRESS_LENGTH
      8. + value INVALID_CITYNAME_LENGTH
      9. + value INVALID_REGIONCODE_LENGTH
      10. + value INVALID_REGIONNAME_LENGTH
      11. + value INVALID_POSTALCODE_LENGTH
      12. + value INVALID_COUNTRY_CODE
      13. + value INVALID_LATITUDE
      14. + value INVALID_LONGITUDE
    13. enum SiteConstants.AdFormat
      1. value AUDIO
    14. enum SiteConstants.AdType
      1. value AUDIO
    15. enum SiteConstants.PlacementType
      1. value AUDIO
    16. type TrafficEstimatorError
      1. + field reason
    17. type CountryTarget
    18. type CountryTargetSearchParameter
    19. type GeoTarget
    20. type IdeaTextMatchesSearchParameter
    21. type KeywordCategoryIdSearchParameter
    22. type LanguageTarget
    23. type LanguageTargetSearchParameter
  26. TrafficEstimatorService (2 new, 11 changed, 19 removed)
    1. + type Language
    2. + type Location
    3. type AgeTarget
      1. field age
    4. enum AgeTarget.Age
      1. + value UNKNOWN
    5. type CampaignEstimateRequest
      1. + field criteria
      2. + field dailyBudget
      3. + field networkSetting
      4. field targets
    6. type Criterion
      1. + field type
    7. enum Criterion.Type
      1. + value LANGUAGE
      2. + value LOCATION
      3. + value AGE_RANGE
      4. + value CARRIER
      5. + value OPERATING_SYSTEM_VERSION
      6. + value GENDER
      7. + value POLYGON
      8. + value PROXIMITY
      9. + value PLATFORM
      10. + value UNKNOWN
    8. type GenderTarget
      1. field gender
    9. enum GenderTarget.Gender
      1. + value UNKNOWN
    10. type KeywordEstimateRequest
      1. + field isNegative
    11. type NetworkTarget
      1. field networkCoverageType
    12. type PlatformTarget
      1. field platformType
    13. enum PlatformType
      1. + value TABLET
    14. type AgeTarget
    15. enum AgeTarget.Age
    16. type CityTarget
    17. type CountryTarget
    18. type DemographicTarget
    19. type GenderTarget
    20. enum GenderTarget.Gender
    21. type GeoTarget
    22. type LanguageTarget
    23. type MetroTarget
    24. type MobileCarrierTarget
    25. type MobilePlatformTarget
    26. type MobileTarget
    27. enum NetworkCoverageType
    28. type PlatformTarget
    29. enum PlatformType
    30. type PolygonTarget
    31. type ProvinceTarget
    32. type ProximityTarget
  27. UserListService (0 new, 1 changed, 0 removed)
    1. enum SelectorError.Reason
      1. + value MISSING_PREDICATES
      2. + value INVALID_SORT_FIELD_NAME
      3. + value SELECTOR_ERROR

v201101

What's New

ConversionTrackerService for Interest Based Advertising
For use with AdWords Conversion Tracking, ConversionTrackerService enables you to retrieve the Javascript tag for a conversion event or user list and to create or delete conversion tags.
DataService
The new DataService returns ads campaign management data, based on specified criteria.
BulkOpportunityService
The new BulkOpportunityService, currently in limited release, enables the download of keyword, bid, and budget ideas that appear on the Opportunities Tab. It enables users to capture more impressions and clicks, gain traffic for campaigns that are meeting budgets and increase or decrease CPC bids to increase traffic or reduce costs.
MCC reports and other reporting enhancements

Note: Cross-client (MCC) reports has been deprecated.

ReportDefinitionService now supports asynchronously-fetched My Client Center (MCC) cross-client reports. All report types have new fields for use in cross-client reporting, and the following new report types have been added: Ad Extensions Performance, Creative Conversion, Demographic Performance, Destination URL, and Geo Performance.
Changes to Selectors
The get operations for a number of services now use a single standard selector, rather than service-specific selectors. The standard selector provides more control over the data returned, lets you filter on almost any field, and specify sorting and paging. For information about migrating your code, see the Selector Migration Guide.
Experiments for Ads
A campaign can now try out sets of ads experimentally by using ExperimentData in the AdGroupAd type. The Ad Group Performance, Campaign Performance, Keywords Performance, and Managed Placements Performance reports each have a field that lets you segment on the control arm or experiment arm, and a report field for each statistic indicates the significance in the change of that statistic in the experiment arm.
Enhanced Geographical Targeting for Campaigns
A new setting for the Campaign type lets you specify how to apply geo targeting, differentiating a user's physical location from the location used for the search.
TargetingIdeaService changes
A new Criterion type replaces both the Keyword and Placement types, which are deprecated. The DeviceTypeSearchParameter type provides more comprehensive mobile statistics, and the MobileSearchParameter type is deprecated.
NetworkSettings Moved to CampaignService
The Campaign type now has the NetworkSetting list. Its values were previously contained in the NetworkCoverageType field of the NetworkTarget type, which is now deprecated.
Real Time Bidding
An Ad Exchange campaign can now do real-time bidding on content ads. In the new Settings field of the Campaign type, add the RealTimeBiddingSetting element and set its optIn field.
New Locations for Targeting
The list of cities and countries to which you can target ads has expanded.
Deprecated
BidLandscapeService functionality has moved to DataService and is scheduled for sunsetting, along with v13 ReportService and TrafficEstimatorService, v200909, v201003, and v201008. Check with the Adwords API Blog for the specific date.

API Changes

  1. - BidLandscapeService
  2. + BulkOpportunityService
  3. + ConversionTrackerService
  4. + DataService
  5. AdExtensionOverrideService (0 new, 3 changed, 0 removed)
    1. enum DistinctError.Reason
      1. + value DUPLICATE_TYPE
    2. type MobileExtension
      1. + field isCallOnly
    3. type Stats
      1. + field invalidClickRate
      2. + field invalidClicks
  6. AdGroupAdService (2 new, 12 changed, 1 removed)
    1. + type SelectorError
    2. + enum SelectorError.Reason
    3. enum AdError.Reason
      1. + value URL_INVALID_SCHEME
    4. type AdGroupAd
      1. + field experimentData
    5. type AdGroupAdSelector
      1. + field experimentId
    6. enum DeprecatedAd.Type
      1. + value LOCAL_BUSINESS_AD
      2. + value UNKNOWN
    7. enum DistinctError.Reason
      1. + value DUPLICATE_TYPE
    8. enum MediaError.Reason
      1. + value CANNOT_SELECT_STANDARD_ICON_WITH_OTHER_TYPES
    9. enum OperationAccessDenied.Reason
      1. + value MUTATE_ACTION_NOT_PERMITTED_FOR_CLIENT
    10. type Selector
      1. + field ordering
      2. + field paging
    11. type SelectorError
      1. + field reason
    12. type Stats
      1. + field invalidClickRate
      2. + field invalidClicks
    13. enum TemplateElementField.Type
      1. + value NUMBER
    14. operation get
      1. + parameter serviceSelector
      2. parameter selector
    15. type LocalBusinessAd
  7. AdGroupCriterionService (4 new, 9 changed, 0 removed)
    1. + type CriterionError
    2. + enum CriterionError.Reason
    3. + type SelectorError
    4. + enum SelectorError.Reason
    5. type AdGroupCriterion
      1. + field criterionUse
    6. type CriterionError
      1. + field reason
    7. type CriterionUserList
      1. field userListSize
    8. enum DistinctError.Reason
      1. + value DUPLICATE_TYPE
    9. enum OperationAccessDenied.Reason
      1. + value MUTATE_ACTION_NOT_PERMITTED_FOR_CLIENT
    10. type Selector
      1. + field ordering
      2. + field paging
    11. type SelectorError
      1. + field reason
    12. type Stats
      1. + field invalidClickRate
      2. + field invalidClicks
    13. operation get
      1. + parameter serviceSelector
      2. parameter selector
  8. AdGroupService (2 new, 8 changed, 0 removed)
    1. + type SelectorError
    2. + enum SelectorError.Reason
    3. enum AdGroupServiceError.Reason
      1. value ADGROUP_CAMPAIGN_MISMATCH
      2. value BID_EXCEEDS_AUTO_BUDGET
      3. value BID_EXCEEDS_CUSTOM_BUDGET
      4. value BID_EXCEEDS_DAILY_BUDGET
      5. value BID_EXCEEDS_MONTHLY_BUDGET
      6. value BIDS_NOT_REQUIRED
      7. value ILLEGAL_MANUAL_BID
      8. value INCOMPATIBLE_WITH_KEYWORD_AND_SITE_VBB
      9. value INCOMPATIBLE_WITH_KEYWORD_CPC
      10. value INCOMPATIBLE_WITH_KEYWORD_CPC_AND_SITE_CPC
      11. value INCOMPATIBLE_WITH_KEYWORD_CPM
      12. value INCOMPATIBLE_WITH_KEYWORD_CPM_AND_SITE_CPM
      13. value INCOMPATIBLE_WITH_SITE_CPC
      14. value INCOMPATIBLE_WITH_SITE_CPM
      15. value INCOMPATIBLE_WITH_VBB
      16. value INCOMPATIBLE_WITH_SITE_VBB
      17. value MISSING_BID
      18. value MULTIPLE_BID_TYPES
      19. value NO_CAMPAIGN_BUDGET
      20. value NOT_WHITELISTED_FOR_SITE_CPC
      21. value SEPARATE_CONTENT_BIDS_INAPPLICABLE
      22. value SEPARATE_CONTENT_BIDS_NOT_ENABLED
      23. value TOO_MANY_FRACTION_DIGITS
    4. enum DistinctError.Reason
      1. + value DUPLICATE_TYPE
    5. enum OperationAccessDenied.Reason
      1. + value MUTATE_ACTION_NOT_PERMITTED_FOR_CLIENT
    6. enum QuotaError.Reason
      1. + value TOO_MANY_CRITERIA_PER_ACCOUNT
      2. + value UNKNOWN
    7. type Selector
      1. + field ordering
      2. + field paging
    8. type SelectorError
      1. + field reason
    9. type Stats
      1. + field invalidClickRate
      2. + field invalidClicks
    10. operation get
      1. + parameter serviceSelector
      2. parameter selector
  9. AdParamService (2 new, 3 changed, 0 removed)
    1. + type OperationAccessDenied
    2. + enum OperationAccessDenied.Reason
    3. enum DistinctError.Reason
      1. + value DUPLICATE_TYPE
    4. type OperationAccessDenied
      1. + field reason
    5. enum OperationAccessDenied.Reason
      1. + value MUTATE_ACTION_NOT_PERMITTED_FOR_CLIENT
  10. AlertService (0 new, 4 changed, 0 removed)
    1. type AlertQuery
      1. + field triggerTime
    2. enum AlertType
      1. value KEYWORD_BELOW_MIN_CPC
    3. enum DistinctError.Reason
      1. + value DUPLICATE_TYPE
    4. enum TriggerTimeSpec
      1. + value CUSTOM_TIME
  11. BulkMutateJobService (8 new, 21 changed, 2 removed)
    1. + type CriterionError
    2. + enum CriterionError.Reason
    3. + type GeoTargetTypeSetting
    4. + type RealTimeBiddingSetting
    5. + type SelectorError
    6. + enum SelectorError.Reason
    7. + type SettingError
    8. + enum SettingError.Reason
    9. enum AdError.Reason
      1. + value URL_INVALID_SCHEME
    10. enum AdExtensionError.Reason
      1. + value DISALLOWED_NUMBER_TYPE
    11. type AdGroupAd
      1. + field experimentData
    12. type AdGroupCriterion
      1. + field criterionUse
    13. enum AdGroupServiceError.Reason
      1. value ADGROUP_CAMPAIGN_MISMATCH
      2. value BID_EXCEEDS_AUTO_BUDGET
      3. value BID_EXCEEDS_CUSTOM_BUDGET
      4. value BID_EXCEEDS_DAILY_BUDGET
      5. value BID_EXCEEDS_MONTHLY_BUDGET
      6. value BIDS_NOT_REQUIRED
      7. value ILLEGAL_MANUAL_BID
      8. value INCOMPATIBLE_WITH_KEYWORD_AND_SITE_VBB
      9. value INCOMPATIBLE_WITH_KEYWORD_CPC
      10. value INCOMPATIBLE_WITH_KEYWORD_CPC_AND_SITE_CPC
      11. value INCOMPATIBLE_WITH_KEYWORD_CPM
      12. value INCOMPATIBLE_WITH_KEYWORD_CPM_AND_SITE_CPM
      13. value INCOMPATIBLE_WITH_SITE_CPC
      14. value INCOMPATIBLE_WITH_SITE_CPM
      15. value INCOMPATIBLE_WITH_VBB
      16. value INCOMPATIBLE_WITH_SITE_VBB
      17. value MISSING_BID
      18. value MULTIPLE_BID_TYPES
      19. value NO_CAMPAIGN_BUDGET
      20. value NOT_WHITELISTED_FOR_SITE_CPC
      21. value SEPARATE_CONTENT_BIDS_INAPPLICABLE
      22. value SEPARATE_CONTENT_BIDS_NOT_ENABLED
      23. value TOO_MANY_FRACTION_DIGITS
    14. enum BiddingTransitionError.Reason
      1. + value INCOMPATIBLE_WITH_CAMPAIGN_SETTING
    15. type Campaign
      1. + field networkSetting
      2. + field settings
    16. enum CampaignCriterionLimitExceeded.CriteriaLimitType
      1. + value CAMPAIGN_CRITERIA
    17. type CriterionError
      1. + field reason
    18. type CriterionUserList
      1. field userListSize
    19. enum DeprecatedAd.Type
      1. + value LOCAL_BUSINESS_AD
      2. + value UNKNOWN
    20. enum DistinctError.Reason
      1. + value DUPLICATE_TYPE
    21. type JobSelector
      1. field customerJobKeys
      2. field includeJobsSubmittedByOtherUsers
    22. enum MediaError.Reason
      1. + value CANNOT_SELECT_STANDARD_ICON_WITH_OTHER_TYPES
    23. type MobileExtension
      1. + field isCallOnly
    24. enum OperationAccessDenied.Reason
      1. + value MUTATE_ACTION_NOT_PERMITTED_FOR_CLIENT
    25. enum QuotaError.Reason
      1. + value TOO_MANY_CRITERIA_PER_ACCOUNT
      2. + value UNKNOWN
    26. type SelectorError
      1. + field reason
    27. type SettingError
      1. + field reason
    28. type Stats
      1. + field invalidClickRate
      2. + field invalidClicks
    29. enum TemplateElementField.Type
      1. + value NUMBER
    30. type LocalBusinessAd
    31. type NetworkTarget
  12. CampaignAdExtensionService (2 new, 8 changed, 0 removed)
    1. + type SelectorError
    2. + enum SelectorError.Reason
    3. enum AdExtensionError.Reason
      1. + value DISALLOWED_NUMBER_TYPE
    4. enum DistinctError.Reason
      1. + value DUPLICATE_TYPE
    5. type MobileExtension
      1. + field isCallOnly
    6. enum OperationAccessDenied.Reason
      1. + value MUTATE_ACTION_NOT_PERMITTED_FOR_CLIENT
    7. type Selector
      1. + field ordering
      2. + field paging
    8. type SelectorError
      1. + field reason
    9. type Stats
      1. + field invalidClickRate
      2. + field invalidClicks
    10. operation get
      1. + parameter serviceSelector
      2. parameter selector
  13. CampaignCriterionService (4 new, 8 changed, 0 removed)
    1. + type CriterionError
    2. + enum CriterionError.Reason
    3. + type SelectorError
    4. + enum SelectorError.Reason
    5. enum CampaignCriterionLimitExceeded.CriteriaLimitType
      1. + value CAMPAIGN_CRITERIA
    6. type CriterionError
      1. + field reason
    7. type CriterionUserList
      1. field userListSize
    8. enum DistinctError.Reason
      1. + value DUPLICATE_TYPE
    9. enum OperationAccessDenied.Reason
      1. + value MUTATE_ACTION_NOT_PERMITTED_FOR_CLIENT
    10. type Selector
      1. + field ordering
      2. + field paging
    11. type SelectorError
      1. + field reason
    12. operation get
      1. + parameter serviceSelector
      2. parameter selector
  14. CampaignService (6 new, 10 changed, 0 removed)
    1. + type GeoTargetTypeSetting
    2. + type RealTimeBiddingSetting
    3. + type SelectorError
    4. + enum SelectorError.Reason
    5. + type SettingError
    6. + enum SettingError.Reason
    7. enum BiddingTransitionError.Reason
      1. + value INCOMPATIBLE_WITH_CAMPAIGN_SETTING
    8. type Campaign
      1. + field networkSetting
      2. + field settings
    9. enum DistinctError.Reason
      1. + value DUPLICATE_TYPE
    10. enum OperationAccessDenied.Reason
      1. + value MUTATE_ACTION_NOT_PERMITTED_FOR_CLIENT
    11. enum QuotaError.Reason
      1. + value TOO_MANY_CRITERIA_PER_ACCOUNT
      2. + value UNKNOWN
    12. type Selector
      1. + field ordering
      2. + field paging
    13. type SelectorError
      1. + field reason
    14. type SettingError
      1. + field reason
    15. type Stats
      1. + field invalidClickRate
      2. + field invalidClicks
    16. operation get
      1. + parameter serviceSelector
      2. parameter selector
  15. CampaignTargetService (0 new, 3 changed, 1 removed)
    1. enum DistinctError.Reason
      1. + value DUPLICATE_TYPE
    2. enum OperationAccessDenied.Reason
      1. + value MUTATE_ACTION_NOT_PERMITTED_FOR_CLIENT
    3. enum QuotaError.Reason
      1. + value TOO_MANY_CRITERIA_PER_ACCOUNT
      2. + value UNKNOWN
    4. type NetworkTarget
  16. CustomerSyncService (0 new, 1 changed, 0 removed)
    1. enum DistinctError.Reason
      1. + value DUPLICATE_TYPE
  17. ExperimentService (2 new, 8 changed, 0 removed)
    1. + type SelectorError
    2. + enum SelectorError.Reason
    3. enum DistinctError.Reason
      1. + value DUPLICATE_TYPE
    4. enum ExperimentServiceError.Reason
      1. + value CANNOT_CREATE_EXPERIMENT_FOR_BIDDING_STRATEGY_FEATURE
      2. + value CANNOT_SET_END_DATE_WITHOUT_SETTING_START_DATE
    5. type ExperimentSummaryStats
      1. + field adGroupAdsCount
    6. enum OperationAccessDenied.Reason
      1. + value MUTATE_ACTION_NOT_PERMITTED_FOR_CLIENT
    7. enum QuotaError.Reason
      1. + value TOO_MANY_CRITERIA_PER_ACCOUNT
      2. + value UNKNOWN
    8. type Selector
      1. + field ordering
      2. + field paging
    9. type SelectorError
      1. + field reason
    10. operation get
      1. + parameter serviceSelector
      2. parameter selector
  18. = GeoLocationService (no changes)
  19. = InfoService (no changes)
  20. MediaService (2 new, 5 changed, 0 removed)
    1. + type SelectorError
    2. + enum SelectorError.Reason
    3. enum MediaError.Reason
      1. + value CANNOT_SELECT_STANDARD_ICON_WITH_OTHER_TYPES
    4. enum OperationAccessDenied.Reason
      1. + value MUTATE_ACTION_NOT_PERMITTED_FOR_CLIENT
    5. type Selector
      1. + field ordering
      2. + field paging
    6. type SelectorError
      1. + field reason
    7. operation get
      1. + parameter serviceSelector
      2. parameter selector
  21. ReportDefinitionService (6 new, 10 changed, 0 removed)
    1. + type ClientSelector
    2. + type DatabaseError
    3. + enum DatabaseError.Reason
    4. + type EnumValuePair
    5. + type SelectorError
    6. + enum SelectorError.Reason
    7. type DatabaseError
      1. + field reason
    8. enum DistinctError.Reason
      1. + value DUPLICATE_TYPE
    9. type ReportDefinition
      1. + field clientSelectors
      2. + field crossClient
    10. enum ReportDefinition.DateRangeType
      1. + value THIS_WEEK_SUN_TODAY
      2. + value THIS_WEEK_MON_TODAY
      3. + value LAST_WEEK_SUN_SAT
    11. enum ReportDefinition.ReportType
      1. + value DEMOGRAPHIC_PERFORMANCE_REPORT
      2. + value GEO_PERFORMANCE_REPORT
      3. + value AD_EXTENSIONS_PERFORMANCE_REPORT
      4. + value DESTINATION_URL_REPORT
      5. + value CREATIVE_CONVERSION_REPORT
      6. + value UNKNOWN
    12. enum ReportDefinitionError.Reason
      1. + value SORTING_NOT_SUPPORTED
      2. + value PAGING_NOT_SUPPORTED
      3. + value CUSTOMER_SERVING_TYPE_REPORT_MISMATCH
    13. type ReportDefinitionField
      1. + field enumValuePairs
    14. type ReportDefinitionSelector
      1. + field definitionIds
    15. type Selector
      1. + field ordering
      2. + field paging
    16. type SelectorError
      1. + field reason
  22. ServicedAccountService (0 new, 1 changed, 0 removed)
    1. type Account
      1. + field currencyCode
      2. + field dateTimeZone
  23. TargetingIdeaService (12 new, 6 changed, 1 removed)
    1. + type AdGroupBidLandscape
    2. + enum AdGroupBidLandscape.Type
    3. + type BidLandscape
    4. + type BidLandscape.LandscapePoint
    5. + type BidLandscapeAttribute
    6. + type CriterionAttribute
    7. + type CriterionBidLandscape
    8. + type CurrencyCodeError
    9. + type DataEntry
    10. + type DeviceTypeSearchParameter
    11. + enum OpportunityIdeaType
    12. + type OpportunityIdeaTypeAttribute
    13. type AdGroupBidLandscape
      1. + field type
    14. enum AttributeType
      1. + value CRITERION
      2. value KEYWORD
      3. value PLACEMENT
    15. type CriterionUserList
      1. field userListSize
    16. enum DistinctError.Reason
      1. + value DUPLICATE_TYPE
    17. type OpportunityIdeaTypeAttribute
      1. + field value
    18. enum TrafficEstimatorError.Reason
      1. + value TOO_MANY_CAMPAIGN_ESTIMATE_REQUESTS
      2. + value TOO_MANY_ADGROUP_ESTIMATE_REQUESTS
      3. + value TOO_MANY_TARGETS
    19. type MobileSearchParameter
  24. TrafficEstimatorService (2 new, 5 changed, 1 removed)
    1. + type CurrencyCodeError
    2. + enum CurrencyCodeError.Reason
    3. type CurrencyCodeError
      1. + field reason
    4. enum DistinctError.Reason
      1. + value DUPLICATE_TYPE
    5. enum OperationAccessDenied.Reason
      1. + value MUTATE_ACTION_NOT_PERMITTED_FOR_CLIENT
    6. type StatsEstimate
      1. + field clicksPerDay
      2. field clicks
    7. enum TrafficEstimatorError.Reason
      1. + value TOO_MANY_CAMPAIGN_ESTIMATE_REQUESTS
      2. + value TOO_MANY_ADGROUP_ESTIMATE_REQUESTS
      3. + value TOO_MANY_TARGETS
    8. type NetworkTarget
  25. UserListService (16 new, 15 changed, 0 removed)
    1. + type ClientTermsError
    2. + enum ClientTermsError.Reason
    3. + type DistinctError
    4. + enum DistinctError.Reason
    5. + type NotWhitelistedError
    6. + enum NotWhitelistedError.Reason
    7. + type QuotaCheckError
    8. + enum QuotaCheckError.Reason
    9. + type RateExceededError
    10. + enum RateExceededError.Reason
    11. + type RequestError
    12. + enum RequestError.Reason
    13. + type SelectorError
    14. + enum SelectorError.Reason
    15. + type SizeLimitError
    16. + enum SizeLimitError.Reason
    17. type ClientTermsError
      1. + field reason
    18. type DistinctError
      1. + field reason
    19. enum DistinctError.Reason
      1. + value DUPLICATE_TYPE
    20. type NotWhitelistedError
      1. + field reason
    21. enum OperationAccessDenied.Reason
      1. + value MUTATE_ACTION_NOT_PERMITTED_FOR_CLIENT
    22. type QuotaCheckError
      1. + field reason
    23. type RateExceededError
      1. + field reason
    24. type RequestError
      1. + field reason
    25. type Selector
      1. + field ordering
      2. + field paging
    26. type SelectorError
      1. + field reason
    27. type SizeLimitError
      1. + field reason
    28. type UserList
      1. + field accessReason
      2. + field accountUserListStatus
    29. enum UserListError.Reason
      1. + value USER_LIST_MUTATE_NOT_SUPPORTED
    30. type UserListSelector
      1. + field accessReasons
    31. operation get
      1. + parameter serviceSelector
      2. parameter selector

v201008

What's New

Reporting improvements
ReportDefinitionService is now out of beta (see the rate sheet for adjusted creation and update costs). The getReportFields operation now returns the human-readable name and XML attribute for each available field, and Account Performance Reports are now available. Support for cross-client reports is expected in the next version of the API.
Traffic estimates
A new version of TrafficEstimatorService provides traffic estimates for keywords and supplants the legacy v13 service.
My Client Center (MCC) features
Use ServicedAccountService to retrieve the hierarchy of accounts managed by your MCC account. Use AlertService to get alerts for managed accounts.
Product Listing Ads support
Use a campaign product extension in combination with product ads to serve rich product ads from your Google Merchant Center account. Currently, you must use the AdWords web interface and the Google Merchant Center to create the actual product ads. For more information, see the product ads announcement and AdWords Help Center.
AdWords Campaign Experiments (ACE) support
Use ExperimentService to accurately test and measure changes to your keywords, bids, ad groups and placements with experiment and control campaigns. For more information about campaign experiments, see the AdWords campaign experiments overview.
Remarketing
Use UserListService and user list criteria to display ads to users that have previously expressed interest in your website. For more information about remarketing, see the AdWords Help Center.
Ad group bid landscapes
You can now use BidLandscapeService to return bid simulation data for entire ad groups. For each ad group, two simulations are returned: A UNIFORM simulation where a the simulated default bid overrides child criteria bids, and a DEFAULT simulation where the existing criteria bids are used.
Enhanced CPC
When using a manual CPC or Budget Optimizer bidding strategy, enable enhanced CPC to dynamically adjust your bid based on the likelihood that your ad will convert. For more information, see the Enhanced CPC overview.
Change history (beta)
Use CustomerSyncService to find out which campaign data was changed over a specified date range.
Partial failure support (beta, AdGroupCriterionService only)
Use the partialFailure SOAP request header to commit as many error-free operations as possible. Partial failure support is currently only available for AdGroupCriterionService.

API Changes

  1. + AlertService
  2. + CustomerSyncService
  3. + ExperimentService
  4. + ServicedAccountService
  5. + TrafficEstimatorService
  6. + UserListService
  7. AdExtensionOverrideService (3 new, 2 changed, 0 removed)
    1. + type ProductCondition
    2. + type ProductConditionOperand
    3. + type ProductExtension
    4. type ProductCondition
      1. + field operand
    5. type Stats
      1. + field totalConvValue
      2. + field valuePerConv
      3. + field valuePerConvManyPerClick
      4. + field viewThroughConversions
  8. AdGroupAdService (1 new, 9 changed, 0 removed)
    1. + type ProductAd
    2. enum AdError.Reason
      1. + value BAD_SNIPPET
      2. + value CANNOT_SET_URL
    3. enum EntityCountLimitExceeded.Reason
      1. + value ADGROUP_TEXT_AD_LIMIT
      2. + value ADGROUP_DISPLAY_AD_LIMIT
      3. + value UNKNOWN
    4. type ImageAd
      1. + field adToCopyImageFrom
    5. type Media
      1. + field type
      2. field extendedCapabilities
      3. field mediaSubType
      4. field mediaTypeDb
    6. enum Media.MediaSubType
      1. + value EXTERNALLY_HOSTED
    7. enum Media.MediaType
      1. value HTML
      2. value VIDEO_IMAGE
    8. enum MediaError.Reason
      1. + value INVALID_YOU_TUBE_ID
      2. + value YOU_TUBE_VIDEO_NOT_FOUND
      3. + value YOU_TUBE_SERVICE_UNAVAILABLE
    9. type Stats
      1. + field totalConvValue
      2. + field valuePerConv
      3. + field valuePerConvManyPerClick
      4. + field viewThroughConversions
    10. type Video
      1. + field youTubeVideoIdString
  9. AdGroupCriterionService (6 new, 7 changed, 0 removed)
    1. + type CriterionUserInterest
    2. + type CriterionUserList
    3. + type PercentCPAAdGroupCriterionBids
    4. + type Product
    5. + type ProductCondition
    6. + type ProductConditionOperand
    7. enum AdGroupCriterionError.Reason
      1. + value CANNOT_EXCLUDE_CRITERIA_TYPE
      2. + value PRODUCT_FILTER_TOO_LONG
      3. + value INVALID_PRODUCT_FILTER
    8. type AdGroupCriterionReturnValue
      1. + field partialFailureErrors
    9. type AdGroupCriterionSelector
      1. + field experimentId
    10. type BiddableAdGroupCriterion
      1. + field experimentData
    11. enum EntityCountLimitExceeded.Reason
      1. + value ADGROUP_TEXT_AD_LIMIT
      2. + value ADGROUP_DISPLAY_AD_LIMIT
      3. + value UNKNOWN
    12. type ProductCondition
      1. + field operand
    13. type Stats
      1. + field totalConvValue
      2. + field valuePerConv
      3. + field valuePerConvManyPerClick
      4. + field viewThroughConversions
  10. AdGroupService (1 new, 4 changed, 0 removed)
    1. + type PercentCPAAdGroupBids
    2. type AdGroup
      1. + field experimentData
    3. type AdGroupSelector
      1. + field adGroupStatuses
      2. + field experimentId
    4. type AdGroupServiceError
      1. + field adGroupId
    5. type Stats
      1. + field totalConvValue
      2. + field valuePerConv
      3. + field valuePerConvManyPerClick
      4. + field viewThroughConversions
  11. AdParamService (2 new, 1 changed, 0 removed)
    1. + type DistinctError
    2. + enum DistinctError.Reason
    3. type DistinctError
      1. + field reason
  12. BidLandscapeService (4 new, 1 changed, 0 removed)
    1. + type AdGroupBidLandscape
    2. + type AdGroupBidLandscapeSelector
    3. + type EntityNotFound
    4. + enum EntityNotFound.Reason
    5. type EntityNotFound
      1. + field reason
  13. BulkMutateJobService (23 new, 32 changed, 1 removed)
    1. + type AdExtensionError
    2. + enum AdExtensionError.Reason
    3. + type AdExtensionOverrideError
    4. + enum AdExtensionOverrideError.Reason
    5. + type AdExtensionOverrideOperation
    6. + type CampaignAdExtension
    7. + enum CampaignAdExtension.ApprovalStatus
    8. + enum CampaignAdExtension.Status
    9. + type CampaignAdExtensionError
    10. + enum CampaignAdExtensionError.Reason
    11. + type CampaignAdExtensionOperation
    12. + type CampaignAdExtensionStats
    13. + type ConversionOptimizerEligibility
    14. + type CriterionUserInterest
    15. + type CriterionUserList
    16. + type PercentCPA
    17. + type PercentCPAAdGroupBids
    18. + type PercentCPAAdGroupCriterionBids
    19. + type Product
    20. + type ProductAd
    21. + type ProductCondition
    22. + type ProductConditionOperand
    23. + type ProductExtension
    24. enum AdError.Reason
      1. + value BAD_SNIPPET
      2. + value CANNOT_SET_URL
    25. type AdExtensionError
      1. + field reason
    26. enum AdExtensionError.Reason
      1. + value AD_EXTENSION_NO_LONGER_ACTIVE
      2. + value CANNOT_HAVE_MULTIPLE_PRODUCT_EXTENSIONS_PER_CAMPAIGN
      3. + value INVALID_ENUM_CONDITION_OPERATOR
      4. + value INVALID_STRING_CONDITION_OPERATOR
      5. + value MISSING_CONDITION_OPERAND
      6. + value MISSING_CONDITION_STRING_VALUE
      7. + value NUM_AND_GROUPS_OVER_LIMIT
      8. + value NUM_CONDITIONS_OVER_LIMIT
      9. + value NOT_AUTHORIZED_TO_CREATE_EXTENSION
    27. type AdExtensionOverrideError
      1. + field reason
    28. type AdGroup
      1. + field experimentData
    29. enum AdGroupCriterionError.Reason
      1. + value CANNOT_EXCLUDE_CRITERIA_TYPE
      2. + value PRODUCT_FILTER_TOO_LONG
      3. + value INVALID_PRODUCT_FILTER
    30. type AdGroupServiceError
      1. + field adGroupId
    31. type BiddableAdGroupCriterion
      1. + field experimentData
    32. enum BiddingTransitionError.Reason
      1. + value IS_PERCENT_CPA_CAMPAIGN
      2. + value HAS_ACTIVE_EXPERIMENT
    33. type BudgetOptimizer
      1. + field enhancedCpcEnabled
    34. type Campaign
      1. + field conversionOptimizerEligibility
      2. field autoKeywordMatchingStatus
    35. type CampaignAdExtension
      1. + field approvalStatus
      2. + field stats
      3. + field status
    36. type CampaignAdExtensionError
      1. + field reason
    37. enum CampaignAdExtensionError.Reason
      1. + value MUST_USE_CONCRETE_ADEXTENSION
      2. + value UNKNOWN_ERROR
    38. type CampaignAdExtensionOperation
      1. + field operand
    39. enum CampaignError.Reason
      1. + value CANNOT_SET_BUDGET
    40. enum EntityCountLimitExceeded.Reason
      1. + value ADGROUP_TEXT_AD_LIMIT
      2. + value ADGROUP_DISPLAY_AD_LIMIT
      3. + value UNKNOWN
    41. type ImageAd
      1. + field adToCopyImageFrom
    42. enum JobError.Reason
      1. + value TOO_LATE_TO_CANCEL_JOB
      2. + value USER_CANCELED_JOB
      3. + value UNKNOWN
    43. type JobSelector
      1. + field includeJobsSubmittedByOtherUsers
    44. enum LoasAuthenticationError.Reason
      1. value UNKNOWN
    45. type ManualCPC
      1. + field enhancedCpcEnabled
    46. type Media
      1. + field type
      2. field extendedCapabilities
      3. field mediaSubType
      4. field mediaTypeDb
    47. enum Media.MediaSubType
      1. + value EXTERNALLY_HOSTED
    48. enum Media.MediaType
      1. value HTML
      2. value VIDEO_IMAGE
    49. enum MediaError.Reason
      1. + value INVALID_YOU_TUBE_ID
      2. + value YOU_TUBE_VIDEO_NOT_FOUND
      3. + value YOU_TUBE_SERVICE_UNAVAILABLE
    50. enum NetworkCoverageType
      1. + value UNKNOWN
    51. enum PlatformType
      1. + value UNKNOWN
    52. type ProductCondition
      1. + field operand
    53. type Stats
      1. + field totalConvValue
      2. + field valuePerConv
      3. + field valuePerConvManyPerClick
      4. + field viewThroughConversions
    54. enum TargetError.Reason
      1. + value CANNOT_TARGET_CONTENT_CONTEXTUAL_WITHOUT_CONTENT_NETWORK
      2. + value INVALID_EXCLUDED_POLYGON_TARGET
      3. + value INVALID_EXCLUDED_PROXIMITY_TARGET
    55. type Video
      1. + field youTubeVideoIdString
    56. enum LoasAuthenticationError.Reason
  14. CampaignAdExtensionService (7 new, 7 changed, 0 removed)
    1. + type NewEntityCreationError
    2. + enum NewEntityCreationError.Reason
    3. + type ProductCondition
    4. + type ProductConditionOperand
    5. + type ProductExtension
    6. + type RejectedError
    7. + enum RejectedError.Reason
    8. enum AdExtensionError.Reason
      1. + value AD_EXTENSION_NO_LONGER_ACTIVE
      2. + value CANNOT_HAVE_MULTIPLE_PRODUCT_EXTENSIONS_PER_CAMPAIGN
      3. + value INVALID_ENUM_CONDITION_OPERATOR
      4. + value INVALID_STRING_CONDITION_OPERATOR
      5. + value MISSING_CONDITION_OPERAND
      6. + value MISSING_CONDITION_STRING_VALUE
      7. + value NUM_AND_GROUPS_OVER_LIMIT
      8. + value NUM_CONDITIONS_OVER_LIMIT
      9. + value NOT_AUTHORIZED_TO_CREATE_EXTENSION
    9. type CampaignAdExtension
      1. + field stats
    10. enum CampaignAdExtensionError.Reason
      1. + value MUST_USE_CONCRETE_ADEXTENSION
      2. + value UNKNOWN_ERROR
    11. type NewEntityCreationError
      1. + field reason
    12. type ProductCondition
      1. + field operand
    13. type RejectedError
      1. + field reason
    14. type Stats
      1. + field totalConvValue
      2. + field valuePerConv
      3. + field valuePerConvManyPerClick
      4. + field viewThroughConversions
  15. CampaignCriterionService (5 new, 2 changed, 0 removed)
    1. + type CriterionUserInterest
    2. + type CriterionUserList
    3. + type Product
    4. + type ProductCondition
    5. + type ProductConditionOperand
    6. enum EntityCountLimitExceeded.Reason
      1. + value ADGROUP_TEXT_AD_LIMIT
      2. + value ADGROUP_DISPLAY_AD_LIMIT
      3. + value UNKNOWN
    7. type ProductCondition
      1. + field operand
  16. CampaignService (3 new, 6 changed, 0 removed)
    1. + type ConversionOptimizerEligibility
    2. + type PercentCPA
    3. + type PercentCPAAdGroupBids
    4. enum BiddingTransitionError.Reason
      1. + value IS_PERCENT_CPA_CAMPAIGN
      2. + value HAS_ACTIVE_EXPERIMENT
    5. type BudgetOptimizer
      1. + field enhancedCpcEnabled
    6. type Campaign
      1. + field conversionOptimizerEligibility
      2. field autoKeywordMatchingStatus
    7. enum CampaignError.Reason
      1. + value CANNOT_SET_BUDGET
    8. type ManualCPC
      1. + field enhancedCpcEnabled
    9. type Stats
      1. + field totalConvValue
      2. + field valuePerConv
      3. + field valuePerConvManyPerClick
      4. + field viewThroughConversions
  17. CampaignTargetService (0 new, 4 changed, 0 removed)
    1. enum CampaignError.Reason
      1. + value CANNOT_SET_BUDGET
    2. enum NetworkCoverageType
      1. + value UNKNOWN
    3. enum PlatformType
      1. + value UNKNOWN
    4. enum TargetError.Reason
      1. + value CANNOT_TARGET_CONTENT_CONTEXTUAL_WITHOUT_CONTENT_NETWORK
      2. + value INVALID_EXCLUDED_POLYGON_TARGET
      3. + value INVALID_EXCLUDED_PROXIMITY_TARGET
  18. = GeoLocationService (no changes)
  19. = InfoService (no changes)
  20. MediaService (0 new, 7 changed, 0 removed)
    1. type Media
      1. + field type
      2. field extendedCapabilities
      3. field mediaSubType
      4. field mediaTypeDb
    2. enum Media.MediaSubType
      1. + value EXTERNALLY_HOSTED
    3. enum Media.MediaType
      1. value HTML
      2. value VIDEO_IMAGE
    4. enum MediaError.Reason
      1. + value INVALID_YOU_TUBE_ID
      2. + value YOU_TUBE_VIDEO_NOT_FOUND
      3. + value YOU_TUBE_SERVICE_UNAVAILABLE
    5. type MediaPage
      1. + field entries
      2. field media
    6. type MediaSelector
      1. + field mediaDimensions
      2. + field youTubeVideoIds
      3. field extendedCapabilityTypes
      4. field mediaSubType
    7. type Video
      1. + field youTubeVideoIdString
  21. ReportDefinitionService (4 new, 5 changed, 0 removed)
    1. + type DateError
    2. + enum DateError.Reason
    3. + type NotEmptyError
    4. + enum NotEmptyError.Reason
    5. type DateError
      1. + field reason
    6. type NotEmptyError
      1. + field reason
    7. enum ReportDefinition.DateRangeType
      1. + value LAST_14_DAYS
      2. + value LAST_30_DAYS
    8. enum ReportDefinition.ReportType
      1. + value ACCOUNT_PERFORMANCE_REPORT
      2. value ADGROUP_NEGATIVE_KEYWORDS_PERFORMANCE_REPORT
      3. value ADGROUP_NEGATIVE_PLACEMENTS_PERFORMANCE_REPORT
    9. type ReportDefinitionField
      1. + field displayFieldName
      2. + field xmlAttributeName
  22. TargetingIdeaService (2 new, 6 changed, 0 removed)
    1. + type MatchesRegexError
    2. + enum MatchesRegexError.Reason
    3. enum AdGroupCriterionError.Reason
      1. + value CANNOT_EXCLUDE_CRITERIA_TYPE
      2. + value PRODUCT_FILTER_TOO_LONG
      3. + value INVALID_PRODUCT_FILTER
    4. type DoubleComparisonOperation
      1. field excludes
    5. enum EntityCountLimitExceeded.Reason
      1. + value ADGROUP_TEXT_AD_LIMIT
      2. + value ADGROUP_DISPLAY_AD_LIMIT
      3. + value UNKNOWN
    6. type LongComparisonOperation
      1. field excludes
    7. type MatchesRegexError
      1. + field reason
    8. enum TargetError.Reason
      1. + value CANNOT_TARGET_CONTENT_CONTEXTUAL_WITHOUT_CONTENT_NETWORK
      2. + value INVALID_EXCLUDED_POLYGON_TARGET
      3. + value INVALID_EXCLUDED_PROXIMITY_TARGET

v201003

What's New

Reporting functionality (beta)
Use ReportDefinitionService to create customized reports about your campaign performance.
Bid simulator
Use BidLandscapeService to get estimates of how your ads might perform with different maximum bids.
Media uploading for location extensions
Use MediaService to upload images and icons for location extensions.
Sitelinks extensions
Use a SitelinksExtension to include up to four additional links in your ads to deeper content on your site.
Location sync extensions
Use a LocationSyncExtension to synchronize your location extensions with Google Places (formerly Local Business Center) listings.
Phone extensions
Use a MobileExtension to add a phone number to your text ads when they appear on high-end mobile devices.
Content network targeting by category
Use the new Vertical criterion to target placements on the content network based on their category.
Mobile carrier and device targeting
Use MobileCarrierTarget and MobilePlatformTarget to target your campaigns for specific carriers and devices, respectively.
Position preference
Enable position preference for your campaign and then for your criteria to specify the range of positions in which your ads can be displayed.
Target CPA bidding
Set the conversionOptimizerBidType field to TARGET_CPA to bid based on the average amount (instead of the maximum amount) you'd like to pay per acquisition / conversion.
Minimum bulk mutate job size
Starting in v201003, asynchronous jobs scheduled with BulkMutateJobService must contain at least 100 operations.

API Changes

  1. + BidLandscapeService
  2. + MediaService
  3. + ReportDefinitionService
  4. AdExtensionOverrideService (8 new, 8 changed, 1 removed)
    1. + type DatabaseError
    2. + enum DatabaseError.Reason
    3. + type LocationSyncExtension
    4. + type MobileExtension
    5. + type RateExceededError
    6. + enum RateExceededError.Reason
    7. + type RequestError
    8. + type SitelinksExtension
    9. type ApiError
      1. + field errorString
    10. type DatabaseError
      1. + field reason
    11. enum DatabaseError.Reason
      1. + value DUPLICATE_KEY
      2. + value DATABASE_ERROR
      3. + value UNKNOWN
    12. enum InternalApiError.Reason
      1. + value UNKNOWN
    13. enum QuotaCheckError.Reason
      1. + value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED
      2. value INCOMPLETE_SIGNUP_APP_INFO_MISSING
      3. value INCOMPLETE_SIGNUP_APP_INFO_PENDING
      4. value INCOMPLETE_SIGNUP_APP_INFO_REJECTED
      5. value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
    14. type RateExceededError
      1. + field reason
    15. enum SizeLimitError.Reason
      1. + value UNKNOWN
    16. enum Stats.Network
      1. + value UNKNOWN
    17. type QuotaExceededError
  5. AdGroupAdService (5 new, 13 changed, 1 removed)
    1. + type RateExceededError
    2. + enum RateExceededError.Reason
    3. + type RequestError
    4. + type RichMediaAd
    5. + type ThirdPartyRedirectAd
    6. type Ad
      1. + field trademarkDisapproved
    7. enum AdError.Reason
      1. + value DISPLAY_URL_CANNOT_BE_SPECIFIED
      2. + value INVALID_RICH_MEDIA_CERTIFIED_VENDOR_FORMAT_ID
      3. + value URL_HOST_NAME_TOO_LONG
    8. type AdGroupAdSelector
      1. + field statuses
    9. type ApiError
      1. + field errorString
    10. enum DatabaseError.Reason
      1. + value DUPLICATE_KEY
      2. + value DATABASE_ERROR
      3. + value UNKNOWN
    11. enum InternalApiError.Reason
      1. + value UNKNOWN
    12. enum OperationAccessDenied.Reason
      1. + value UNKNOWN
    13. enum PagingError.Reason
      1. + value UNKNOWN
    14. enum QuotaCheckError.Reason
      1. + value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED
      2. value INCOMPLETE_SIGNUP_APP_INFO_MISSING
      3. value INCOMPLETE_SIGNUP_APP_INFO_PENDING
      4. value INCOMPLETE_SIGNUP_APP_INFO_REJECTED
      5. value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
    15. type RateExceededError
      1. + field reason
    16. type RichMediaAd
      1. + field adDuration
      2. + field expandable
      3. field adDuration
      4. field expandable
    17. enum SizeLimitError.Reason
      1. + value UNKNOWN
    18. enum Stats.Network
      1. + value UNKNOWN
    19. type QuotaExceededError
  6. AdGroupCriterionService (6 new, 14 changed, 1 removed)
    1. + type RateExceededError
    2. + enum RateExceededError.Reason
    3. + type RejectedError
    4. + enum RejectedError.Reason
    5. + type RequestError
    6. + type Vertical
    7. enum AdGroupCriterionError.Reason
      1. + value INAPPLICABLE_FOR_NEGATIVE
      2. + value INVALID_VERTICAL_PATH
      3. + value CANNOT_ADD_CRITERIA_TYPE
      4. + value UNKNOWN
    8. type ApiError
      1. + field errorString
    9. enum BiddingError.Reason
      1. + value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_TARGET_CPA
      2. + value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_MANY_PER_CLICK
      3. + value TARGET_CPA_NOT_AVAILABLE_FOR_CUSTOMER
      4. + value MANY_PER_CLICK_NOT_AVAILABLE_FOR_CUSTOMER
      5. + value CANNOT_SET_SITE_MAX_CPC
      6. + value BID_ERROR
    10. type BudgetOptimizerAdGroupCriterionBids
      1. + field enhancedCpcEnabled
    11. enum DatabaseError.Reason
      1. + value DUPLICATE_KEY
      2. + value DATABASE_ERROR
      3. + value UNKNOWN
    12. enum InternalApiError.Reason
      1. + value UNKNOWN
    13. type ManualCPCAdGroupCriterionBids
      1. + field enhancedCpcEnabled
    14. enum OperationAccessDenied.Reason
      1. + value UNKNOWN
    15. enum PagingError.Reason
      1. + value UNKNOWN
    16. enum QuotaCheckError.Reason
      1. + value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED
      2. value INCOMPLETE_SIGNUP_APP_INFO_MISSING
      3. value INCOMPLETE_SIGNUP_APP_INFO_PENDING
      4. value INCOMPLETE_SIGNUP_APP_INFO_REJECTED
      5. value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
    17. type RateExceededError
      1. + field reason
    18. type RejectedError
      1. + field reason
    19. enum SizeLimitError.Reason
      1. + value UNKNOWN
    20. enum Stats.Network
      1. + value UNKNOWN
    21. type QuotaExceededError
  7. AdGroupService (5 new, 14 changed, 1 removed)
    1. + type RateExceededError
    2. + enum RateExceededError.Reason
    3. + type RejectedError
    4. + enum RejectedError.Reason
    5. + type RequestError
    6. type AdGroupSelector
      1. + field campaignIds
      2. field campaignId
    7. type ApiError
      1. + field errorString
    8. enum BiddingError.Reason
      1. + value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_TARGET_CPA
      2. + value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_MANY_PER_CLICK
      3. + value TARGET_CPA_NOT_AVAILABLE_FOR_CUSTOMER
      4. + value MANY_PER_CLICK_NOT_AVAILABLE_FOR_CUSTOMER
      5. + value CANNOT_SET_SITE_MAX_CPC
      6. + value BID_ERROR
    9. type BudgetOptimizerAdGroupBids
      1. + field enhancedCpcEnabled
    10. type ConversionOptimizerAdGroupBids
      1. + field conversionOptimizerBidType
      2. + field deduplicationMode
    11. enum DatabaseError.Reason
      1. + value DUPLICATE_KEY
      2. + value DATABASE_ERROR
      3. + value UNKNOWN
    12. enum InternalApiError.Reason
      1. + value UNKNOWN
    13. type ManualCPCAdGroupBids
      1. + field enhancedCpcEnabled
    14. enum OperationAccessDenied.Reason
      1. + value UNKNOWN
    15. enum QuotaCheckError.Reason
      1. + value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED
      2. value INCOMPLETE_SIGNUP_APP_INFO_MISSING
      3. value INCOMPLETE_SIGNUP_APP_INFO_PENDING
      4. value INCOMPLETE_SIGNUP_APP_INFO_REJECTED
      5. value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
    16. type RateExceededError
      1. + field reason
    17. type RejectedError
      1. + field reason
    18. enum SizeLimitError.Reason
      1. + value UNKNOWN
    19. enum Stats.Network
      1. + value UNKNOWN
    20. type QuotaExceededError
  8. AdParamService (3 new, 7 changed, 1 removed)
    1. + type RateExceededError
    2. + enum RateExceededError.Reason
    3. + type RequestError
    4. enum AdParamError.Reason
      1. + value UNKNOWN
    5. type ApiError
      1. + field errorString
    6. enum DatabaseError.Reason
      1. + value DUPLICATE_KEY
      2. + value DATABASE_ERROR
      3. + value UNKNOWN
    7. enum InternalApiError.Reason
      1. + value UNKNOWN
    8. enum QuotaCheckError.Reason
      1. + value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED
      2. value INCOMPLETE_SIGNUP_APP_INFO_MISSING
      3. value INCOMPLETE_SIGNUP_APP_INFO_PENDING
      4. value INCOMPLETE_SIGNUP_APP_INFO_REJECTED
      5. value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
    9. type RateExceededError
      1. + field reason
    10. enum SizeLimitError.Reason
      1. + value UNKNOWN
    11. type QuotaExceededError
  9. BulkMutateJobService (16 new, 32 changed, 1 removed)
    1. + type CampaignStats
    2. + type LocationSyncExtension
    3. + type MobileCarrierTarget
    4. + type MobileExtension
    5. + type MobilePlatformTarget
    6. + type MobileTarget
    7. + type MobileTargetList
    8. + type RateExceededError
    9. + enum RateExceededError.Reason
    10. + type RejectedError
    11. + enum RejectedError.Reason
    12. + type RequestError
    13. + type RichMediaAd
    14. + type SitelinksExtension
    15. + type ThirdPartyRedirectAd
    16. + type Vertical
    17. type Ad
      1. + field trademarkDisapproved
    18. enum AdError.Reason
      1. + value DISPLAY_URL_CANNOT_BE_SPECIFIED
      2. + value INVALID_RICH_MEDIA_CERTIFIED_VENDOR_FORMAT_ID
      3. + value URL_HOST_NAME_TOO_LONG
    19. enum AdExtensionError.Reason
      1. + value CANNOT_HAVE_MULTIPLE_MOBILE_EXTENSIONS_PER_CAMPAIGN
      2. + value INVALID_ICON_DIMENSIONS
      3. + value INVALID_IMAGE_DIMENSIONS
      4. + value INVALID_INPUT
    20. enum AdGroupCriterionError.Reason
      1. + value INAPPLICABLE_FOR_NEGATIVE
      2. + value INVALID_VERTICAL_PATH
      3. + value CANNOT_ADD_CRITERIA_TYPE
      4. + value UNKNOWN
    21. type ApiError
      1. + field errorString
    22. enum BiddingError.Reason
      1. + value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_TARGET_CPA
      2. + value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_MANY_PER_CLICK
      3. + value TARGET_CPA_NOT_AVAILABLE_FOR_CUSTOMER
      4. + value MANY_PER_CLICK_NOT_AVAILABLE_FOR_CUSTOMER
      5. + value CANNOT_SET_SITE_MAX_CPC
      6. + value BID_ERROR
    23. enum BudgetError.Reason
      1. + value BUDGET_ERROR
      2. + value BUDGET_PERIOD_NOT_AVAILABLE
    24. type BudgetOptimizerAdGroupBids
      1. + field enhancedCpcEnabled
    25. type BudgetOptimizerAdGroupCriterionBids
      1. + field enhancedCpcEnabled
    26. enum BulkMutateJobError.Reason
      1. + value TOO_FEW_OPERATIONS_IN_JOB
      2. + value UNKNOWN
    27. type Campaign
      1. + field campaignStats
      2. field stats
    28. enum CampaignCriterionError.Reason
      1. + value INVALID_VERTICAL_PATH
      2. + value CANNOT_EXCLUDE_CRITERIA_TYPE
      3. + value UNKNOWN
    29. enum CampaignError.Reason
      1. + value FREQUENCY_CAP_TIME_UNIT_CANNOT_BE_NULL
      2. + value FREQUENCY_CAP_LEVEL_CANNOT_BE_NULL
      3. + value UNKNOWN
    30. enum ContentLabelType
      1. + value BRAND_BASIC
      2. + value BRAND_STANDARD
      3. + value BELOW_THE_FOLD
      4. value BRAND_BASIC
      5. value BRAND_STANDARD
      6. value CONFLICT_TRAGEDY
      7. value EDGY
      8. value UGC
      9. value SENSITIVE
    31. type ConversionOptimizer
      1. + field conversionOptimizerBidType
      2. + field deduplicationMode
    32. type ConversionOptimizerAdGroupBids
      1. + field conversionOptimizerBidType
      2. + field deduplicationMode
    33. enum DatabaseError.Reason
      1. + value DUPLICATE_KEY
      2. + value DATABASE_ERROR
      3. + value UNKNOWN
    34. enum InternalApiError.Reason
      1. + value UNKNOWN
    35. enum Level
      1. + value CAMPAIGN
      2. + value UNKNOWN
    36. enum LoasAuthenticationError.Reason
      1. + value UNKNOWN
    37. type ManualCPC
      1. + field positionPreference
    38. type ManualCPCAdGroupBids
      1. + field enhancedCpcEnabled
    39. type ManualCPCAdGroupCriterionBids
      1. + field enhancedCpcEnabled
    40. enum OperationAccessDenied.Reason
      1. + value UNKNOWN
    41. enum PagingError.Reason
      1. + value UNKNOWN
    42. enum QuotaCheckError.Reason
      1. + value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED
      2. value INCOMPLETE_SIGNUP_APP_INFO_MISSING
      3. value INCOMPLETE_SIGNUP_APP_INFO_PENDING
      4. value INCOMPLETE_SIGNUP_APP_INFO_REJECTED
      5. value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
    43. type RateExceededError
      1. + field reason
    44. type RejectedError
      1. + field reason
    45. type RichMediaAd
      1. + field adDuration
      2. + field expandable
      3. field adDuration
      4. field expandable
    46. enum SizeLimitError.Reason
      1. + value UNKNOWN
    47. enum Stats.Network
      1. + value UNKNOWN
    48. enum TargetError.Reason
      1. + value CANNOT_TARGET_MOBILE_CARRIER
      2. + value CANNOT_TARGET_THE_SAME_TARGET_LIST_TYPE_MULTIPLE_TIMES
      3. + value INVALID_MOBILE_CARRIER
      4. + value INVALID_MOBILE_PLATFORM
      5. + value POLYGON_TOO_MANY_VERTICES
      6. + value TARGET_ERROR
    49. type QuotaExceededError
  10. CampaignAdExtensionService (6 new, 11 changed, 1 removed)
    1. + type LocationSyncExtension
    2. + type MobileExtension
    3. + type RateExceededError
    4. + enum RateExceededError.Reason
    5. + type RequestError
    6. + type SitelinksExtension
    7. enum AdExtensionError.Reason
      1. + value CANNOT_HAVE_MULTIPLE_MOBILE_EXTENSIONS_PER_CAMPAIGN
      2. + value INVALID_ICON_DIMENSIONS
      3. + value INVALID_IMAGE_DIMENSIONS
      4. + value INVALID_INPUT
    8. type ApiError
      1. + field errorString
    9. type CampaignAdExtensionSelector
      1. + field adExtensionIds
    10. enum DatabaseError.Reason
      1. + value DUPLICATE_KEY
      2. + value DATABASE_ERROR
      3. + value UNKNOWN
    11. enum InternalApiError.Reason
      1. + value UNKNOWN
    12. enum OperationAccessDenied.Reason
      1. + value UNKNOWN
    13. enum PagingError.Reason
      1. + value UNKNOWN
    14. enum QuotaCheckError.Reason
      1. + value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED
      2. value INCOMPLETE_SIGNUP_APP_INFO_MISSING
      3. value INCOMPLETE_SIGNUP_APP_INFO_PENDING
      4. value INCOMPLETE_SIGNUP_APP_INFO_REJECTED
      5. value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
    15. type RateExceededError
      1. + field reason
    16. enum SizeLimitError.Reason
      1. + value UNKNOWN
    17. enum Stats.Network
      1. + value UNKNOWN
    18. type QuotaExceededError
  11. CampaignCriterionService (4 new, 10 changed, 1 removed)
    1. + type RateExceededError
    2. + enum RateExceededError.Reason
    3. + type RequestError
    4. + type Vertical
    5. type ApiError
      1. + field errorString
    6. enum CampaignCriterionError.Reason
      1. + value INVALID_VERTICAL_PATH
      2. + value CANNOT_EXCLUDE_CRITERIA_TYPE
      3. + value UNKNOWN
    7. enum ContentLabelType
      1. + value BRAND_BASIC
      2. + value BRAND_STANDARD
      3. + value BELOW_THE_FOLD
      4. value BRAND_BASIC
      5. value BRAND_STANDARD
      6. value CONFLICT_TRAGEDY
      7. value EDGY
      8. value UGC
      9. value SENSITIVE
    8. enum DatabaseError.Reason
      1. + value DUPLICATE_KEY
      2. + value DATABASE_ERROR
      3. + value UNKNOWN
    9. enum InternalApiError.Reason
      1. + value UNKNOWN
    10. enum OperationAccessDenied.Reason
      1. + value UNKNOWN
    11. enum PagingError.Reason
      1. + value UNKNOWN
    12. enum QuotaCheckError.Reason
      1. + value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED
      2. value INCOMPLETE_SIGNUP_APP_INFO_MISSING
      3. value INCOMPLETE_SIGNUP_APP_INFO_PENDING
      4. value INCOMPLETE_SIGNUP_APP_INFO_REJECTED
      5. value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
    13. type RateExceededError
      1. + field reason
    14. enum SizeLimitError.Reason
      1. + value UNKNOWN
    15. type QuotaExceededError
  12. CampaignService (6 new, 19 changed, 1 removed)
    1. + type CampaignStats
    2. + type RateExceededError
    3. + enum RateExceededError.Reason
    4. + type RejectedError
    5. + enum RejectedError.Reason
    6. + type RequestError
    7. type ApiError
      1. + field errorString
    8. enum BiddingError.Reason
      1. + value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_TARGET_CPA
      2. + value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_MANY_PER_CLICK
      3. + value TARGET_CPA_NOT_AVAILABLE_FOR_CUSTOMER
      4. + value MANY_PER_CLICK_NOT_AVAILABLE_FOR_CUSTOMER
      5. + value CANNOT_SET_SITE_MAX_CPC
      6. + value BID_ERROR
    9. enum BudgetError.Reason
      1. + value BUDGET_ERROR
      2. + value BUDGET_PERIOD_NOT_AVAILABLE
    10. type BudgetOptimizerAdGroupBids
      1. + field enhancedCpcEnabled
    11. type Campaign
      1. + field campaignStats
      2. field stats
    12. enum CampaignError.Reason
      1. + value FREQUENCY_CAP_TIME_UNIT_CANNOT_BE_NULL
      2. + value FREQUENCY_CAP_LEVEL_CANNOT_BE_NULL
      3. + value UNKNOWN
    13. type ConversionOptimizer
      1. + field conversionOptimizerBidType
      2. + field deduplicationMode
    14. type ConversionOptimizerAdGroupBids
      1. + field conversionOptimizerBidType
      2. + field deduplicationMode
    15. enum DatabaseError.Reason
      1. + value DUPLICATE_KEY
      2. + value DATABASE_ERROR
      3. + value UNKNOWN
    16. enum InternalApiError.Reason
      1. + value UNKNOWN
    17. enum Level
      1. + value CAMPAIGN
      2. + value UNKNOWN
    18. type ManualCPC
      1. + field positionPreference
    19. type ManualCPCAdGroupBids
      1. + field enhancedCpcEnabled
    20. enum OperationAccessDenied.Reason
      1. + value UNKNOWN
    21. enum QuotaCheckError.Reason
      1. + value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED
      2. value INCOMPLETE_SIGNUP_APP_INFO_MISSING
      3. value INCOMPLETE_SIGNUP_APP_INFO_PENDING
      4. value INCOMPLETE_SIGNUP_APP_INFO_REJECTED
      5. value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
    22. type RateExceededError
      1. + field reason
    23. type RejectedError
      1. + field reason
    24. enum SizeLimitError.Reason
      1. + value UNKNOWN
    25. enum Stats.Network
      1. + value UNKNOWN
    26. type QuotaExceededError
  13. CampaignTargetService (9 new, 11 changed, 1 removed)
    1. + type MobileCarrierTarget
    2. + type MobilePlatformTarget
    3. + type MobileTarget
    4. + type MobileTargetList
    5. + type RateExceededError
    6. + enum RateExceededError.Reason
    7. + type RejectedError
    8. + enum RejectedError.Reason
    9. + type RequestError
    10. type ApiError
      1. + field errorString
    11. enum BiddingError.Reason
      1. + value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_TARGET_CPA
      2. + value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_MANY_PER_CLICK
      3. + value TARGET_CPA_NOT_AVAILABLE_FOR_CUSTOMER
      4. + value MANY_PER_CLICK_NOT_AVAILABLE_FOR_CUSTOMER
      5. + value CANNOT_SET_SITE_MAX_CPC
      6. + value BID_ERROR
    12. enum CampaignError.Reason
      1. + value FREQUENCY_CAP_TIME_UNIT_CANNOT_BE_NULL
      2. + value FREQUENCY_CAP_LEVEL_CANNOT_BE_NULL
      3. + value UNKNOWN
    13. enum DatabaseError.Reason
      1. + value DUPLICATE_KEY
      2. + value DATABASE_ERROR
      3. + value UNKNOWN
    14. enum InternalApiError.Reason
      1. + value UNKNOWN
    15. enum OperationAccessDenied.Reason
      1. + value UNKNOWN
    16. enum QuotaCheckError.Reason
      1. + value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED
      2. value INCOMPLETE_SIGNUP_APP_INFO_MISSING
      3. value INCOMPLETE_SIGNUP_APP_INFO_PENDING
      4. value INCOMPLETE_SIGNUP_APP_INFO_REJECTED
      5. value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
    17. type RateExceededError
      1. + field reason
    18. type RejectedError
      1. + field reason
    19. enum SizeLimitError.Reason
      1. + value UNKNOWN
    20. enum TargetError.Reason
      1. + value CANNOT_TARGET_MOBILE_CARRIER
      2. + value CANNOT_TARGET_THE_SAME_TARGET_LIST_TYPE_MULTIPLE_TIMES
      3. + value INVALID_MOBILE_CARRIER
      4. + value INVALID_MOBILE_PLATFORM
      5. + value POLYGON_TOO_MANY_VERTICES
      6. + value TARGET_ERROR
    21. type QuotaExceededError
  14. GeoLocationService (3 new, 5 changed, 1 removed)
    1. + type RateExceededError
    2. + enum RateExceededError.Reason
    3. + type RequestError
    4. type ApiError
      1. + field errorString
    5. enum InternalApiError.Reason
      1. + value UNKNOWN
    6. enum QuotaCheckError.Reason
      1. + value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED
      2. value INCOMPLETE_SIGNUP_APP_INFO_MISSING
      3. value INCOMPLETE_SIGNUP_APP_INFO_PENDING
      4. value INCOMPLETE_SIGNUP_APP_INFO_REJECTED
      5. value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
    7. type RateExceededError
      1. + field reason
    8. enum SizeLimitError.Reason
      1. + value UNKNOWN
    9. type QuotaExceededError
  15. InfoService (3 new, 6 changed, 1 removed)
    1. + type RateExceededError
    2. + enum RateExceededError.Reason
    3. + type RequestError
    4. type ApiError
      1. + field errorString
    5. enum ApiUsageError.Reason
      1. + value INVALID_TOKEN_HEADER
    6. enum InternalApiError.Reason
      1. + value UNKNOWN
    7. enum QuotaCheckError.Reason
      1. + value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED
      2. value INCOMPLETE_SIGNUP_APP_INFO_MISSING
      3. value INCOMPLETE_SIGNUP_APP_INFO_PENDING
      4. value INCOMPLETE_SIGNUP_APP_INFO_REJECTED
      5. value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
    8. type RateExceededError
      1. + field reason
    9. enum SizeLimitError.Reason
      1. + value UNKNOWN
    10. type QuotaExceededError
  16. TargetingIdeaService (6 new, 14 changed, 2 removed)
    1. + type AdShareSearchParameter
    2. + type IdeaTextMatchesSearchParameter
    3. + type RateExceededError
    4. + enum RateExceededError.Reason
    5. + type RequestError
    6. + type SearchShareSearchParameter
    7. enum AdGroupCriterionError.Reason
      1. + value INAPPLICABLE_FOR_NEGATIVE
      2. + value INVALID_VERTICAL_PATH
      3. + value CANNOT_ADD_CRITERIA_TYPE
      4. + value UNKNOWN
    8. type ApiError
      1. + field errorString
    9. enum AttributeType
      1. + value UNKNOWN
      2. value PUBLISHER_DESCRIPTION
    10. enum BiddingError.Reason
      1. + value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_TARGET_CPA
      2. + value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_MANY_PER_CLICK
      3. + value TARGET_CPA_NOT_AVAILABLE_FOR_CUSTOMER
      4. + value MANY_PER_CLICK_NOT_AVAILABLE_FOR_CUSTOMER
      5. + value CANNOT_SET_SITE_MAX_CPC
      6. + value BID_ERROR
    11. enum BudgetError.Reason
      1. + value BUDGET_ERROR
      2. + value BUDGET_PERIOD_NOT_AVAILABLE
    12. enum DatabaseError.Reason
      1. + value DUPLICATE_KEY
      2. + value DATABASE_ERROR
      3. + value UNKNOWN
    13. enum InternalApiError.Reason
      1. + value UNKNOWN
    14. enum QuotaCheckError.Reason
      1. + value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED
      2. value INCOMPLETE_SIGNUP_APP_INFO_MISSING
      3. value INCOMPLETE_SIGNUP_APP_INFO_PENDING
      4. value INCOMPLETE_SIGNUP_APP_INFO_REJECTED
      5. value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
    15. type RateExceededError
      1. + field reason
    16. enum SiteConstants.AdFormat
      1. + value UNKNOWN
      2. + value AUDIO
    17. enum SiteConstants.AdType
      1. + value UNKNOWN
      2. + value AUDIO
      3. + value INSTREAM
    18. enum SiteConstants.PlacementType
      1. + value UNKNOWN
      2. + value AUDIO
    19. enum SizeLimitError.Reason
      1. + value UNKNOWN
    20. enum TargetError.Reason
      1. + value CANNOT_TARGET_MOBILE_CARRIER
      2. + value CANNOT_TARGET_THE_SAME_TARGET_LIST_TYPE_MULTIPLE_TIMES
      3. + value INVALID_MOBILE_CARRIER
      4. + value INVALID_MOBILE_PLATFORM
      5. + value POLYGON_TOO_MANY_VERTICES
      6. + value TARGET_ERROR
    21. type NgramGroupsSearchParameter
    22. type QuotaExceededError

v200909

What's New

  • Asynchronous bulk job support: Use BulkMutateJobService to build, schedule, and retrieve jobs that can operate on thousands of campaign objects.
  • Location extension support: Use CampaignAdExtensionService to augment your text ads with information about your business's physical location. You can also override location extensions on a per-ad basis using AdExtensionOverrideService For more information about how ad extensions work, read the AdWords Help Center overview.
  • Keyword and placement ideas: Use TargetingIdeaService to generate new keyword and placement ideas for your campaign ads.
  • API usage retrieval: Use InfoService to get information about your API usage, such as the amount spent on an operation in the past month or the number of API units available.
  • Ad parameters: Use AdParamService to perform on-the-fly updates to parameterized snippets of ad text.

API Changes

  1. + AdExtensionOverrideService
  2. + AdParamService
  3. + BulkMutateJobService
  4. + CampaignAdExtensionService
  5. + GeoLocationService
  6. AdGroupAdService (3 new, 2 changed, 0 removed)
    1. + type Audio
    2. + type DeprecatedAd
    3. + type TemplateAd
    4. enum AdError.Reason
      1. + value CUSTOMER_NOT_ELIGIBLE_FOR_UPDATING_BEACON_URL
      2. + value DIMENSION_ALREADY_IN_UNION
      3. + value DIMENSION_MUST_BE_SET
      4. + value DIMENSION_NOT_IN_UNION
      5. + value DOMESTIC_PHONE_NUMBER_FORMAT
      6. + value EMERGENCY_PHONE_NUMBER
      7. + value INCONSISTENT_STATUS_IN_TEMPLATE_UNION
      8. + value INVALID_AD_TYPE
      9. + value INVALID_ATTRIBUTES_FOR_MOBILE_IMAGE
      10. + value INVALID_ATTRIBUTES_FOR_MOBILE_TEXT
      11. + value INVALID_INPUT
      12. + value INVALID_MARKUP_LANGUAGE
      13. + value INVALID_MOBILE_CARRIER
      14. + value INVALID_NUMBER_OF_ELEMENTS
      15. + value INVALID_PHONE_NUMBER_FORMAT
      16. + value INVALID_TEMPLATE_DATA
      17. + value INVALID_TEMPLATE_ELEMENT_FIELD_TYPE
      18. + value INVALID_TEMPLATE_ID
      19. + value MARKUP_LANGUAGES_PRESENT
      20. + value MISSING_ADDRESS_COMPONENT
      21. + value MISSING_ADVERTISEMENT_NAME
      22. + value MISSING_BUSINESS_NAME
      23. + value MISSING_MARKUP_LANGUAGES
      24. + value MISSING_MOBILE_CARRIER
      25. + value MISSING_PHONE
      26. + value MISSING_REQUIRED_TEMPLATE_FIELDS
      27. + value MISSING_TEMPLATE_FIELD_VALUE
      28. + value MISSING_URL_AND_PHONE
      29. + value MUST_USE_TEMP_AD_UNION_ID_ON_ADD
      30. + value UNION_DIMENSIONS_CANNOT_CHANGE
      31. + value UNKNOWN_ADDRESS_COMPONENT
      32. + value UNKNOWN_FIELD_NAME
      33. + value UNKNOWN_UNIQUE_NAME
      34. + value USER_DOES_NOT_HAVE_ACCESS_TO_TEMPLATE
    5. enum AdGroupAdError.Reason
      1. + value CANNOT_CREATE_DEPRECATED_ADS
  7. = AdGroupCriterionService (no changes)
  8. = AdGroupService (no changes)
  9. = CampaignCriterionService (no changes)
  10. CampaignService (0 new, 2 changed, 0 removed)
    1. enum BudgetError.Reason
      1. + value INVALID_BUDGET_SCHEDULE
    2. enum CampaignError.Reason
      1. + value CANNOT_ADD_CAMPAIGN_WITH_CONVERSION_OPTIMIZER_BIDDING_STRATEGY
  11. CampaignTargetService (0 new, 1 changed, 0 removed)
    1. enum CampaignError.Reason
      1. + value CANNOT_ADD_CAMPAIGN_WITH_CONVERSION_OPTIMIZER_BIDDING_STRATEGY
  12. = InfoService (no changes)
  13. TargetingIdeaService (0 new, 1 changed, 0 removed)
    1. enum BudgetError.Reason
      1. + value INVALID_BUDGET_SCHEDULE

v200906

Initial release of Adwords API v2009

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.