- v201306
- AdGroupBidModifierService
- v201302
- Enhanced Campaigns
- v201209
- v201206
- v201109_1
- v201109
- v201101
- v201008
- v201003
- v200909
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
-
-UserListService -
+AdwordsUserListService -
+BiddingStrategyService -
≠AdExtensionOverrideService (0 new, 0 changed, 1 removed)-
−type ProductExtension
-
-
≠AdGroupAdService (0 new, 4 changed, 0 removed)-
≠enum AdError.Reason-
+value CUSTOMER_NOT_ELIGIBLE
-
-
≠enum FunctionError.Reason-
+value INVALID_CONJUNCTION_OPERANDS -
+value INVALID_OPERAND -
+value MISSING_CONSTANT_OPERAND_VALUE
-
-
≠enum OperationAccessDenied.Reason -
≠type RichMediaAd-
+field adAttributes
-
-
-
≠AdGroupBidModifierService (0 new, 2 changed, 0 removed)-
≠enum Criterion.Type-
−value POLYGON
-
-
≠enum CriterionError.Reason
-
-
≠AdGroupCriterionService (4 new, 7 changed, 0 removed)-
+type EnhancedCpcBiddingScheme -
+type PageOnePromotedBiddingScheme -
+type TargetCpaBiddingScheme -
+type TargetSpendBiddingScheme -
≠type BiddableAdGroupCriterion-
+field bidModifier
-
-
≠enum BiddingErrors.Reason-
+value BIDDING_STRATEGY_AVAILABLE_FOR_ENHANCED_CAMPAIGN_ONLY -
+value BIDDING_STRATEGY_NOT_COMPATIBLE_WITH_ADGROUP_OVERRIDES -
+value BIDDING_STRATEGY_NOT_COMPATIBLE_WITH_ADGROUP_CRITERIA_OVERRIDES -
+value CAMPAIGN_BIDDING_STRATEGY_CANNOT_BE_OVERRIDDEN -
+value ADGROUP_BIDDING_STRATEGY_CANNOT_BE_OVERRIDDEN -
+value CANNOT_ATTACH_BIDDING_STRATEGY_TO_ADGROUP -
+value CANNOT_ATTACH_BIDDING_STRATEGY_TO_ADGROUP_CRITERIA -
+value INVALID_ANONYMOUS_BIDDING_STRATEGY_TYPE -
+value INVALID_BIDDING_STRATEGY_TYPE -
+value MISSING_BIDDING_STRATEGY_TYPE -
+value CANNOT_ATTACH_POP_BIDDING_STRATEGY_FOR_CONTENT_NETWORK_ONLY_CAMPAIGN -
+value CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_AD_GROUP_LEVEL_POP_BIDDING_STRATEGY -
+value CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_CAMPAIGN_LEVEL_POP_BIDDING_STRATEGY -
+value BIDDING_STRATEGY_NOT_SUPPORTED_WITH_AD_SCHEDULE -
+value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
-
-
≠type BiddingStrategyConfiguration-
+field biddingStrategyId -
+field biddingStrategyName -
+field biddingStrategySource
-
-
≠enum BiddingStrategyType-
+value PAGE_ONE_PROMOTED -
+value TARGET_SPEND -
+value ENHANCED_CPC -
+value TARGET_CPA -
+value NONE
-
-
≠enum Criterion.Type-
−value POLYGON
-
-
≠enum CriterionError.Reason -
≠enum OperationAccessDenied.Reason
-
-
≠AdGroupFeedService (1 new, 4 changed, 0 removed)-
+type FunctionOperand -
≠enum Function.Operator-
+value AND
-
-
≠enum FunctionError.Reason-
+value INVALID_CONJUNCTION_OPERANDS -
+value INVALID_OPERAND -
+value MISSING_CONSTANT_OPERAND_VALUE
-
-
≠enum OperationAccessDenied.Reason -
≠enum RequestContextOperand.ContextType-
+value DEVICE_PLATFORM
-
-
-
≠AdGroupService (4 new, 4 changed, 0 removed)-
+type EnhancedCpcBiddingScheme -
+type PageOnePromotedBiddingScheme -
+type TargetCpaBiddingScheme -
+type TargetSpendBiddingScheme -
≠enum BiddingErrors.Reason-
+value BIDDING_STRATEGY_AVAILABLE_FOR_ENHANCED_CAMPAIGN_ONLY -
+value BIDDING_STRATEGY_NOT_COMPATIBLE_WITH_ADGROUP_OVERRIDES -
+value BIDDING_STRATEGY_NOT_COMPATIBLE_WITH_ADGROUP_CRITERIA_OVERRIDES -
+value CAMPAIGN_BIDDING_STRATEGY_CANNOT_BE_OVERRIDDEN -
+value ADGROUP_BIDDING_STRATEGY_CANNOT_BE_OVERRIDDEN -
+value CANNOT_ATTACH_BIDDING_STRATEGY_TO_ADGROUP -
+value CANNOT_ATTACH_BIDDING_STRATEGY_TO_ADGROUP_CRITERIA -
+value INVALID_ANONYMOUS_BIDDING_STRATEGY_TYPE -
+value INVALID_BIDDING_STRATEGY_TYPE -
+value MISSING_BIDDING_STRATEGY_TYPE -
+value CANNOT_ATTACH_POP_BIDDING_STRATEGY_FOR_CONTENT_NETWORK_ONLY_CAMPAIGN -
+value CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_AD_GROUP_LEVEL_POP_BIDDING_STRATEGY -
+value CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_CAMPAIGN_LEVEL_POP_BIDDING_STRATEGY -
+value BIDDING_STRATEGY_NOT_SUPPORTED_WITH_AD_SCHEDULE -
+value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
-
-
≠type BiddingStrategyConfiguration-
+field biddingStrategyId -
+field biddingStrategyName -
+field biddingStrategySource
-
-
≠enum BiddingStrategyType-
+value PAGE_ONE_PROMOTED -
+value TARGET_SPEND -
+value ENHANCED_CPC -
+value TARGET_CPA -
+value NONE
-
-
≠enum OperationAccessDenied.Reason
-
-
≠AdParamService (0 new, 1 changed, 0 removed)-
≠enum OperationAccessDenied.Reason
-
-
=AlertService (no changes) -
≠BudgetOrderService (0 new, 1 changed, 0 removed)-
≠enum OperationAccessDenied.Reason
-
-
≠BudgetService (0 new, 3 changed, 0 removed)-
≠type Budget-
−field associatedCampaigns
-
-
≠enum BudgetError.Reason-
−value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_SHARED_BY_BUDGET_OPTIMIZER_CAMPAIGN
-
-
≠enum OperationAccessDenied.Reason
-
-
≠CampaignAdExtensionService (0 new, 2 changed, 1 removed)-
≠enum AdExtensionError.Reason-
+value INVALID_ADEXTENSION_TYPE
-
-
≠enum OperationAccessDenied.Reason -
−type ProductExtension
-
-
≠CampaignCriterionService (0 new, 3 changed, 1 removed)-
≠enum Criterion.Type-
−value POLYGON
-
-
≠enum CriterionError.Reason -
≠enum OperationAccessDenied.Reason -
−type Polygon
-
-
≠CampaignFeedService (1 new, 4 changed, 0 removed)-
+type FunctionOperand -
≠enum Function.Operator-
+value AND
-
-
≠enum FunctionError.Reason-
+value INVALID_CONJUNCTION_OPERANDS -
+value INVALID_OPERAND -
+value MISSING_CONSTANT_OPERAND_VALUE
-
-
≠enum OperationAccessDenied.Reason -
≠enum RequestContextOperand.ContextType-
+value DEVICE_PLATFORM
-
-
-
≠CampaignService (4 new, 7 changed, 0 removed)-
+type EnhancedCpcBiddingScheme -
+type PageOnePromotedBiddingScheme -
+type TargetCpaBiddingScheme -
+type TargetSpendBiddingScheme -
≠enum BiddingErrors.Reason-
+value BIDDING_STRATEGY_AVAILABLE_FOR_ENHANCED_CAMPAIGN_ONLY -
+value BIDDING_STRATEGY_NOT_COMPATIBLE_WITH_ADGROUP_OVERRIDES -
+value BIDDING_STRATEGY_NOT_COMPATIBLE_WITH_ADGROUP_CRITERIA_OVERRIDES -
+value CAMPAIGN_BIDDING_STRATEGY_CANNOT_BE_OVERRIDDEN -
+value ADGROUP_BIDDING_STRATEGY_CANNOT_BE_OVERRIDDEN -
+value CANNOT_ATTACH_BIDDING_STRATEGY_TO_ADGROUP -
+value CANNOT_ATTACH_BIDDING_STRATEGY_TO_ADGROUP_CRITERIA -
+value INVALID_ANONYMOUS_BIDDING_STRATEGY_TYPE -
+value INVALID_BIDDING_STRATEGY_TYPE -
+value MISSING_BIDDING_STRATEGY_TYPE -
+value CANNOT_ATTACH_POP_BIDDING_STRATEGY_FOR_CONTENT_NETWORK_ONLY_CAMPAIGN -
+value CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_AD_GROUP_LEVEL_POP_BIDDING_STRATEGY -
+value CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_CAMPAIGN_LEVEL_POP_BIDDING_STRATEGY -
+value BIDDING_STRATEGY_NOT_SUPPORTED_WITH_AD_SCHEDULE -
+value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
-
-
≠type BiddingStrategyConfiguration-
+field biddingStrategyId -
+field biddingStrategyName -
+field biddingStrategySource
-
-
≠enum BiddingStrategyType-
+value PAGE_ONE_PROMOTED -
+value TARGET_SPEND -
+value ENHANCED_CPC -
+value TARGET_CPA -
+value NONE
-
-
≠type Budget-
−field associatedCampaigns
-
-
≠enum BudgetError.Reason-
−value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_SHARED_BY_BUDGET_OPTIMIZER_CAMPAIGN
-
-
≠enum CampaignError.Reason-
+value BUDGET_CANNOT_BE_SHARED -
+value CAMPAIGN_CANNOT_USE_SHARED_BUDGET -
−value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_OPTIMIZER_CAMPAIGN
-
-
≠enum OperationAccessDenied.Reason
-
-
≠ConstantDataService (0 new, 1 changed, 0 removed)-
≠enum Criterion.Type-
−value POLYGON
-
-
-
≠ConversionTrackerService (0 new, 1 changed, 0 removed)-
≠enum OperationAccessDenied.Reason
-
-
≠CustomerService (0 new, 1 changed, 0 removed)-
≠enum OperationAccessDenied.Reason
-
-
≠CustomerSyncService (1 new, 5 changed, 0 removed)-
+type FeedChangeData -
≠type AdGroupChangeData-
+field changedAdGroupBidModifierCriteria -
+field changedFeeds -
+field deletedAdGroupBidModifierCriteria -
+field deletedFeeds
-
-
≠type CampaignChangeData-
+field changedFeeds -
+field deletedFeeds
-
-
≠type CustomerChangeData-
+field changedFeeds
-
-
≠enum CustomerSyncError.Reason-
+value INVALID_FEED_ID
-
-
≠type CustomerSyncSelector-
+field feedIds
-
-
-
=DataService (no changes) -
≠ExperimentService (0 new, 3 changed, 0 removed)-
≠enum BudgetError.Reason-
−value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_SHARED_BY_BUDGET_OPTIMIZER_CAMPAIGN
-
-
≠enum ExperimentServiceError.Reason -
≠enum OperationAccessDenied.Reason
-
-
≠FeedItemService (2 new, 3 changed, 0 removed)-
+type BetaError -
+enum BetaError.Reason -
≠type BetaError-
+field reason
-
-
≠type FeedItem-
+field scheduling
-
-
≠enum OperationAccessDenied.Reason
-
-
≠FeedMappingService (0 new, 2 changed, 0 removed)-
≠enum FeedMappingError.Reason -
≠enum OperationAccessDenied.Reason
-
-
≠FeedService (0 new, 1 changed, 0 removed)-
≠enum OperationAccessDenied.Reason
-
-
=GeoLocationService (no changes) -
≠LocationCriterionService (0 new, 2 changed, 0 removed)-
≠enum Criterion.Type-
−value POLYGON
-
-
≠enum OperationAccessDenied.Reason
-
-
≠ManagedCustomerService (0 new, 1 changed, 0 removed)-
≠enum ManagedCustomerServiceError.Reason-
+value ADD_CUSTOMER_FAILURE -
+value SAVE_CUSTOMERS_FAILURE -
+value TEST_ACCOUNT_LINK_ERROR
-
-
-
≠MediaService (0 new, 1 changed, 0 removed)-
≠enum OperationAccessDenied.Reason
-
-
≠MutateJobService (20 new, 23 changed, 2 removed)-
+type AdGroupBidModifier -
+type AdGroupBidModifierOperation -
+enum BidModifierSource -
+type EnhancedCpcBiddingScheme -
+type FeedItem -
+enum FeedItem.Status -
+type FeedItemAttributeError -
+type FeedItemAttributeValue -
+type FeedItemDevicePreference -
+type FeedItemError -
+enum FeedItemError.Reason -
+type FeedItemOperation -
+type FeedItemSchedule -
+type FeedItemScheduling -
+type FeedItemValidationDetail -
+enum FeedItemValidationDetail.ApprovalStatus -
+enum FeedItemValidationDetail.ValidationStatus -
+type PageOnePromotedBiddingScheme -
+type TargetCpaBiddingScheme -
+type TargetSpendBiddingScheme -
≠enum AdError.Reason-
+value CUSTOMER_NOT_ELIGIBLE
-
-
≠enum AdExtensionError.Reason-
+value INVALID_ADEXTENSION_TYPE
-
-
≠type AdGroupBidModifier-
+field bidModifierSource
-
-
≠type AdGroupBidModifierOperation-
+field operand
-
-
≠type BiddableAdGroupCriterion-
+field bidModifier
-
-
≠enum BiddingErrors.Reason-
+value BIDDING_STRATEGY_AVAILABLE_FOR_ENHANCED_CAMPAIGN_ONLY -
+value BIDDING_STRATEGY_NOT_COMPATIBLE_WITH_ADGROUP_OVERRIDES -
+value BIDDING_STRATEGY_NOT_COMPATIBLE_WITH_ADGROUP_CRITERIA_OVERRIDES -
+value CAMPAIGN_BIDDING_STRATEGY_CANNOT_BE_OVERRIDDEN -
+value ADGROUP_BIDDING_STRATEGY_CANNOT_BE_OVERRIDDEN -
+value CANNOT_ATTACH_BIDDING_STRATEGY_TO_ADGROUP -
+value CANNOT_ATTACH_BIDDING_STRATEGY_TO_ADGROUP_CRITERIA -
+value INVALID_ANONYMOUS_BIDDING_STRATEGY_TYPE -
+value INVALID_BIDDING_STRATEGY_TYPE -
+value MISSING_BIDDING_STRATEGY_TYPE -
+value CANNOT_ATTACH_POP_BIDDING_STRATEGY_FOR_CONTENT_NETWORK_ONLY_CAMPAIGN -
+value CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_AD_GROUP_LEVEL_POP_BIDDING_STRATEGY -
+value CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_CAMPAIGN_LEVEL_POP_BIDDING_STRATEGY -
+value BIDDING_STRATEGY_NOT_SUPPORTED_WITH_AD_SCHEDULE -
+value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
-
-
≠type BiddingStrategyConfiguration-
+field biddingStrategyId -
+field biddingStrategyName -
+field biddingStrategySource
-
-
≠enum BiddingStrategyType-
+value PAGE_ONE_PROMOTED -
+value TARGET_SPEND -
+value ENHANCED_CPC -
+value TARGET_CPA -
+value NONE
-
-
≠type Budget-
−field associatedCampaigns
-
-
≠enum BudgetError.Reason-
−value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_SHARED_BY_BUDGET_OPTIMIZER_CAMPAIGN
-
-
≠enum CampaignError.Reason-
+value BUDGET_CANNOT_BE_SHARED -
+value CAMPAIGN_CANNOT_USE_SHARED_BUDGET -
−value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_OPTIMIZER_CAMPAIGN
-
-
≠enum Criterion.Type-
−value POLYGON
-
-
≠enum CriterionError.Reason -
≠type FeedItem-
+field attributeValues -
+field devicePreference -
+field feedId -
+field feedItemId -
+field scheduling -
+field status -
+field validationDetails
-
-
≠type FeedItemAttributeError-
+field feedAttributeIds
-
-
≠type FeedItemAttributeValue-
+field feedAttributeId
-
-
≠type FeedItemError-
+field reason
-
-
≠type FeedItemOperation-
+field operand
-
-
≠type FeedItemScheduling-
+field feedItemSchedules
-
-
≠type FeedItemValidationDetail-
+field approvalStatus -
+field feedMappingId -
+field validationErrors -
+field validationStatus
-
-
≠enum FunctionError.Reason-
+value INVALID_CONJUNCTION_OPERANDS -
+value INVALID_OPERAND -
+value MISSING_CONSTANT_OPERAND_VALUE
-
-
≠enum OperationAccessDenied.Reason -
≠type RichMediaAd-
+field adAttributes
-
-
−type Polygon -
−type ProductExtension
-
-
≠ReportDefinitionService (0 new, 1 changed, 0 removed)-
≠enum ReportDefinition.ReportType-
+value CAMPAIGN_LOCATION_TARGET_REPORT -
+value CAMPAIGN_AD_SCHEDULE_TARGET_REPORT -
+value CAMPAIGN_PLATFORM_TARGET_REPORT
-
-
-
≠SharedCriterionService (0 new, 2 changed, 0 removed)-
≠enum Criterion.Type-
−value POLYGON
-
-
≠enum CriterionError.Reason
-
-
≠SharedSetService (0 new, 1 changed, 0 removed)-
≠enum OperationAccessDenied.Reason
-
-
≠TargetingIdeaService (0 new, 4 changed, 0 removed)-
≠enum BudgetError.Reason-
−value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_SHARED_BY_BUDGET_OPTIMIZER_CAMPAIGN
-
-
≠enum Criterion.Type-
−value POLYGON
-
-
≠enum CriterionError.Reason -
≠enum OperationAccessDenied.Reason
-
-
≠TrafficEstimatorService (0 new, 2 changed, 0 removed)-
≠enum Criterion.Type-
−value POLYGON
-
-
≠enum OperationAccessDenied.Reason
-
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:impressionsPerDayandclickThroughRate.- 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
-
-InfoService -
+AdGroupFeedService -
+CampaignFeedService -
+CampaignSharedSetService -
+FeedItemService -
+FeedMappingService -
+FeedService -
+SharedCriterionService -
+SharedSetService -
≠AdExtensionOverrideService (2 new, 2 changed, 0 removed)-
+type IdError -
+enum IdError.Reason -
≠type IdError-
+field reason
-
-
≠type Stats-
+field totalBudget
-
-
-
≠AdGroupAdService (4 new, 8 changed, 0 removed)-
+type ForwardCompatibilityError -
+enum ForwardCompatibilityError.Reason -
+type StringLengthError -
+enum StringLengthError.Reason -
≠type Ad-
+field devicePreference
-
-
≠enum AdError.Reason -
≠enum DateError.Reason -
≠type EntityCountLimitExceeded-
+field accountLimitType -
+field existingCount
-
-
≠enum EntityCountLimitExceeded.Reason-
+value MATCHING_FUNCTION_LIMIT
-
-
≠type ForwardCompatibilityError-
+field reason
-
-
≠type Stats-
+field totalBudget
-
-
≠type StringLengthError-
+field reason
-
-
-
≠AdGroupCriterionService (8 new, 11 changed, 0 removed)-
+type BiddingErrors -
+enum BiddingErrors.Reason -
+type ForwardCompatibilityError -
+enum ForwardCompatibilityError.Reason -
+type IdError -
+enum IdError.Reason -
+type StringLengthError -
+enum StringLengthError.Reason -
≠enum AdGroupCriterionLimitExceeded.CriteriaLimitType-
+value ADGROUP_CRITERION -
+value UNKNOWN
-
-
≠type BiddableAdGroupCriterion-
+field biddingStrategyConfiguration -
−field bids
-
-
≠type BiddingErrors-
+field reason
-
-
≠enum CriterionError.Reason -
≠enum DateError.Reason -
≠type EntityCountLimitExceeded-
+field accountLimitType -
+field existingCount
-
-
≠enum EntityCountLimitExceeded.Reason-
+value MATCHING_FUNCTION_LIMIT
-
-
≠type ForwardCompatibilityError-
+field reason
-
-
≠type IdError-
+field reason
-
-
≠type Stats-
+field totalBudget
-
-
≠type StringLengthError-
+field reason
-
-
-
≠AdGroupService (8 new, 11 changed, 0 removed)-
+type BiddingErrors -
+enum BiddingErrors.Reason -
+type ForwardCompatibilityError -
+enum ForwardCompatibilityError.Reason -
+type IdError -
+enum IdError.Reason -
+type StringLengthError -
+enum StringLengthError.Reason -
≠type AdGroup-
+field biddingStrategyConfiguration -
+field contentBidCriterionTypeGroup -
−field bids
-
-
≠enum AdGroupServiceError.Reason -
≠type BiddingErrors-
+field reason
-
-
≠enum CriterionTypeGroup-
+value KEYWORD
-
-
≠enum DateError.Reason -
≠type EntityCountLimitExceeded-
+field accountLimitType -
+field existingCount
-
-
≠enum EntityCountLimitExceeded.Reason-
+value MATCHING_FUNCTION_LIMIT
-
-
≠type ForwardCompatibilityError-
+field reason
-
-
≠type IdError-
+field reason
-
-
≠type Stats-
+field totalBudget
-
-
≠type StringLengthError-
+field reason
-
-
-
≠AdParamService (4 new, 2 changed, 0 removed)-
+type IdError -
+enum IdError.Reason -
+type ReadOnlyError -
+enum ReadOnlyError.Reason -
≠type IdError-
+field reason
-
-
≠type ReadOnlyError-
+field reason
-
-
-
≠AlertService (2 new, 2 changed, 0 removed)-
+type IdError -
+enum IdError.Reason -
≠enum DateError.Reason -
≠type IdError-
+field reason
-
-
-
≠BudgetOrderService (2 new, 4 changed, 0 removed)-
+type CustomerOrderLineError -
+enum CustomerOrderLineError.Reason -
≠type BillingAccount-
+field primaryBillingId -
+field secondaryBillingId
-
-
≠enum BudgetOrderError.Reason-
+value MCC_HIERARCHY_SIZE_TOO_LARGE -
+value INVALID_MCC_HIERARCHY
-
-
≠type CustomerOrderLineError-
+field reason
-
-
≠enum DateError.Reason
-
-
≠BudgetService (6 new, 9 changed, 0 removed)-
+type IdError -
+enum IdError.Reason -
+type OperationAccessDenied -
+enum OperationAccessDenied.Reason -
+type ReadOnlyError -
+enum ReadOnlyError.Reason -
≠type Budget-
+field associatedCampaigns -
+field isExplicitlyShared
-
-
≠enum BudgetError.Reason-
+value BUDGET_DELETED -
+value BUDGET_IN_USE -
+value CANNOT_EDIT_SHARED_BUDGET -
+value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_SHARED_BY_BUDGET_OPTIMIZER_CAMPAIGN -
+value DUPLICATE_NAME -
−value INVALID_BUDGET_SCHEDULE
-
-
≠type BudgetReturnValue-
+field partialFailureErrors
-
-
≠enum DateError.Reason -
≠type EntityCountLimitExceeded-
+field accountLimitType -
+field existingCount
-
-
≠enum EntityCountLimitExceeded.Reason-
+value MATCHING_FUNCTION_LIMIT
-
-
≠type IdError-
+field reason
-
-
≠type OperationAccessDenied-
+field reason
-
-
≠type ReadOnlyError-
+field reason
-
-
-
≠CampaignAdExtensionService (2 new, 4 changed, 0 removed)-
+type IdError -
+enum IdError.Reason -
≠type EntityCountLimitExceeded-
+field accountLimitType -
+field existingCount
-
-
≠enum EntityCountLimitExceeded.Reason-
+value MATCHING_FUNCTION_LIMIT
-
-
≠type IdError-
+field reason
-
-
≠type Stats-
+field totalBudget
-
-
-
≠CampaignCriterionService (2 new, 5 changed, 0 removed)-
+type IdError -
+enum IdError.Reason -
≠enum ContentLabelType-
+value UNKNOWN
-
-
≠enum CriterionError.Reason -
≠type EntityCountLimitExceeded-
+field accountLimitType -
+field existingCount
-
-
≠enum EntityCountLimitExceeded.Reason-
+value MATCHING_FUNCTION_LIMIT
-
-
≠type IdError-
+field reason
-
-
-
≠CampaignService (6 new, 13 changed, 1 removed)-
+type BiddingErrors -
+enum BiddingErrors.Reason -
+type ForwardCompatibilityError -
+enum ForwardCompatibilityError.Reason -
+type IdError -
+enum IdError.Reason -
≠type BiddingErrors-
+field reason
-
-
≠type Budget-
+field associatedCampaigns -
+field isExplicitlyShared
-
-
≠enum BudgetError.Reason-
+value BUDGET_DELETED -
+value BUDGET_IN_USE -
+value CANNOT_EDIT_SHARED_BUDGET -
+value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_SHARED_BY_BUDGET_OPTIMIZER_CAMPAIGN -
+value DUPLICATE_NAME -
−value INVALID_BUDGET_SCHEDULE
-
-
≠type Campaign-
+field biddingStrategyConfiguration -
+field enhanced -
−field biddingStrategy
-
-
≠enum CampaignError.Reason -
≠type CampaignOperation-
−field biddingTransition
-
-
≠type CampaignPage-
−field totalBudget
-
-
≠enum DateError.Reason -
≠type EntityCountLimitExceeded-
+field accountLimitType -
+field existingCount
-
-
≠enum EntityCountLimitExceeded.Reason-
+value MATCHING_FUNCTION_LIMIT
-
-
≠type ForwardCompatibilityError-
+field reason
-
-
≠type IdError-
+field reason
-
-
≠type Stats-
+field totalBudget
-
-
−type TargetRestrictSetting
-
-
≠ConstantDataService (6 new, 4 changed, 0 removed)-
+type IdError -
+enum IdError.Reason -
+type ReadOnlyError -
+enum ReadOnlyError.Reason -
+type StringLengthError -
+enum StringLengthError.Reason -
≠enum DateError.Reason -
≠type IdError-
+field reason
-
-
≠type ReadOnlyError-
+field reason
-
-
≠type StringLengthError-
+field reason
-
-
-
≠ConversionTrackerService (5 new, 4 changed, 0 removed)-
+type AppConversion -
+type IdError -
+enum IdError.Reason -
+type StringLengthError -
+enum StringLengthError.Reason -
≠type AdWordsConversionTracker-
−field httpProtocol
-
-
≠enum DateError.Reason -
≠type IdError-
+field reason
-
-
≠type StringLengthError-
+field reason
-
-
-
≠CustomerSyncService (2 new, 2 changed, 0 removed)-
+type IdError -
+enum IdError.Reason -
≠enum DateError.Reason -
≠type IdError-
+field reason
-
-
-
≠DataService (6 new, 4 changed, 0 removed)-
+type IdError -
+enum IdError.Reason -
+type ReadOnlyError -
+enum ReadOnlyError.Reason -
+type StringLengthError -
+enum StringLengthError.Reason -
≠enum DateError.Reason -
≠type IdError-
+field reason
-
-
≠type ReadOnlyError-
+field reason
-
-
≠type StringLengthError-
+field reason
-
-
-
≠ExperimentService (2 new, 3 changed, 0 removed)-
+type IdError -
+enum IdError.Reason -
≠enum BudgetError.Reason-
+value BUDGET_DELETED -
+value BUDGET_IN_USE -
+value CANNOT_EDIT_SHARED_BUDGET -
+value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_SHARED_BY_BUDGET_OPTIMIZER_CAMPAIGN -
+value DUPLICATE_NAME -
−value INVALID_BUDGET_SCHEDULE
-
-
≠enum DateError.Reason -
≠type IdError-
+field reason
-
-
-
≠GeoLocationService (8 new, 4 changed, 0 removed)-
+type DatabaseError -
+enum DatabaseError.Reason -
+type DistinctError -
+enum DistinctError.Reason -
+type IdError -
+enum IdError.Reason -
+type ReadOnlyError -
+enum ReadOnlyError.Reason -
≠type DatabaseError-
+field reason
-
-
≠type DistinctError-
+field reason
-
-
≠type IdError-
+field reason
-
-
≠type ReadOnlyError-
+field reason
-
-
-
≠LocationCriterionService (6 new, 4 changed, 0 removed)-
+type IdError -
+enum IdError.Reason -
+type ReadOnlyError -
+enum ReadOnlyError.Reason -
+type StringLengthError -
+enum StringLengthError.Reason -
≠enum DateError.Reason -
≠type IdError-
+field reason
-
-
≠type ReadOnlyError-
+field reason
-
-
≠type StringLengthError-
+field reason
-
-
-
≠ManagedCustomerService (12 new, 8 changed, 0 removed)-
+type IdError -
+enum IdError.Reason -
+type LinkOperation -
+enum LinkStatus -
+type MoveOperation -
+type MutateLinkResults -
+type MutateManagerResults -
+type PendingInvitation -
+type PendingInvitationSelector -
+operation getPendingInvitations -
+operation mutateLink -
+operation mutateManager -
≠enum DateError.Reason -
≠type IdError-
+field reason
-
-
≠type ManagedCustomer-
+field testAccount
-
-
≠type ManagedCustomerLink-
+field linkStatus -
+field pendingDescriptiveName
-
-
≠enum ManagedCustomerServiceError.Reason-
+value NOT_AUTHORIZED
-
-
≠operation getPendingInvitations -
≠operation mutateLink-
+parameter operations -
+response rval
-
-
≠operation mutateManager-
+parameter operations -
+response rval
-
-
-
≠MediaService (6 new, 3 changed, 0 removed)-
+type DistinctError -
+enum DistinctError.Reason -
+type IdError -
+enum IdError.Reason -
+type StringLengthError -
+enum StringLengthError.Reason -
≠type DistinctError-
+field reason
-
-
≠type IdError-
+field reason
-
-
≠type StringLengthError-
+field reason
-
-
-
≠MutateJobService (5 new, 20 changed, 1 removed)-
+type BiddingErrors -
+enum BiddingErrors.Reason -
+type BudgetOperation -
+type ForwardCompatibilityError -
+enum ForwardCompatibilityError.Reason -
≠type Ad-
+field devicePreference
-
-
≠enum AdError.Reason -
≠type AdGroup-
+field biddingStrategyConfiguration -
+field contentBidCriterionTypeGroup -
−field bids
-
-
≠enum AdGroupCriterionLimitExceeded.CriteriaLimitType-
+value ADGROUP_CRITERION -
+value UNKNOWN
-
-
≠enum AdGroupServiceError.Reason -
≠type BiddableAdGroupCriterion-
+field biddingStrategyConfiguration -
−field bids
-
-
≠type BiddingErrors-
+field reason
-
-
≠type Budget-
+field associatedCampaigns -
+field isExplicitlyShared
-
-
≠enum BudgetError.Reason-
+value BUDGET_DELETED -
+value BUDGET_IN_USE -
+value CANNOT_EDIT_SHARED_BUDGET -
+value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_SHARED_BY_BUDGET_OPTIMIZER_CAMPAIGN -
+value DUPLICATE_NAME -
−value INVALID_BUDGET_SCHEDULE
-
-
≠type Campaign-
+field biddingStrategyConfiguration -
+field enhanced -
−field biddingStrategy
-
-
≠enum CampaignError.Reason -
≠type CampaignOperation-
−field biddingTransition
-
-
≠enum ContentLabelType-
+value UNKNOWN
-
-
≠enum CriterionError.Reason -
≠enum CriterionTypeGroup-
+value KEYWORD
-
-
≠enum DateError.Reason -
≠type EntityCountLimitExceeded-
+field accountLimitType -
+field existingCount
-
-
≠enum EntityCountLimitExceeded.Reason-
+value MATCHING_FUNCTION_LIMIT
-
-
≠type ForwardCompatibilityError-
+field reason
-
-
≠type Stats-
+field totalBudget
-
-
−type TargetRestrictSetting
-
-
≠ReportDefinitionService (2 new, 3 changed, 0 removed)-
+type IdError -
+enum IdError.Reason -
≠enum DateError.Reason -
≠type IdError-
+field reason
-
-
≠enum ReportDefinition.ReportType-
+value KEYWORDLESS_QUERY_REPORT -
+value KEYWORDLESS_CATEGORY_REPORT -
+value BUDGET_PERFORMANCE_REPORT -
+value PLACEHOLDER_FEED_ITEM_REPORT -
+value PLACEMENT_PERFORMANCE_REPORT -
+value CAMPAIGN_NEGATIVE_LOCATIONS_REPORT -
+value CAMPAIGN_LOCATION_TARGET_REPORT -
+value CAMPAIGN_AD_SCHEDULE_TARGET_REPORT -
+value CAMPAIGN_PLATFORM_TARGET_REPORT -
+value AUDIENCE_PERFORMANCE_REPORT -
+value DISPLAY_TOPICS_PERFORMANCE_REPORT -
−value MANAGED_PLACEMENTS_PERFORMANCE_REPORT
-
-
-
≠TargetingIdeaService (1 new, 7 changed, 1 removed)-
+type NetworkSearchParameter -
≠enum AdGroupCriterionLimitExceeded.CriteriaLimitType-
+value ADGROUP_CRITERION -
+value UNKNOWN
-
-
≠enum AttributeType-
+value AVERAGE_CPC -
−value NGRAM_GROUP
-
-
≠enum BudgetError.Reason-
+value BUDGET_DELETED -
+value BUDGET_IN_USE -
+value CANNOT_EDIT_SHARED_BUDGET -
+value CANNOT_SET_ACCELERATED_DELIVERY_FOR_BUDGET_SHARED_BY_BUDGET_OPTIMIZER_CAMPAIGN -
+value DUPLICATE_NAME -
−value INVALID_BUDGET_SCHEDULE
-
-
≠enum CriterionError.Reason -
≠enum DateError.Reason -
≠type EntityCountLimitExceeded-
+field accountLimitType -
+field existingCount
-
-
≠enum EntityCountLimitExceeded.Reason-
+value MATCHING_FUNCTION_LIMIT
-
-
−type DeviceTypeSearchParameter
-
-
≠TrafficEstimatorService (0 new, 3 changed, 0 removed)-
≠enum ContentLabelType-
+value UNKNOWN
-
-
≠enum DateError.Reason -
≠type StatsEstimate-
+field clickThroughRate -
+field impressionsPerDay
-
-
-
≠UserListService (6 new, 3 changed, 0 removed)-
+type EntityNotFound -
+enum EntityNotFound.Reason -
+type IdError -
+enum IdError.Reason -
+type StringLengthError -
+enum StringLengthError.Reason -
≠type EntityNotFound-
+field reason
-
-
≠type IdError-
+field reason
-
-
≠type StringLengthError-
+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, theCampaign.forwardCompatibilityMapfield and theCampaign.enhancedkey 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 oftrueon mutate calls to enhance campaigns. Setting the value of the key tofalseafter 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 thefieldsof 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, theAdGroupAd.forwardCompatibilityMapfield and theAd.devicePreferencekey to submit new mobile preferred ads. This key is only accepted in mutate ADD calls for Ads of typeTextAd,ImageAd,DynamicSearchAd,TemplateAd, andThirdPartyRedirectAd. The value of this key can only be set to30001, which refers to theHighEndMobileplatform.- Retrieve Google's suggested mobile bid adjustment
Use the
CampaignService, theCampaign.forwardCompatibilityMapfield and theCampaign.suggestedMobileBidAdjustmentkey 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 thefieldsof the request selector.- Set mobile bid adjustments
Use the
CampaignCriterionServiceand theCampaignCriterion.bidModifierfield to set mobile bid adjustments. You may only set thebidModifierif theCampaignCriterionis of typeAdScheduleorHighEndMobilePlatform. 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
AgeRangeandGenderare 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
-
-BulkMutateJobService -
+BudgetService -
≠AdExtensionOverrideService (0 new, 2 changed, 0 removed)-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
-
≠AdGroupAdService (0 new, 3 changed, 0 removed)-
≠type AdGroupAd-
+field forwardCompatibilityMap
-
-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
-
≠AdGroupCriterionService (6 new, 6 changed, 0 removed)-
+type AgeRange -
+enum AgeRange.AgeRangeType -
+type Gender -
+enum Gender.GenderType -
+type MobileAppCategory -
+type MobileApplication -
≠type AdGroupCriterion-
+field forwardCompatibilityMap
-
-
≠type AgeRange-
+field ageRangeType
-
-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠enum Criterion.Type-
+value MOBILE_APPLICATION -
+value MOBILE_APP_CATEGORY
-
-
≠type Gender-
+field genderType
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
-
≠AdGroupService (0 new, 4 changed, 0 removed)-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠type ConversionOptimizerAdGroupBids-
−field deduplicationMode
-
-
≠enum CriterionTypeGroup -
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
-
≠AdParamService (0 new, 2 changed, 0 removed)-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
-
≠AlertService (0 new, 2 changed, 0 removed)-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
-
≠BudgetOrderService (1 new, 4 changed, 0 removed)-
+type BudgetOrderRequest -
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠type BudgetOrder-
+field billingAccountName -
+field budgetOrderName -
+field lastRequest -
+field poNumber -
+field primaryBillingId -
+field secondaryBillingId
-
-
≠enum BudgetOrderError.Reason -
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
-
≠CampaignAdExtensionService (0 new, 2 changed, 0 removed)-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
-
≠CampaignCriterionService (2 new, 4 changed, 0 removed)-
+type MobileAppCategory -
+type MobileApplication -
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠type CampaignCriterion-
+field forwardCompatibilityMap
-
-
≠enum Criterion.Type-
+value MOBILE_APPLICATION -
+value MOBILE_APP_CATEGORY
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
-
≠CampaignService (1 new, 7 changed, 0 removed)-
+type TrackingSetting -
≠enum AdServingOptimizationStatus-
+value ROTATE_INDEFINITELY
-
-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠type Budget-
+field budgetId -
+field name -
+field referenceCount -
+field status
-
-
≠type ConversionOptimizer-
−field deduplicationMode
-
-
≠type ConversionOptimizerAdGroupBids-
−field deduplicationMode
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
≠type NetworkSetting-
−field targetContentContextual
-
-
-
≠ConstantDataService (0 new, 3 changed, 0 removed)-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠enum Criterion.Type-
+value MOBILE_APPLICATION -
+value MOBILE_APP_CATEGORY
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
-
≠ConversionTrackerService (0 new, 2 changed, 0 removed)-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
-
≠CustomerService (0 new, 2 changed, 0 removed)-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
-
≠CustomerSyncService (0 new, 2 changed, 0 removed)-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
-
≠DataService (0 new, 2 changed, 0 removed)-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
-
≠ExperimentService (0 new, 2 changed, 0 removed)-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
-
≠GeoLocationService (0 new, 2 changed, 0 removed)-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
-
≠InfoService (0 new, 2 changed, 0 removed)-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
-
≠LocationCriterionService (2 new, 4 changed, 0 removed)-
+type OperationAccessDenied -
+enum OperationAccessDenied.Reason -
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠enum Criterion.Type-
+value MOBILE_APPLICATION -
+value MOBILE_APP_CATEGORY
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
≠type OperationAccessDenied-
+field reason
-
-
-
≠ManagedCustomerService (0 new, 2 changed, 0 removed)-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
-
≠MediaService (0 new, 2 changed, 0 removed)-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
-
≠MutateJobService (3 new, 12 changed, 0 removed)-
+type MobileAppCategory -
+type MobileApplication -
+type TrackingSetting -
≠type AdGroupAd-
+field forwardCompatibilityMap
-
-
≠type AdGroupCriterion-
+field forwardCompatibilityMap
-
-
≠enum AdServingOptimizationStatus-
+value ROTATE_INDEFINITELY
-
-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠type Budget-
+field budgetId -
+field name -
+field referenceCount -
+field status
-
-
≠type CampaignCriterion-
+field forwardCompatibilityMap
-
-
≠type ConversionOptimizer-
−field deduplicationMode
-
-
≠type ConversionOptimizerAdGroupBids-
−field deduplicationMode
-
-
≠enum Criterion.Type-
+value MOBILE_APPLICATION -
+value MOBILE_APP_CATEGORY
-
-
≠enum CriterionTypeGroup -
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
≠type NetworkSetting-
−field targetContentContextual
-
-
-
≠ReportDefinitionService (0 new, 3 changed, 0 removed)-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
≠enum ReportDefinition.ReportType
-
-
≠TargetingIdeaService (2 new, 4 changed, 0 removed)-
+type MobileAppCategory -
+type MobileApplication -
≠enum AttributeType-
−value AD_SHARE -
−value SEARCH_SHARE
-
-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠enum Criterion.Type-
+value MOBILE_APPLICATION -
+value MOBILE_APP_CATEGORY
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
-
≠TrafficEstimatorService (2 new, 4 changed, 0 removed)-
+type MobileAppCategory -
+type MobileApplication -
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠enum Criterion.Type-
+value MOBILE_APPLICATION -
+value MOBILE_APP_CATEGORY
-
-
≠enum InternalApiError.Reason-
+value DOWNTIME
-
-
≠type NetworkSetting-
−field targetContentContextual
-
-
-
≠UserListService (0 new, 2 changed, 0 removed)-
≠enum AuthorizationError.Reason-
+value SERVICE_ACCESS_DENIED
-
-
≠enum InternalApiError.Reason-
+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
AdServingOptimizationStatusvalues. 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.TargetRestrictSettingandAdGroupService.TargetingSetting. -
AdSchedulecriterion -
The new
AdSchedulecriterion inCampaignCriterionServiceallows you to specify day and time in targeting ads. -
LocationTargetingStatus -
The new
targetingStatusfield indicates whether a particular location is active, obsolete, or is about to become obsolete. -
BiddingTransition -
BiddingTransitionno longer requires a default bid viaexplicitAdGroupBids. - AWQL
- The AdWords Query Language (AWQL) is a SQL-like language that is now available on some services including AdHoc reports.
-
getUserInterestsandgetVerticalsinConstantDataService - You can retrieve a list of user interests and verticals with these two new methods.
- Deprecated
CreateAccountServiceandServicedAccountServicehave been replaced withCustomerServiceandManagedCustomerService.The following
Statsfields have been removed fromAdGroupCriterionService. They can be retrieved through reports instead.avgCostForOfflineInteractionconversionRateconversionsManyPerClickconversionRateManyPerClickcostPerConversioncostPerConversionManyPerClickinvalidClicksinvalidClickRatenumOfflineImpressionsnumOfflineInteractionsofflineInteractionCostofflineInteractionRatetotalConvValuevaluePerConvvaluePerConvManyPerClick
- Migration Guide
- Breaking changes introduced in this version are summarized in the v201206 migration guide.
API Changes
-
-CreateAccountService -
-ServicedAccountService -
≠AdExtensionOverrideService (4 new, 3 changed, 0 removed)-
+type AdxError -
+enum AdxError.Reason -
+type DomainInfoExtension -
+type InAppLinkExtension -
≠type AdExtensionOverrideReturnValue-
+field partialFailureErrors
-
-
≠type AdxError-
+field reason
-
-
≠type Stats-
−field avgCallDurationSecs -
−field avgCostForOfflineInteraction -
−field callDurationSecs -
−field conversionRate -
−field conversionRateManyPerClick -
−field conversionsManyPerClick -
−field costPerConversion -
−field costPerConversionManyPerClick -
−field invalidClickRate -
−field invalidClicks -
−field numCalls -
−field numMissedCalls -
−field numOfflineImpressions -
−field numOfflineInteractions -
−field numReceivedCalls -
−field offlineInteractionCost -
−field offlineInteractionRate -
−field totalConvValue -
−field valuePerConv -
−field valuePerConvManyPerClick
-
-
-
≠AdGroupAdService (9 new, 12 changed, 0 removed)-
+type AdxError -
+enum AdxError.Reason -
+type BetaError -
+enum BetaError.Reason -
+type DynamicSearchAd -
+type QueryError -
+enum QueryError.Reason -
+enum RichMediaAd.RichMediaAdType -
+operation query -
≠type Ad-
−field approvalStatus -
−field trademarkDisapproved
-
-
≠enum AdError.Reason-
+value INVALID_DSA_URL_TAG -
+value MISSING_DESTINATION_URL_TAG -
+value URL_SCHEME_BEFORE_DSA_TAG
-
-
≠type AdGroupAd-
+field approvalStatus -
+field trademarkDisapproved
-
-
≠type AdxError-
+field reason
-
-
≠type BetaError-
+field reason
-
-
≠enum MediaError.Reason-
+value MEDIA_NOT_TRANSCODED
-
-
≠type QueryError-
+field reason
-
-
≠type RichMediaAd-
+field adDuration -
+field richMediaAdType -
+field sourceUrl
-
-
≠enum SelectorError.Reason -
≠type Stats-
−field avgCallDurationSecs -
−field avgCostForOfflineInteraction -
−field callDurationSecs -
−field conversionRate -
−field conversionRateManyPerClick -
−field conversionsManyPerClick -
−field costPerConversion -
−field costPerConversionManyPerClick -
−field invalidClickRate -
−field invalidClicks -
−field numCalls -
−field numMissedCalls -
−field numOfflineImpressions -
−field numOfflineInteractions -
−field numReceivedCalls -
−field offlineInteractionCost -
−field offlineInteractionRate -
−field totalConvValue -
−field valuePerConv -
−field valuePerConvManyPerClick
-
-
≠enum TemplateElementField.Type-
+value UNKNOWN
-
-
≠operation query
-
-
≠AdGroupCriterionService (6 new, 10 changed, 0 removed)-
+type AdxError -
+enum AdxError.Reason -
+type QueryError -
+enum QueryError.Reason -
+type Webpage -
+operation query -
≠enum AdGroupCriterionError.Reason-
+value MISSING_DESTINATION_URL_TAG
-
-
≠type AdxError-
+field reason
-
-
≠type BiddableAdGroupCriterion-
+field disapprovalReasons
-
-
≠enum Criterion.Type-
+value WEBPAGE -
+value MOBILE_DEVICE -
+value AD_SCHEDULE
-
-
≠enum CriterionError.Reason-
+value YOUTUBE_VERTICAL_CHANNEL_DEPRECATED -
+value YOUTUBE_DEMOGRAPHIC_CHANNEL_DEPRECATED -
+value AD_SCHEDULE_TIME_INTERVALS_OVERLAP -
+value AD_SCHEDULE_INTERVAL_CANNOT_SPAN_MULTIPLE_DAYS -
+value AD_SCHEDULE_INVALID_TIME_INTERVAL -
+value AD_SCHEDULE_EXCEEDED_INTERVALS_PER_DAY_LIMIT -
+value AD_SCHEDULE_CRITERION_ID_MISMATCHING_FIELDS -
+value CANNOT_BID_MODIFY_CRITERION_TYPE -
+value CANNOT_BID_MODIFY_NEGATIVE_CRITERION -
+value ACCOUNT_INELIGIBLE_FOR_CRITERIA_TYPE -
+value CRITERIA_TYPE_INVALID_FOR_BIDDING_STRATEGY
-
-
≠type QueryError-
+field reason
-
-
≠enum SelectorError.Reason -
≠type Stats-
−field avgCallDurationSecs -
−field avgCostForOfflineInteraction -
−field callDurationSecs -
−field conversionRate -
−field conversionRateManyPerClick -
−field conversionsManyPerClick -
−field costPerConversion -
−field costPerConversionManyPerClick -
−field invalidClickRate -
−field invalidClicks -
−field numCalls -
−field numMissedCalls -
−field numOfflineImpressions -
−field numOfflineInteractions -
−field numReceivedCalls -
−field offlineInteractionCost -
−field offlineInteractionRate -
−field totalConvValue -
−field valuePerConv -
−field valuePerConvManyPerClick
-
-
≠type Vertical-
+field verticalId -
+field verticalParentId
-
-
≠operation query
-
-
≠AdGroupService (11 new, 13 changed, 0 removed)-
+type AdxError -
+enum AdxError.Reason -
+enum CriterionTypeGroup -
+type EntityCountLimitExceeded -
+enum EntityCountLimitExceeded.Reason -
+type QueryError -
+enum QueryError.Reason -
+type SettingError -
+enum SettingError.Reason -
+type TargetingSetting -
+operation query -
≠type AdGroup-
+field forwardCompatibilityMap -
+field settings
-
-
≠type AdGroupReturnValue-
+field partialFailureErrors
-
-
≠type AdxError-
+field reason
-
-
≠type BudgetOptimizerAdGroupBids-
−field proxySiteMaxCpc
-
-
≠type EntityCountLimitExceeded-
+field reason
-
-
≠type ManualCPCAdGroupBids-
−field siteMaxCpc
-
-
≠type QueryError-
+field reason
-
-
≠enum SelectorError.Reason -
≠type SettingError-
+field reason
-
-
≠enum SettingError.Reason -
≠type Stats-
−field avgCallDurationSecs -
−field avgCostForOfflineInteraction -
−field callDurationSecs -
−field conversionRate -
−field conversionRateManyPerClick -
−field conversionsManyPerClick -
−field costPerConversion -
−field costPerConversionManyPerClick -
−field invalidClickRate -
−field invalidClicks -
−field numCalls -
−field numMissedCalls -
−field numOfflineImpressions -
−field numOfflineInteractions -
−field numReceivedCalls -
−field offlineInteractionCost -
−field offlineInteractionRate -
−field totalConvValue -
−field valuePerConv -
−field valuePerConvManyPerClick
-
-
≠type TargetingSettingDetail-
+field criterionTypeGroup
-
-
≠operation query
-
-
≠AdParamService (2 new, 2 changed, 0 removed)-
+type AdxError -
+enum AdxError.Reason -
≠type AdxError-
+field reason
-
-
≠enum SelectorError.Reason
-
-
=AlertService (no changes) -
≠BudgetOrderService (0 new, 1 changed, 0 removed)-
≠enum SelectorError.Reason
-
-
≠BulkMutateJobService (16 new, 36 changed, 0 removed)-
+type AdSchedule -
+type AdxError -
+enum AdxError.Reason -
+enum CriterionTypeGroup -
+type DomainInfoExtension -
+type DynamicSearchAd -
+type InAppLinkExtension -
+type MobileDevice -
+enum MobileDevice.DeviceType -
+type QueryError -
+enum QueryError.Reason -
+enum RichMediaAd.RichMediaAdType -
+type TargetRestrictSetting -
+type TargetingSetting -
+type UnknownBiddingStrategy -
+type Webpage -
≠type Ad-
−field approvalStatus -
−field trademarkDisapproved
-
-
≠enum AdError.Reason-
+value INVALID_DSA_URL_TAG -
+value MISSING_DESTINATION_URL_TAG -
+value URL_SCHEME_BEFORE_DSA_TAG
-
-
≠enum AdExtensionError.Reason -
≠type AdGroup-
+field forwardCompatibilityMap -
+field settings
-
-
≠type AdGroupAd-
+field approvalStatus -
+field trademarkDisapproved
-
-
≠enum AdGroupCriterionError.Reason-
+value MISSING_DESTINATION_URL_TAG
-
-
≠enum AdServingOptimizationStatus-
+value CONVERSION_OPTIMIZE
-
-
≠type AdxError-
+field reason
-
-
≠type BiddableAdGroupCriterion-
+field disapprovalReasons
-
-
≠type BiddingTransition-
−field explicitAdGroupBids
-
-
≠enum Budget.BudgetPeriod-
−value MONTHLY
-
-
≠enum BudgetError.Reason-
−value MONEY_AMOUNT_LESS_THAN_MAXIMUM_AD_GROUP_CPM -
−value MONEY_AMOUNT_LESS_THAN_MAXIMUM_SITE_CPM -
−value MONEY_AMOUNT_LESS_THAN_MINIMUM_AD_GROUP_CPC -
−value MONEY_AMOUNT_LESS_THAN_MINIMUM_CRITERIA_CPC
-
-
≠type BudgetOptimizerAdGroupBids-
−field proxySiteMaxCpc
-
-
≠enum BulkMutateJobError.Reason-
+value SERVICE_PROVIDED_NO_RESULT -
−value TOO_FEW_OPERATIONS_IN_JOB
-
-
≠type BulkMutateJobSelector-
−field jobStatuses
-
-
≠type Campaign-
+field forwardCompatibilityMap
-
-
≠type CampaignCriterion-
+field bidModifier
-
-
≠enum CampaignCriterionError.Reason-
+value LICENSED_USERLISTS_NOT_ALLOWED -
+value CANNOT_TARGET_AND_EXCLUDE -
+value OPERATOR_NOT_SUPPORTED_FOR_CRITERION_TYPE
-
-
≠enum CampaignError.Reason-
+value MUST_SPECIFY_KEYWORD_MATCH_SETTINGS -
−value FREQUENCY_CAP_TIME_UNIT_CANNOT_BE_NULL -
−value FREQUENCY_CAP_LEVEL_CANNOT_BE_NULL
-
-
≠enum Criterion.Type-
+value WEBPAGE -
+value MOBILE_DEVICE -
+value AD_SCHEDULE
-
-
≠enum CriterionError.Reason-
+value YOUTUBE_VERTICAL_CHANNEL_DEPRECATED -
+value YOUTUBE_DEMOGRAPHIC_CHANNEL_DEPRECATED -
+value AD_SCHEDULE_TIME_INTERVALS_OVERLAP -
+value AD_SCHEDULE_INTERVAL_CANNOT_SPAN_MULTIPLE_DAYS -
+value AD_SCHEDULE_INVALID_TIME_INTERVAL -
+value AD_SCHEDULE_EXCEEDED_INTERVALS_PER_DAY_LIMIT -
+value AD_SCHEDULE_CRITERION_ID_MISMATCHING_FIELDS -
+value CANNOT_BID_MODIFY_CRITERION_TYPE -
+value CANNOT_BID_MODIFY_NEGATIVE_CRITERION -
+value ACCOUNT_INELIGIBLE_FOR_CRITERIA_TYPE -
+value CRITERIA_TYPE_INVALID_FOR_BIDDING_STRATEGY
-
-
≠type Job-
−field customerJobKey
-
-
≠type Location-
+field targetingStatus -
−field isObsolete
-
-
≠type ManualCPCAdGroupBids-
−field siteMaxCpc
-
-
≠enum MediaError.Reason-
+value MEDIA_NOT_TRANSCODED
-
-
≠type MobileDevice-
+field deviceType
-
-
≠type OperatingSystemVersion-
+field name -
+field operatorType -
+field osMajorVersion -
+field osMinorVersion
-
-
≠type QueryError-
+field reason
-
-
≠type RichMediaAd-
+field adDuration -
+field richMediaAdType -
+field sourceUrl
-
-
≠enum SelectorError.Reason -
≠enum SettingError.Reason -
≠type Stats-
−field avgCallDurationSecs -
−field avgCostForOfflineInteraction -
−field callDurationSecs -
−field conversionRate -
−field conversionRateManyPerClick -
−field conversionsManyPerClick -
−field costPerConversion -
−field costPerConversionManyPerClick -
−field invalidClickRate -
−field invalidClicks -
−field numCalls -
−field numMissedCalls -
−field numOfflineImpressions -
−field numOfflineInteractions -
−field numReceivedCalls -
−field offlineInteractionCost -
−field offlineInteractionRate -
−field totalConvValue -
−field valuePerConv -
−field valuePerConvManyPerClick
-
-
≠enum TargetError.Reason-
+value CANNOT_MODIFY_CONTENT_CONTEXTUAL -
−value TARGET_IS_ENCLOSED_BY_ANOTHER_TARGET -
−value TARGET_IS_EXCLUDED_BY_ANOTHER_TARGET
-
-
≠type TargetingSettingDetail-
+field criterionTypeGroup
-
-
≠enum TemplateElementField.Type-
+value UNKNOWN
-
-
≠type Vertical-
+field verticalId -
+field verticalParentId
-
-
-
≠CampaignAdExtensionService (6 new, 6 changed, 0 removed)-
+type AdxError -
+enum AdxError.Reason -
+type DomainInfoExtension -
+type EntityCountLimitExceeded -
+enum EntityCountLimitExceeded.Reason -
+type InAppLinkExtension -
≠enum AdExtensionError.Reason -
≠type AdxError-
+field reason
-
-
≠type CampaignAdExtensionReturnValue-
+field partialFailureErrors
-
-
≠type EntityCountLimitExceeded-
+field reason
-
-
≠enum SelectorError.Reason -
≠type Stats-
−field avgCallDurationSecs -
−field avgCostForOfflineInteraction -
−field callDurationSecs -
−field conversionRate -
−field conversionRateManyPerClick -
−field conversionsManyPerClick -
−field costPerConversion -
−field costPerConversionManyPerClick -
−field invalidClickRate -
−field invalidClicks -
−field numCalls -
−field numMissedCalls -
−field numOfflineImpressions -
−field numOfflineInteractions -
−field numReceivedCalls -
−field offlineInteractionCost -
−field offlineInteractionRate -
−field totalConvValue -
−field valuePerConv -
−field valuePerConvManyPerClick
-
-
-
≠CampaignCriterionService (11 new, 14 changed, 0 removed)-
+type AdSchedule -
+type AdxError -
+enum AdxError.Reason -
+enum DayOfWeek -
+enum MinuteOfHour -
+type MobileDevice -
+enum MobileDevice.DeviceType -
+type QueryError -
+enum QueryError.Reason -
+type Webpage -
+operation query -
≠type AdSchedule-
+field dayOfWeek -
+field endMinute -
+field startMinute
-
-
≠type AdxError-
+field reason
-
-
≠type CampaignCriterion-
+field bidModifier
-
-
≠enum CampaignCriterionError.Reason-
+value LICENSED_USERLISTS_NOT_ALLOWED -
+value CANNOT_TARGET_AND_EXCLUDE -
+value OPERATOR_NOT_SUPPORTED_FOR_CRITERION_TYPE
-
-
≠type CampaignCriterionReturnValue-
+field partialFailureErrors
-
-
≠enum Criterion.Type-
+value WEBPAGE -
+value MOBILE_DEVICE -
+value AD_SCHEDULE
-
-
≠enum CriterionError.Reason-
+value YOUTUBE_VERTICAL_CHANNEL_DEPRECATED -
+value YOUTUBE_DEMOGRAPHIC_CHANNEL_DEPRECATED -
+value AD_SCHEDULE_TIME_INTERVALS_OVERLAP -
+value AD_SCHEDULE_INTERVAL_CANNOT_SPAN_MULTIPLE_DAYS -
+value AD_SCHEDULE_INVALID_TIME_INTERVAL -
+value AD_SCHEDULE_EXCEEDED_INTERVALS_PER_DAY_LIMIT -
+value AD_SCHEDULE_CRITERION_ID_MISMATCHING_FIELDS -
+value CANNOT_BID_MODIFY_CRITERION_TYPE -
+value CANNOT_BID_MODIFY_NEGATIVE_CRITERION -
+value ACCOUNT_INELIGIBLE_FOR_CRITERIA_TYPE -
+value CRITERIA_TYPE_INVALID_FOR_BIDDING_STRATEGY
-
-
≠type Location-
+field targetingStatus -
−field isObsolete
-
-
≠type MobileDevice-
+field deviceType
-
-
≠type OperatingSystemVersion-
+field name -
+field operatorType -
+field osMajorVersion -
+field osMinorVersion
-
-
≠type QueryError-
+field reason
-
-
≠enum SelectorError.Reason -
≠type Vertical-
+field verticalId -
+field verticalParentId
-
-
≠operation query
-
-
≠CampaignService (10 new, 18 changed, 0 removed)-
+type AdxError -
+enum AdxError.Reason -
+enum CriterionTypeGroup -
+type EntityCountLimitExceeded -
+enum EntityCountLimitExceeded.Reason -
+type QueryError -
+enum QueryError.Reason -
+type TargetRestrictSetting -
+type UnknownBiddingStrategy -
+operation query -
≠enum AdServingOptimizationStatus-
+value CONVERSION_OPTIMIZE
-
-
≠type AdxError-
+field reason
-
-
≠type BiddingTransition-
−field explicitAdGroupBids
-
-
≠enum Budget.BudgetPeriod-
−value MONTHLY
-
-
≠enum BudgetError.Reason-
−value MONEY_AMOUNT_LESS_THAN_MAXIMUM_AD_GROUP_CPM -
−value MONEY_AMOUNT_LESS_THAN_MAXIMUM_SITE_CPM -
−value MONEY_AMOUNT_LESS_THAN_MINIMUM_AD_GROUP_CPC -
−value MONEY_AMOUNT_LESS_THAN_MINIMUM_CRITERIA_CPC
-
-
≠type BudgetOptimizerAdGroupBids-
−field proxySiteMaxCpc
-
-
≠type Campaign-
+field forwardCompatibilityMap
-
-
≠enum CampaignError.Reason-
+value MUST_SPECIFY_KEYWORD_MATCH_SETTINGS -
−value FREQUENCY_CAP_TIME_UNIT_CANNOT_BE_NULL -
−value FREQUENCY_CAP_LEVEL_CANNOT_BE_NULL
-
-
≠type CampaignReturnValue-
+field partialFailureErrors
-
-
≠type EntityCountLimitExceeded-
+field reason
-
-
≠type ManualCPCAdGroupBids-
−field siteMaxCpc
-
-
≠type QueryError-
+field reason
-
-
≠enum SelectorError.Reason -
≠enum SettingError.Reason -
≠type Stats-
−field avgCallDurationSecs -
−field avgCostForOfflineInteraction -
−field callDurationSecs -
−field conversionRate -
−field conversionRateManyPerClick -
−field conversionsManyPerClick -
−field costPerConversion -
−field costPerConversionManyPerClick -
−field invalidClickRate -
−field invalidClicks -
−field numCalls -
−field numMissedCalls -
−field numOfflineImpressions -
−field numOfflineInteractions -
−field numReceivedCalls -
−field offlineInteractionCost -
−field offlineInteractionRate -
−field totalConvValue -
−field valuePerConv -
−field valuePerConvManyPerClick
-
-
≠enum TargetError.Reason-
+value CANNOT_MODIFY_CONTENT_CONTEXTUAL -
−value TARGET_IS_ENCLOSED_BY_ANOTHER_TARGET -
−value TARGET_IS_EXCLUDED_BY_ANOTHER_TARGET
-
-
≠type TargetingSettingDetail-
+field criterionTypeGroup
-
-
≠operation query
-
-
≠ConstantDataService (13 new, 12 changed, 0 removed)-
+type AdxError -
+enum AdxError.Reason -
+type AgeRange -
+type BetaError -
+enum BetaError.Reason -
+type Gender -
+type MobileDevice -
+operation getAgeRangeCriterion -
+operation getGenderCriterion -
+operation getMobileDeviceCriterion -
+operation getOperatingSystemVersionCriterion -
+operation getUserInterestCriterion -
+operation getVerticalCriterion -
≠type AdxError-
+field reason
-
-
≠type BetaError-
+field reason
-
-
≠enum Criterion.Type-
+value WEBPAGE -
+value MOBILE_DEVICE -
+value AD_SCHEDULE
-
-
≠type OperatingSystemVersion-
+field name -
+field operatorType -
+field osMajorVersion -
+field osMinorVersion
-
-
≠enum SelectorError.Reason -
≠type Vertical-
+field verticalId -
+field verticalParentId
-
-
≠operation getAgeRangeCriterion-
+response rval
-
-
≠operation getGenderCriterion-
+response rval
-
-
≠operation getMobileDeviceCriterion-
+response rval
-
-
≠operation getOperatingSystemVersionCriterion-
+response rval
-
-
≠operation getUserInterestCriterion-
+response rval
-
-
≠operation getVerticalCriterion-
+response rval
-
-
-
≠ConversionTrackerService (2 new, 4 changed, 0 removed)-
+type OperationAccessDenied -
+enum OperationAccessDenied.Reason -
≠type AdWordsConversionTracker-
+field trackingCodeType
-
-
≠enum ConversionTrackingError.Reason-
+value CANNOT_CHANGE_APP_CONVERSION_TYPE -
+value CANNOT_CHANGE_APP_PLATFORM -
+value DUPLICATE_APP_ID -
+value INVALID_APP_ID -
+value MUST_SET_APP_PLATFORM_AND_APP_CONVERSION_TYPE_TOGETHER
-
-
≠type OperationAccessDenied-
+field reason
-
-
≠enum SelectorError.Reason
-
-
=CustomerService (no changes) -
=CustomerSyncService (no changes) -
≠DataService (2 new, 2 changed, 0 removed)-
+type AdxError -
+enum AdxError.Reason -
≠type AdxError-
+field reason
-
-
≠enum SelectorError.Reason
-
-
≠ExperimentService (2 new, 3 changed, 0 removed)-
+type AdxError -
+enum AdxError.Reason -
≠type AdxError-
+field reason
-
-
≠enum BudgetError.Reason-
−value MONEY_AMOUNT_LESS_THAN_MAXIMUM_AD_GROUP_CPM -
−value MONEY_AMOUNT_LESS_THAN_MAXIMUM_SITE_CPM -
−value MONEY_AMOUNT_LESS_THAN_MINIMUM_AD_GROUP_CPC -
−value MONEY_AMOUNT_LESS_THAN_MINIMUM_CRITERIA_CPC
-
-
≠enum SelectorError.Reason
-
-
=GeoLocationService (no changes) -
=InfoService (no changes) -
≠LocationCriterionService (2 new, 6 changed, 0 removed)-
+type AdxError -
+enum AdxError.Reason -
≠type AdxError-
+field reason
-
-
≠enum Criterion.Type-
+value WEBPAGE -
+value MOBILE_DEVICE -
+value AD_SCHEDULE
-
-
≠type Location-
+field targetingStatus -
−field isObsolete
-
-
≠type LocationCriterion-
+field countryCode
-
-
≠enum LocationCriterionServiceError.Reason-
+value INVALID_COUNTRY_CODE
-
-
≠enum SelectorError.Reason
-
-
≠ManagedCustomerService (0 new, 1 changed, 0 removed)-
≠enum SelectorError.Reason
-
-
≠MediaService (0 new, 2 changed, 0 removed)-
≠enum MediaError.Reason-
+value MEDIA_NOT_TRANSCODED
-
-
≠enum SelectorError.Reason
-
-
≠MutateJobService (16 new, 36 changed, 0 removed)-
+type AdSchedule -
+type AdxError -
+enum AdxError.Reason -
+enum CriterionTypeGroup -
+type DomainInfoExtension -
+type DynamicSearchAd -
+type InAppLinkExtension -
+type MobileDevice -
+enum MobileDevice.DeviceType -
+type QueryError -
+enum QueryError.Reason -
+enum RichMediaAd.RichMediaAdType -
+type TargetRestrictSetting -
+type TargetingSetting -
+type UnknownBiddingStrategy -
+type Webpage -
≠type Ad-
−field approvalStatus -
−field trademarkDisapproved
-
-
≠enum AdError.Reason-
+value INVALID_DSA_URL_TAG -
+value MISSING_DESTINATION_URL_TAG -
+value URL_SCHEME_BEFORE_DSA_TAG
-
-
≠enum AdExtensionError.Reason -
≠type AdGroup-
+field forwardCompatibilityMap -
+field settings
-
-
≠type AdGroupAd-
+field approvalStatus -
+field trademarkDisapproved
-
-
≠enum AdGroupCriterionError.Reason-
+value MISSING_DESTINATION_URL_TAG
-
-
≠enum AdServingOptimizationStatus-
+value CONVERSION_OPTIMIZE
-
-
≠type AdxError-
+field reason
-
-
≠type BiddableAdGroupCriterion-
+field disapprovalReasons
-
-
≠type BiddingTransition-
−field explicitAdGroupBids
-
-
≠enum Budget.BudgetPeriod-
−value MONTHLY
-
-
≠enum BudgetError.Reason-
−value MONEY_AMOUNT_LESS_THAN_MAXIMUM_AD_GROUP_CPM -
−value MONEY_AMOUNT_LESS_THAN_MAXIMUM_SITE_CPM -
−value MONEY_AMOUNT_LESS_THAN_MINIMUM_AD_GROUP_CPC -
−value MONEY_AMOUNT_LESS_THAN_MINIMUM_CRITERIA_CPC
-
-
≠type BudgetOptimizerAdGroupBids-
−field proxySiteMaxCpc
-
-
≠enum BulkMutateJobError.Reason-
+value SERVICE_PROVIDED_NO_RESULT -
−value TOO_FEW_OPERATIONS_IN_JOB
-
-
≠type BulkMutateJobSelector-
−field jobStatuses
-
-
≠type Campaign-
+field forwardCompatibilityMap
-
-
≠type CampaignCriterion-
+field bidModifier
-
-
≠enum CampaignCriterionError.Reason-
+value LICENSED_USERLISTS_NOT_ALLOWED -
+value CANNOT_TARGET_AND_EXCLUDE -
+value OPERATOR_NOT_SUPPORTED_FOR_CRITERION_TYPE
-
-
≠enum CampaignError.Reason-
+value MUST_SPECIFY_KEYWORD_MATCH_SETTINGS -
−value FREQUENCY_CAP_TIME_UNIT_CANNOT_BE_NULL -
−value FREQUENCY_CAP_LEVEL_CANNOT_BE_NULL
-
-
≠enum Criterion.Type-
+value WEBPAGE -
+value MOBILE_DEVICE -
+value AD_SCHEDULE
-
-
≠enum CriterionError.Reason-
+value YOUTUBE_VERTICAL_CHANNEL_DEPRECATED -
+value YOUTUBE_DEMOGRAPHIC_CHANNEL_DEPRECATED -
+value AD_SCHEDULE_TIME_INTERVALS_OVERLAP -
+value AD_SCHEDULE_INTERVAL_CANNOT_SPAN_MULTIPLE_DAYS -
+value AD_SCHEDULE_INVALID_TIME_INTERVAL -
+value AD_SCHEDULE_EXCEEDED_INTERVALS_PER_DAY_LIMIT -
+value AD_SCHEDULE_CRITERION_ID_MISMATCHING_FIELDS -
+value CANNOT_BID_MODIFY_CRITERION_TYPE -
+value CANNOT_BID_MODIFY_NEGATIVE_CRITERION -
+value ACCOUNT_INELIGIBLE_FOR_CRITERIA_TYPE -
+value CRITERIA_TYPE_INVALID_FOR_BIDDING_STRATEGY
-
-
≠type Job-
−field customerJobKey
-
-
≠type Location-
+field targetingStatus -
−field isObsolete
-
-
≠type ManualCPCAdGroupBids-
−field siteMaxCpc
-
-
≠enum MediaError.Reason-
+value MEDIA_NOT_TRANSCODED
-
-
≠type MobileDevice-
+field deviceType
-
-
≠type OperatingSystemVersion-
+field name -
+field operatorType -
+field osMajorVersion -
+field osMinorVersion
-
-
≠type QueryError-
+field reason
-
-
≠type RichMediaAd-
+field adDuration -
+field richMediaAdType -
+field sourceUrl
-
-
≠enum SelectorError.Reason -
≠enum SettingError.Reason -
≠type Stats-
−field avgCallDurationSecs -
−field avgCostForOfflineInteraction -
−field callDurationSecs -
−field conversionRate -
−field conversionRateManyPerClick -
−field conversionsManyPerClick -
−field costPerConversion -
−field costPerConversionManyPerClick -
−field invalidClickRate -
−field invalidClicks -
−field numCalls -
−field numMissedCalls -
−field numOfflineImpressions -
−field numOfflineInteractions -
−field numReceivedCalls -
−field offlineInteractionCost -
−field offlineInteractionRate -
−field totalConvValue -
−field valuePerConv -
−field valuePerConvManyPerClick
-
-
≠enum TargetError.Reason-
+value CANNOT_MODIFY_CONTENT_CONTEXTUAL -
−value TARGET_IS_ENCLOSED_BY_ANOTHER_TARGET -
−value TARGET_IS_EXCLUDED_BY_ANOTHER_TARGET
-
-
≠type TargetingSettingDetail-
+field criterionTypeGroup
-
-
≠enum TemplateElementField.Type-
+value UNKNOWN
-
-
≠type Vertical-
+field verticalId -
+field verticalParentId
-
-
-
≠ReportDefinitionService (0 new, 5 changed, 1 removed)-
≠type ReportDefinition-
−field creationTime -
−field hasAttachment
-
-
≠enum ReportDefinition.ReportType-
+value ACCOUNT_REACH_FREQUENCY_REPORT -
+value CAMPAIGN_REACH_FREQUENCY_REPORT -
+value ADGROUP_REACH_FREQUENCY_REPORT -
+value CLICK_PERFORMANCE_REPORT
-
-
≠enum ReportDefinitionError.Reason-
+value INVALID_DATE_RANGE_FOR_REPORT
-
-
≠enum SelectorError.Reason -
≠operation get-
−response rval -
−parameter selector
-
-
−operation get
-
-
≠TargetingIdeaService (4 new, 9 changed, 6 removed)-
+type AdSpecListAttribute -
+type AdSpecListSearchParameter -
+type RelatedToQuerySearchParameter -
+type Webpage -
≠enum AdGroupCriterionError.Reason-
+value MISSING_DESTINATION_URL_TAG
-
-
≠enum AttributeType-
+value AD_TYPE_SPEC -
+value KEYWORD_TEXT -
+value SEARCH_VOLUME -
−value AVERAGE_TARGETED_MONTHLY_SEARCHES -
−value FORMATS -
−value GLOBAL_MONTHLY_SEARCHES
-
-
≠enum BudgetError.Reason-
−value MONEY_AMOUNT_LESS_THAN_MAXIMUM_AD_GROUP_CPM -
−value MONEY_AMOUNT_LESS_THAN_MAXIMUM_SITE_CPM -
−value MONEY_AMOUNT_LESS_THAN_MINIMUM_AD_GROUP_CPC -
−value MONEY_AMOUNT_LESS_THAN_MINIMUM_CRITERIA_CPC
-
-
≠enum Criterion.Type-
+value WEBPAGE -
+value MOBILE_DEVICE -
+value AD_SCHEDULE
-
-
≠enum CriterionError.Reason-
+value YOUTUBE_VERTICAL_CHANNEL_DEPRECATED -
+value YOUTUBE_DEMOGRAPHIC_CHANNEL_DEPRECATED -
+value AD_SCHEDULE_TIME_INTERVALS_OVERLAP -
+value AD_SCHEDULE_INTERVAL_CANNOT_SPAN_MULTIPLE_DAYS -
+value AD_SCHEDULE_INVALID_TIME_INTERVAL -
+value AD_SCHEDULE_EXCEEDED_INTERVALS_PER_DAY_LIMIT -
+value AD_SCHEDULE_CRITERION_ID_MISMATCHING_FIELDS -
+value CANNOT_BID_MODIFY_CRITERION_TYPE -
+value CANNOT_BID_MODIFY_NEGATIVE_CRITERION -
+value ACCOUNT_INELIGIBLE_FOR_CRITERIA_TYPE -
+value CRITERIA_TYPE_INVALID_FOR_BIDDING_STRATEGY
-
-
≠type Location-
+field targetingStatus -
−field isObsolete
-
-
≠enum TargetError.Reason-
+value CANNOT_MODIFY_CONTENT_CONTEXTUAL -
−value TARGET_IS_ENCLOSED_BY_ANOTHER_TARGET -
−value TARGET_IS_EXCLUDED_BY_ANOTHER_TARGET
-
-
≠enum TrafficEstimatorError.Reason-
+value KEYWORD_TOO_LONG -
+value KEYWORD_CONTAINS_BROAD_MATCH_MODIFIERS
-
-
≠type Vertical-
+field verticalId -
+field verticalParentId
-
-
−type AdTypeSearchParameter -
−type AverageTargetedMonthlySearchesSearchParameter -
−type GlobalMonthlySearchesSearchParameter -
−type KeywordMatchTypeSearchParameter -
−type RelatedToKeywordSearchParameter -
−enum SiteConstants.AdType
-
-
≠TrafficEstimatorService (4 new, 7 changed, 0 removed)-
+type AdSchedule -
+type MobileDevice -
+enum MobileDevice.DeviceType -
+type Webpage -
≠enum Criterion.Type-
+value WEBPAGE -
+value MOBILE_DEVICE -
+value AD_SCHEDULE
-
-
≠type Location-
+field targetingStatus -
−field isObsolete
-
-
≠type MobileDevice-
+field deviceType
-
-
≠type OperatingSystemVersion-
+field name -
+field operatorType -
+field osMajorVersion -
+field osMinorVersion
-
-
≠enum TargetError.Reason-
+value CANNOT_MODIFY_CONTENT_CONTEXTUAL -
−value TARGET_IS_ENCLOSED_BY_ANOTHER_TARGET -
−value TARGET_IS_EXCLUDED_BY_ANOTHER_TARGET
-
-
≠enum TrafficEstimatorError.Reason-
+value KEYWORD_TOO_LONG -
+value KEYWORD_CONTAINS_BROAD_MATCH_MODIFIERS
-
-
≠type Vertical-
+field verticalId -
+field verticalParentId
-
-
-
≠UserListService (0 new, 1 changed, 0 removed)-
≠enum SelectorError.Reason
-
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 variousOfflineInteractionfields in reports. -
topOfPageCpcsupport
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.
-
Zip code targeting
API Changes
-
-CampaignTargetService -
+CustomerService -
+ManagedCustomerService -
≠AdExtensionOverrideService (0 new, 3 changed, 0 removed)-
≠type LocationSyncExtension-
+field oAuthInfo
-
-
≠type MobileExtension-
+field isCallTrackingEnabled
-
-
≠type Stats-
+field avgCostForOfflineInteraction -
+field numOfflineImpressions -
+field numOfflineInteractions -
+field offlineInteractionCost -
+field offlineInteractionRate
-
-
-
≠AdGroupAdService (1 new, 5 changed, 0 removed)-
+enum ThirdPartyRedirectAd.ExpandingDirection -
≠enum AdError.Reason-
+value INVALID_CHARACTER_FOR_URL -
+value INCONSISTENT_EXPANDABLE_SETTINGS -
+value INVALID_FIELD_TEXT
-
-
≠enum ImageError.Reason-
+value FLASH_WITHOUT_HARD_CODED_CLICK_URL -
+value INVALID_FLASH_FILE -
+value FAILED_TO_FIX_CLICK_TAG_IN_FLASH -
+value FLASH_ACCESSES_NETWORK_RESOURCES -
+value FLASH_EXTERNAL_JS_CALL -
+value FLASH_EXTERNAL_FS_CALL
-
-
≠enum SelectorError.Reason-
+value START_INDEX_IS_TOO_HIGH
-
-
≠type Stats-
+field avgCostForOfflineInteraction -
+field numOfflineImpressions -
+field numOfflineInteractions -
+field offlineInteractionCost -
+field offlineInteractionRate
-
-
≠type ThirdPartyRedirectAd-
+field expandingDirections
-
-
-
≠AdGroupCriterionService (2 new, 5 changed, 0 removed)-
+type BetaError -
+enum BetaError.Reason -
≠type BetaError-
+field reason
-
-
≠type BiddableAdGroupCriterion-
+field topOfPageCpc
-
-
≠enum CriterionError.Reason -
≠enum SelectorError.Reason-
+value START_INDEX_IS_TOO_HIGH
-
-
≠type Stats-
+field avgCostForOfflineInteraction -
+field numOfflineImpressions -
+field numOfflineInteractions -
+field offlineInteractionCost -
+field offlineInteractionRate
-
-
-
≠AdGroupService (4 new, 4 changed, 0 removed)-
+type BetaError -
+enum BetaError.Reason -
+type InteractionBid -
+type PhoneInteractionBid -
≠type AdGroupBids-
+field interactionBids
-
-
≠type BetaError-
+field reason
-
-
≠enum SelectorError.Reason-
+value START_INDEX_IS_TOO_HIGH
-
-
≠type Stats-
+field avgCostForOfflineInteraction -
+field numOfflineImpressions -
+field numOfflineInteractions -
+field offlineInteractionCost -
+field offlineInteractionRate
-
-
-
≠AdParamService (0 new, 1 changed, 0 removed)-
≠enum SelectorError.Reason-
+value START_INDEX_IS_TOO_HIGH
-
-
-
=AlertService (no changes) -
≠BudgetOrderService (0 new, 1 changed, 0 removed)-
≠enum SelectorError.Reason-
+value START_INDEX_IS_TOO_HIGH
-
-
-
≠BulkMutateJobService (6 new, 12 changed, 0 removed)-
+type BetaError -
+enum BetaError.Reason -
+type InteractionBid -
+type KeywordMatchSetting -
+type PhoneInteractionBid -
+enum ThirdPartyRedirectAd.ExpandingDirection -
≠enum AdError.Reason-
+value INVALID_CHARACTER_FOR_URL -
+value INCONSISTENT_EXPANDABLE_SETTINGS -
+value INVALID_FIELD_TEXT
-
-
≠type AdGroupBids-
+field interactionBids
-
-
≠type BetaError-
+field reason
-
-
≠type BiddableAdGroupCriterion-
+field topOfPageCpc
-
-
≠type CampaignCriterion-
+field isNegative
-
-
≠enum CriterionError.Reason -
≠enum ImageError.Reason-
+value FLASH_WITHOUT_HARD_CODED_CLICK_URL -
+value INVALID_FLASH_FILE -
+value FAILED_TO_FIX_CLICK_TAG_IN_FLASH -
+value FLASH_ACCESSES_NETWORK_RESOURCES -
+value FLASH_EXTERNAL_JS_CALL -
+value FLASH_EXTERNAL_FS_CALL
-
-
≠type LocationSyncExtension-
+field oAuthInfo
-
-
≠type MobileExtension-
+field isCallTrackingEnabled
-
-
≠enum SelectorError.Reason-
+value START_INDEX_IS_TOO_HIGH
-
-
≠type Stats-
+field avgCostForOfflineInteraction -
+field numOfflineImpressions -
+field numOfflineInteractions -
+field offlineInteractionCost -
+field offlineInteractionRate
-
-
≠type ThirdPartyRedirectAd-
+field expandingDirections
-
-
-
≠CampaignAdExtensionService (2 new, 5 changed, 0 removed)-
+type BetaError -
+enum BetaError.Reason -
≠type BetaError-
+field reason
-
-
≠type LocationSyncExtension-
+field oAuthInfo
-
-
≠type MobileExtension-
+field isCallTrackingEnabled
-
-
≠enum SelectorError.Reason-
+value START_INDEX_IS_TOO_HIGH
-
-
≠type Stats-
+field avgCostForOfflineInteraction -
+field numOfflineImpressions -
+field numOfflineInteractions -
+field offlineInteractionCost -
+field offlineInteractionRate
-
-
-
≠CampaignCriterionService (2 new, 4 changed, 0 removed)-
+type BetaError -
+enum BetaError.Reason -
≠type BetaError-
+field reason
-
-
≠type CampaignCriterion-
+field isNegative
-
-
≠enum CriterionError.Reason -
≠enum SelectorError.Reason-
+value START_INDEX_IS_TOO_HIGH
-
-
-
≠CampaignService (5 new, 4 changed, 0 removed)-
+type BetaError -
+enum BetaError.Reason -
+type InteractionBid -
+type KeywordMatchSetting -
+type PhoneInteractionBid -
≠type AdGroupBids-
+field interactionBids
-
-
≠type BetaError-
+field reason
-
-
≠enum SelectorError.Reason-
+value START_INDEX_IS_TOO_HIGH
-
-
≠type Stats-
+field avgCostForOfflineInteraction -
+field numOfflineImpressions -
+field numOfflineInteractions -
+field offlineInteractionCost -
+field offlineInteractionRate
-
-
-
≠ConstantDataService (0 new, 1 changed, 0 removed)-
≠enum SelectorError.Reason-
+value START_INDEX_IS_TOO_HIGH
-
-
-
≠ConversionTrackerService (0 new, 1 changed, 0 removed)-
≠enum SelectorError.Reason-
+value START_INDEX_IS_TOO_HIGH
-
-
-
=CreateAccountService (no changes) -
=CustomerSyncService (no changes) -
≠DataService (2 new, 3 changed, 0 removed)-
+type BetaError -
+enum BetaError.Reason -
≠type BetaError-
+field reason
-
-
≠type BidLandscape.LandscapePoint-
+field promotedImpressions
-
-
≠enum SelectorError.Reason-
+value START_INDEX_IS_TOO_HIGH
-
-
-
≠ExperimentService (0 new, 1 changed, 0 removed)-
≠enum SelectorError.Reason-
+value START_INDEX_IS_TOO_HIGH
-
-
-
=GeoLocationService (no changes) -
=InfoService (no changes) -
≠LocationCriterionService (0 new, 1 changed, 0 removed)-
≠enum SelectorError.Reason-
+value START_INDEX_IS_TOO_HIGH
-
-
-
≠MediaService (0 new, 2 changed, 0 removed)-
≠enum ImageError.Reason-
+value FLASH_WITHOUT_HARD_CODED_CLICK_URL -
+value INVALID_FLASH_FILE -
+value FAILED_TO_FIX_CLICK_TAG_IN_FLASH -
+value FLASH_ACCESSES_NETWORK_RESOURCES -
+value FLASH_EXTERNAL_JS_CALL -
+value FLASH_EXTERNAL_FS_CALL
-
-
≠enum SelectorError.Reason-
+value START_INDEX_IS_TOO_HIGH
-
-
-
≠MutateJobService (6 new, 12 changed, 0 removed)-
+type BetaError -
+enum BetaError.Reason -
+type InteractionBid -
+type KeywordMatchSetting -
+type PhoneInteractionBid -
+enum ThirdPartyRedirectAd.ExpandingDirection -
≠enum AdError.Reason-
+value INVALID_CHARACTER_FOR_URL -
+value INCONSISTENT_EXPANDABLE_SETTINGS -
+value INVALID_FIELD_TEXT
-
-
≠type AdGroupBids-
+field interactionBids
-
-
≠type BetaError-
+field reason
-
-
≠type BiddableAdGroupCriterion-
+field topOfPageCpc
-
-
≠type CampaignCriterion-
+field isNegative
-
-
≠enum CriterionError.Reason -
≠enum ImageError.Reason-
+value FLASH_WITHOUT_HARD_CODED_CLICK_URL -
+value INVALID_FLASH_FILE -
+value FAILED_TO_FIX_CLICK_TAG_IN_FLASH -
+value FLASH_ACCESSES_NETWORK_RESOURCES -
+value FLASH_EXTERNAL_JS_CALL -
+value FLASH_EXTERNAL_FS_CALL
-
-
≠type LocationSyncExtension-
+field oAuthInfo
-
-
≠type MobileExtension-
+field isCallTrackingEnabled
-
-
≠enum SelectorError.Reason-
+value START_INDEX_IS_TOO_HIGH
-
-
≠type Stats-
+field avgCostForOfflineInteraction -
+field numOfflineImpressions -
+field numOfflineInteractions -
+field offlineInteractionCost -
+field offlineInteractionRate
-
-
≠type ThirdPartyRedirectAd-
+field expandingDirections
-
-
-
≠ReportDefinitionService (4 new, 5 changed, 0 removed)-
+type BetaError -
+enum BetaError.Reason -
+type StringLengthError -
+enum StringLengthError.Reason -
≠type BetaError-
+field reason
-
-
≠enum ReportDefinition.ReportType-
+value CALL_METRICS_CALL_DETAILS_REPORT -
−value DEMOGRAPHIC_PERFORMANCE_REPORT
-
-
≠type ReportDefinitionField-
+field isBeta
-
-
≠enum SelectorError.Reason-
+value START_INDEX_IS_TOO_HIGH
-
-
≠type StringLengthError-
+field reason
-
-
-
=ServicedAccountService (no changes) -
≠TargetingIdeaService (0 new, 3 changed, 0 removed)-
≠enum AttributeType-
+value CATEGORY_PRODUCTS_AND_SERVICES -
−value KEYWORD_CATEGORY
-
-
≠type BidLandscape.LandscapePoint-
+field promotedImpressions
-
-
≠enum CriterionError.Reason
-
-
=TrafficEstimatorService (no changes) -
≠UserListService (0 new, 1 changed, 0 removed)-
≠enum SelectorError.Reason-
+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
ReportDefinitionswill 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.
- The cross-client (MCC) reporting feature of
- 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
AccountServiceis 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 versions v13, v200909, v201003, v201008, v201101.
API version v13
API Changes
-
+ConstantDataService -
+LocationCriterionService -
+MutateJobService -
≠AdExtensionOverrideService (0 new, 1 changed, 0 removed)-
≠type Stats-
+field avgCallDurationSecs -
+field callDurationSecs -
+field numCalls -
+field numMissedCalls -
+field numReceivedCalls
-
-
-
=AdGroupAdService (no changes) -
≠AdGroupCriterionService (14 new, 10 changed, 0 removed)-
+type Address -
+type AgeRange -
+enum AgeRange.AgeRangeType -
+type Carrier -
+type Gender -
+enum Gender.GenderType -
+type GeoPoint -
+type Language -
+type Location -
+type OperatingSystemVersion -
+type Platform -
+type Polygon -
+type Proximity -
+enum Proximity.DistanceUnits -
≠type AgeRange-
+field ageRangeType
-
-
≠enum BiddingError.Reason-
−value BID_INCOMPATIBLE_WITH_ADGROUP -
−value BID_UNIVERSAL_CRITERIA_EXPECTED -
−value BIDS_DO_NOT_FULFILL_SPEC -
−value NETWORK_NOT_OVERRIDEABLE -
−value CURRENCY_MISMATCH -
−value ADGROUPS_DO_NOT_MATCH_CONSTRAINT -
−value NETWORK_SETTINGS_DO_NOT_SUPPORT_TRANSITION -
−value UNSUPPORTED_STYLE_TRANSITION -
−value UNSUPPORTED_PROXY_BIDDER_STRATEGY_TRANSITION -
−value TRANSITION_DOES_NOT_SUPPORT_OPTION -
−value TRANSITION_DOES_NOT_SUPPORT_GOAL -
−value PROXY_BIDDER_STRATEGY_INCOMPATIBLE_WITH_STYLE -
−value GOAL_DOES_NOT_FULFILL_SPEC -
−value GOAL_VALIDATION_FAILED -
−value UNSUPPORTED_STYLE -
−value BAD_BID_COMBINATION -
−value CANNOT_TARGET_UNIVERSE -
−value NO_DESTINATION_URL_SPECIFIED -
−value NO_EFFECTIVE_BID -
−value CRITERION_NOT_TARGETED -
−value CANNOT_EXCLUDE_DEFAULT -
−value CANNOT_TARGET_AND_EXCLUDE -
−value ILLEGAL_URL -
−value BID_TO_POSITION_NOT_ENABLED -
−value POSITION_PREFERENCE_NOT_ENABLED -
−value POSITION_PREFERENCE_NOT_SUPPORTED_FOR_CRITERIA_TYPE -
−value PREFERRED_POSITION_OUT_OF_RANGE -
−value BOTTOM_POSITION_OUT_OF_RANGE -
−value PREFERRED_POSITION_CANNOT_BE_HIGHER_THAN_BOTTOM -
−value CAMPAIGN_ALREADY_SET -
−value PROXY_NOT_ENABLED -
−value CANNOT_UPDATE_SITE_BIDS_WHILE_PROXY_BIDDING -
−value AUCTION_STRATEGY_INCOMPATIBLE_WITH_PROXY_BIDDER
-
-
≠type Criterion-
+field type
-
-
≠enum Criterion.Type -
≠enum CriterionError.Reason-
+value CANNOT_ADD_CRITERIA_TYPE -
+value INVALID_CRITERION_ID -
+value CANNOT_TARGET_CRITERION -
+value CRITERION_ID_AND_TYPE_MISMATCH -
+value INVALID_PROXIMITY_RADIUS -
+value INVALID_PROXIMITY_RADIUS_UNITS -
+value INVALID_STREETADDRESS_LENGTH -
+value INVALID_CITYNAME_LENGTH -
+value INVALID_REGIONCODE_LENGTH -
+value INVALID_REGIONNAME_LENGTH -
+value INVALID_POSTALCODE_LENGTH -
+value INVALID_COUNTRY_CODE -
+value INVALID_LATITUDE -
+value INVALID_LONGITUDE
-
-
≠type Gender-
+field genderType
-
-
≠type ManualCPCAdGroupCriterionBids-
−field positionPreferenceBids
-
-
≠type Proximity-
+field address -
+field geoPoint -
+field radiusDistanceUnits
-
-
≠enum SelectorError.Reason-
+value MISSING_PREDICATES -
+value INVALID_SORT_FIELD_NAME -
+value SELECTOR_ERROR
-
-
≠type Stats-
+field avgCallDurationSecs -
+field callDurationSecs -
+field numCalls -
+field numMissedCalls -
+field numReceivedCalls
-
-
-
≠AdGroupService (0 new, 3 changed, 0 removed)-
≠enum BiddingError.Reason-
−value BID_INCOMPATIBLE_WITH_ADGROUP -
−value BID_UNIVERSAL_CRITERIA_EXPECTED -
−value BIDS_DO_NOT_FULFILL_SPEC -
−value NETWORK_NOT_OVERRIDEABLE -
−value CURRENCY_MISMATCH -
−value ADGROUPS_DO_NOT_MATCH_CONSTRAINT -
−value NETWORK_SETTINGS_DO_NOT_SUPPORT_TRANSITION -
−value UNSUPPORTED_STYLE_TRANSITION -
−value UNSUPPORTED_PROXY_BIDDER_STRATEGY_TRANSITION -
−value TRANSITION_DOES_NOT_SUPPORT_OPTION -
−value TRANSITION_DOES_NOT_SUPPORT_GOAL -
−value PROXY_BIDDER_STRATEGY_INCOMPATIBLE_WITH_STYLE -
−value GOAL_DOES_NOT_FULFILL_SPEC -
−value GOAL_VALIDATION_FAILED -
−value UNSUPPORTED_STYLE -
−value BAD_BID_COMBINATION -
−value CANNOT_TARGET_UNIVERSE -
−value NO_DESTINATION_URL_SPECIFIED -
−value NO_EFFECTIVE_BID -
−value CRITERION_NOT_TARGETED -
−value CANNOT_EXCLUDE_DEFAULT -
−value CANNOT_TARGET_AND_EXCLUDE -
−value ILLEGAL_URL -
−value BID_TO_POSITION_NOT_ENABLED -
−value POSITION_PREFERENCE_NOT_ENABLED -
−value POSITION_PREFERENCE_NOT_SUPPORTED_FOR_CRITERIA_TYPE -
−value PREFERRED_POSITION_OUT_OF_RANGE -
−value BOTTOM_POSITION_OUT_OF_RANGE -
−value PREFERRED_POSITION_CANNOT_BE_HIGHER_THAN_BOTTOM -
−value CAMPAIGN_ALREADY_SET -
−value PROXY_NOT_ENABLED -
−value CANNOT_UPDATE_SITE_BIDS_WHILE_PROXY_BIDDING -
−value AUCTION_STRATEGY_INCOMPATIBLE_WITH_PROXY_BIDDER
-
-
≠enum SelectorError.Reason-
+value MISSING_PREDICATES -
+value INVALID_SORT_FIELD_NAME -
+value SELECTOR_ERROR
-
-
≠type Stats-
+field avgCallDurationSecs -
+field callDurationSecs -
+field numCalls -
+field numMissedCalls -
+field numReceivedCalls
-
-
-
≠AdParamService (2 new, 3 changed, 0 removed)-
+type SelectorError -
+enum SelectorError.Reason -
≠type SelectorError-
+field reason
-
-
≠enum SelectorError.Reason-
+value MISSING_PREDICATES -
+value INVALID_SORT_FIELD_NAME -
+value SELECTOR_ERROR
-
-
≠operation get-
+parameter serviceSelector -
−parameter selector
-
-
-
=AlertService (no changes) -
≠BulkMutateJobService (6 new, 14 changed, 0 removed)-
+type AgeRange -
+enum AgeRange.AgeRangeType -
+type Carrier -
+type Gender -
+enum Gender.GenderType -
+type Language -
≠enum AdServingOptimizationStatus-
+value CONVERSION_OPTIMIZE
-
-
≠type AgeRange-
+field ageRangeType
-
-
≠enum AgeTarget.Age-
+value UNKNOWN
-
-
≠enum BiddingError.Reason-
−value BID_INCOMPATIBLE_WITH_ADGROUP -
−value BID_UNIVERSAL_CRITERIA_EXPECTED -
−value BIDS_DO_NOT_FULFILL_SPEC -
−value NETWORK_NOT_OVERRIDEABLE -
−value CURRENCY_MISMATCH -
−value ADGROUPS_DO_NOT_MATCH_CONSTRAINT -
−value NETWORK_SETTINGS_DO_NOT_SUPPORT_TRANSITION -
−value UNSUPPORTED_STYLE_TRANSITION -
−value UNSUPPORTED_PROXY_BIDDER_STRATEGY_TRANSITION -
−value TRANSITION_DOES_NOT_SUPPORT_OPTION -
−value TRANSITION_DOES_NOT_SUPPORT_GOAL -
−value PROXY_BIDDER_STRATEGY_INCOMPATIBLE_WITH_STYLE -
−value GOAL_DOES_NOT_FULFILL_SPEC -
−value GOAL_VALIDATION_FAILED -
−value UNSUPPORTED_STYLE -
−value BAD_BID_COMBINATION -
−value CANNOT_TARGET_UNIVERSE -
−value NO_DESTINATION_URL_SPECIFIED -
−value NO_EFFECTIVE_BID -
−value CRITERION_NOT_TARGETED -
−value CANNOT_EXCLUDE_DEFAULT -
−value CANNOT_TARGET_AND_EXCLUDE -
−value ILLEGAL_URL -
−value BID_TO_POSITION_NOT_ENABLED -
−value CAMPAIGN_ALREADY_SET -
−value PROXY_NOT_ENABLED -
−value CANNOT_UPDATE_SITE_BIDS_WHILE_PROXY_BIDDING -
−value AUCTION_STRATEGY_INCOMPATIBLE_WITH_PROXY_BIDDER
-
-
≠type Criterion-
+field type
-
-
≠enum Criterion.Type -
≠enum DeprecatedAd.Type-
+value AUDIO_TEMPLATE
-
-
≠type Gender-
+field genderType
-
-
≠enum GenderTarget.Gender-
+value UNKNOWN
-
-
≠type Job-
−field context
-
-
≠enum MediaError.Reason -
≠enum PlatformType-
+value TABLET
-
-
≠enum SelectorError.Reason-
+value MISSING_PREDICATES
-
-
≠type Stats-
+field avgCallDurationSecs -
+field callDurationSecs -
+field numCalls -
+field numMissedCalls -
+field numReceivedCalls
-
-
-
≠BulkOpportunityService (0 new, 4 changed, 0 removed)-
≠type Criterion-
+field type
-
-
≠enum Criterion.Type -
≠enum SiteConstants.AdFormat-
−value AUDIO
-
-
≠enum SiteConstants.PlacementType-
−value AUDIO
-
-
-
≠CampaignAdExtensionService (0 new, 2 changed, 0 removed)-
≠enum SelectorError.Reason-
+value MISSING_PREDICATES -
+value INVALID_SORT_FIELD_NAME -
+value SELECTOR_ERROR
-
-
≠type Stats-
+field avgCallDurationSecs -
+field callDurationSecs -
+field numCalls -
+field numMissedCalls -
+field numReceivedCalls
-
-
-
≠CampaignCriterionService (6 new, 5 changed, 0 removed)-
+type AgeRange -
+enum AgeRange.AgeRangeType -
+type Carrier -
+type Gender -
+enum Gender.GenderType -
+type Language -
≠type AgeRange-
+field ageRangeType
-
-
≠type Criterion-
+field type
-
-
≠enum Criterion.Type -
≠type Gender-
+field genderType
-
-
≠enum SelectorError.Reason-
+value MISSING_PREDICATES
-
-
-
≠CampaignService (0 new, 5 changed, 0 removed)-
≠enum BiddingError.Reason-
−value BID_INCOMPATIBLE_WITH_ADGROUP -
−value BID_UNIVERSAL_CRITERIA_EXPECTED -
−value BIDS_DO_NOT_FULFILL_SPEC -
−value NETWORK_NOT_OVERRIDEABLE -
−value CURRENCY_MISMATCH -
−value ADGROUPS_DO_NOT_MATCH_CONSTRAINT -
−value NETWORK_SETTINGS_DO_NOT_SUPPORT_TRANSITION -
−value UNSUPPORTED_STYLE_TRANSITION -
−value UNSUPPORTED_PROXY_BIDDER_STRATEGY_TRANSITION -
−value TRANSITION_DOES_NOT_SUPPORT_OPTION -
−value TRANSITION_DOES_NOT_SUPPORT_GOAL -
−value PROXY_BIDDER_STRATEGY_INCOMPATIBLE_WITH_STYLE -
−value GOAL_DOES_NOT_FULFILL_SPEC -
−value GOAL_VALIDATION_FAILED -
−value UNSUPPORTED_STYLE -
−value BAD_BID_COMBINATION -
−value CANNOT_TARGET_UNIVERSE -
−value NO_DESTINATION_URL_SPECIFIED -
−value NO_EFFECTIVE_BID -
−value CRITERION_NOT_TARGETED -
−value CANNOT_EXCLUDE_DEFAULT -
−value CANNOT_TARGET_AND_EXCLUDE -
−value ILLEGAL_URL -
−value BID_TO_POSITION_NOT_ENABLED -
−value POSITION_PREFERENCE_NOT_ENABLED -
−value POSITION_PREFERENCE_NOT_SUPPORTED_FOR_CRITERIA_TYPE -
−value PREFERRED_POSITION_OUT_OF_RANGE -
−value BOTTOM_POSITION_OUT_OF_RANGE -
−value PREFERRED_POSITION_CANNOT_BE_HIGHER_THAN_BOTTOM -
−value CAMPAIGN_ALREADY_SET -
−value PROXY_NOT_ENABLED -
−value CANNOT_UPDATE_SITE_BIDS_WHILE_PROXY_BIDDING -
−value AUCTION_STRATEGY_INCOMPATIBLE_WITH_PROXY_BIDDER
-
-
≠enum CampaignError.Reason -
≠type ManualCPC-
−field positionPreference
-
-
≠enum SelectorError.Reason-
+value MISSING_PREDICATES -
+value INVALID_SORT_FIELD_NAME -
+value SELECTOR_ERROR
-
-
≠type Stats-
+field avgCallDurationSecs -
+field callDurationSecs -
+field numCalls -
+field numMissedCalls -
+field numReceivedCalls
-
-
-
≠CampaignTargetService (0 new, 10 changed, 27 removed)-
≠type AgeTarget-
−field age
-
-
≠enum AgeTarget.Age-
+value UNKNOWN
-
-
≠enum BiddingError.Reason-
−value BID_INCOMPATIBLE_WITH_ADGROUP -
−value BID_UNIVERSAL_CRITERIA_EXPECTED -
−value BIDS_DO_NOT_FULFILL_SPEC -
−value NETWORK_NOT_OVERRIDEABLE -
−value CURRENCY_MISMATCH -
−value ADGROUPS_DO_NOT_MATCH_CONSTRAINT -
−value NETWORK_SETTINGS_DO_NOT_SUPPORT_TRANSITION -
−value UNSUPPORTED_STYLE_TRANSITION -
−value UNSUPPORTED_PROXY_BIDDER_STRATEGY_TRANSITION -
−value TRANSITION_DOES_NOT_SUPPORT_OPTION -
−value TRANSITION_DOES_NOT_SUPPORT_GOAL -
−value PROXY_BIDDER_STRATEGY_INCOMPATIBLE_WITH_STYLE -
−value GOAL_DOES_NOT_FULFILL_SPEC -
−value GOAL_VALIDATION_FAILED -
−value UNSUPPORTED_STYLE -
−value BAD_BID_COMBINATION -
−value CANNOT_TARGET_UNIVERSE -
−value NO_DESTINATION_URL_SPECIFIED -
−value NO_EFFECTIVE_BID -
−value CRITERION_NOT_TARGETED -
−value CANNOT_EXCLUDE_DEFAULT -
−value CANNOT_TARGET_AND_EXCLUDE -
−value ILLEGAL_URL -
−value BID_TO_POSITION_NOT_ENABLED -
−value POSITION_PREFERENCE_NOT_ENABLED -
−value POSITION_PREFERENCE_NOT_SUPPORTED_FOR_CRITERIA_TYPE -
−value PREFERRED_POSITION_OUT_OF_RANGE -
−value BOTTOM_POSITION_OUT_OF_RANGE -
−value PREFERRED_POSITION_CANNOT_BE_HIGHER_THAN_BOTTOM -
−value CAMPAIGN_ALREADY_SET -
−value PROXY_NOT_ENABLED -
−value CANNOT_UPDATE_SITE_BIDS_WHILE_PROXY_BIDDING -
−value AUCTION_STRATEGY_INCOMPATIBLE_WITH_PROXY_BIDDER
-
-
≠enum CampaignError.Reason -
≠type GenderTarget-
−field gender
-
-
≠enum GenderTarget.Gender-
+value UNKNOWN
-
-
≠type NetworkTarget-
−field networkCoverageType
-
-
≠type PlatformTarget-
−field platformType
-
-
≠enum PlatformType-
+value TABLET
-
-
≠type ProximityTarget-
−field address -
−field geoPoint -
−field radiusDistanceUnits
-
-
−type Address -
−type AgeTarget -
−enum AgeTarget.Age -
−type CityTarget -
−type CountryTarget -
−type DemographicTarget -
−type DemographicTargetList -
−type GenderTarget -
−enum GenderTarget.Gender -
−type GeoPoint -
−type GeoTarget -
−type GeoTargetList -
−type LanguageTarget -
−type LanguageTargetList -
−type MetroTarget -
−type MobileCarrierTarget -
−type MobilePlatformTarget -
−type MobileTarget -
−type MobileTargetList -
−enum NetworkCoverageType -
−type PlatformTarget -
−type PlatformTargetList -
−enum PlatformType -
−type PolygonTarget -
−type ProvinceTarget -
−type ProximityTarget -
−enum ProximityTarget.DistanceUnits
-
-
≠ConversionTrackerService (2 new, 2 changed, 0 removed)-
+type SelectorError -
+enum SelectorError.Reason -
≠type SelectorError-
+field reason
-
-
≠enum SelectorError.Reason-
+value MISSING_PREDICATES -
+value INVALID_SORT_FIELD_NAME -
+value SELECTOR_ERROR
-
-
-
=CustomerSyncService (no changes) -
≠DataService (0 new, 1 changed, 0 removed)-
≠enum SelectorError.Reason-
+value MISSING_PREDICATES -
+value INVALID_SORT_FIELD_NAME -
+value SELECTOR_ERROR
-
-
-
≠ExperimentService (0 new, 2 changed, 0 removed)-
≠enum ExperimentServiceError.Reason-
+value EXPERIMENT_LIMIT_EXCEEDED -
−value EXPERIMENT_LIMIT_EXCEEEDED
-
-
≠enum SelectorError.Reason-
+value MISSING_PREDICATES -
+value INVALID_SORT_FIELD_NAME -
+value SELECTOR_ERROR
-
-
-
=GeoLocationService (no changes) -
≠InfoService (0 new, 3 changed, 0 removed)-
≠enum ApiUsageError.Reason-
+value MAY_ONLY_SELECT_BY_EMAIL_OR_ID -
+value INVALID_CLIENT_CUSTOMER_ID
-
-
≠type ApiUsageRecord-
+field clientCustomerId
-
-
≠type InfoSelector-
+field clientCustomerIds -
+field includeSubAccounts
-
-
-
≠MediaService (0 new, 2 changed, 0 removed)-
≠enum MediaError.Reason -
≠enum SelectorError.Reason-
+value MISSING_PREDICATES -
+value INVALID_SORT_FIELD_NAME -
+value SELECTOR_ERROR
-
-
-
≠ReportDefinitionService (2 new, 8 changed, 1 removed)-
+type RejectedError -
+enum RejectedError.Reason -
≠type ClientSelector-
+field customerId -
−field login -
−field predicates
-
-
≠type RejectedError-
+field reason
-
-
≠type ReportDefinition-
+field includeZeroImpressions -
−field clientSelectors -
−field crossClient
-
-
≠enum ReportDefinition.ReportType-
+value CRITERIA_PERFORMANCE_REPORT
-
-
≠enum ReportDefinitionError.Reason-
+value CLIENT_SELECTOR_NO_CUSTOMER_IDENTIFIER -
+value CLIENT_SELECTOR_INVALID_CUSTOMER_ID -
+value REPORT_DEFINITION_ERROR
-
-
≠type ReportDefinitionField-
+field isEnumType
-
-
≠enum SelectorError.Reason-
+value MISSING_PREDICATES -
+value INVALID_SORT_FIELD_NAME -
+value SELECTOR_ERROR
-
-
≠operation mutate-
−parameter operations -
−response rval
-
-
−operation mutate
-
-
≠ServicedAccountService (0 new, 2 changed, 1 removed)-
≠type Link-
−field serviceType
-
-
≠enum ServicedAccountError.Reason-
+value REQUESTS_TOO_FREQUENT
-
-
−enum ServiceType
-
-
≠TargetingIdeaService (8 new, 8 changed, 7 removed)-
+type CategoryProductsAndServicesSearchParameter -
+type IdeaTextFilterSearchParameter -
+type Language -
+type LanguageSearchParameter -
+type Location -
+type LocationSearchParameter -
+type TrafficEstimatorError -
+enum TrafficEstimatorError.Reason -
≠enum BiddingError.Reason-
−value BID_INCOMPATIBLE_WITH_ADGROUP -
−value BID_UNIVERSAL_CRITERIA_EXPECTED -
−value BIDS_DO_NOT_FULFILL_SPEC -
−value NETWORK_NOT_OVERRIDEABLE -
−value CURRENCY_MISMATCH -
−value ADGROUPS_DO_NOT_MATCH_CONSTRAINT -
−value NETWORK_SETTINGS_DO_NOT_SUPPORT_TRANSITION -
−value UNSUPPORTED_STYLE_TRANSITION -
−value UNSUPPORTED_PROXY_BIDDER_STRATEGY_TRANSITION -
−value TRANSITION_DOES_NOT_SUPPORT_OPTION -
−value TRANSITION_DOES_NOT_SUPPORT_GOAL -
−value PROXY_BIDDER_STRATEGY_INCOMPATIBLE_WITH_STYLE -
−value GOAL_DOES_NOT_FULFILL_SPEC -
−value GOAL_VALIDATION_FAILED -
−value UNSUPPORTED_STYLE -
−value BAD_BID_COMBINATION -
−value CANNOT_TARGET_UNIVERSE -
−value NO_DESTINATION_URL_SPECIFIED -
−value NO_EFFECTIVE_BID -
−value CRITERION_NOT_TARGETED -
−value CANNOT_EXCLUDE_DEFAULT -
−value CANNOT_TARGET_AND_EXCLUDE -
−value ILLEGAL_URL -
−value BID_TO_POSITION_NOT_ENABLED -
−value POSITION_PREFERENCE_NOT_ENABLED -
−value POSITION_PREFERENCE_NOT_SUPPORTED_FOR_CRITERIA_TYPE -
−value PREFERRED_POSITION_OUT_OF_RANGE -
−value BOTTOM_POSITION_OUT_OF_RANGE -
−value PREFERRED_POSITION_CANNOT_BE_HIGHER_THAN_BOTTOM -
−value CAMPAIGN_ALREADY_SET -
−value PROXY_NOT_ENABLED -
−value CANNOT_UPDATE_SITE_BIDS_WHILE_PROXY_BIDDING -
−value AUCTION_STRATEGY_INCOMPATIBLE_WITH_PROXY_BIDDER
-
-
≠type Criterion-
+field type
-
-
≠enum Criterion.Type -
≠enum CriterionError.Reason-
+value CANNOT_ADD_CRITERIA_TYPE -
+value INVALID_CRITERION_ID -
+value CANNOT_TARGET_CRITERION -
+value CRITERION_ID_AND_TYPE_MISMATCH -
+value INVALID_PROXIMITY_RADIUS -
+value INVALID_PROXIMITY_RADIUS_UNITS -
+value INVALID_STREETADDRESS_LENGTH -
+value INVALID_CITYNAME_LENGTH -
+value INVALID_REGIONCODE_LENGTH -
+value INVALID_REGIONNAME_LENGTH -
+value INVALID_POSTALCODE_LENGTH -
+value INVALID_COUNTRY_CODE -
+value INVALID_LATITUDE -
+value INVALID_LONGITUDE
-
-
≠enum SiteConstants.AdFormat-
−value AUDIO
-
-
≠enum SiteConstants.AdType-
−value AUDIO
-
-
≠enum SiteConstants.PlacementType-
−value AUDIO
-
-
≠type TrafficEstimatorError-
+field reason
-
-
−type CountryTarget -
−type CountryTargetSearchParameter -
−type GeoTarget -
−type IdeaTextMatchesSearchParameter -
−type KeywordCategoryIdSearchParameter -
−type LanguageTarget -
−type LanguageTargetSearchParameter
-
-
≠TrafficEstimatorService (2 new, 11 changed, 19 removed)-
+type Language -
+type Location -
≠type AgeTarget-
−field age
-
-
≠enum AgeTarget.Age-
+value UNKNOWN
-
-
≠type CampaignEstimateRequest-
+field criteria -
+field dailyBudget -
+field networkSetting -
−field targets
-
-
≠type Criterion-
+field type
-
-
≠enum Criterion.Type -
≠type GenderTarget-
−field gender
-
-
≠enum GenderTarget.Gender-
+value UNKNOWN
-
-
≠type KeywordEstimateRequest-
+field isNegative
-
-
≠type NetworkTarget-
−field networkCoverageType
-
-
≠type PlatformTarget-
−field platformType
-
-
≠enum PlatformType-
+value TABLET
-
-
−type AgeTarget -
−enum AgeTarget.Age -
−type CityTarget -
−type CountryTarget -
−type DemographicTarget -
−type GenderTarget -
−enum GenderTarget.Gender -
−type GeoTarget -
−type LanguageTarget -
−type MetroTarget -
−type MobileCarrierTarget -
−type MobilePlatformTarget -
−type MobileTarget -
−enum NetworkCoverageType -
−type PlatformTarget -
−enum PlatformType -
−type PolygonTarget -
−type ProvinceTarget -
−type ProximityTarget
-
-
≠UserListService (0 new, 1 changed, 0 removed)-
≠enum SelectorError.Reason-
+value MISSING_PREDICATES -
+value INVALID_SORT_FIELD_NAME -
+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
BidLandscapeServicefunctionality has moved toDataServiceand is scheduled for sunsetting, along with v13ReportServiceandTrafficEstimatorService, v200909, v201003, and v201008. Check with the Adwords API Blog for the specific date.
API Changes
-
-BidLandscapeService -
+BulkOpportunityService -
+ConversionTrackerService -
+DataService -
≠AdExtensionOverrideService (0 new, 3 changed, 0 removed)-
≠enum DistinctError.Reason-
+value DUPLICATE_TYPE
-
-
≠type MobileExtension-
+field isCallOnly
-
-
≠type Stats-
+field invalidClickRate -
+field invalidClicks
-
-
-
≠AdGroupAdService (2 new, 12 changed, 1 removed)-
+type SelectorError -
+enum SelectorError.Reason -
≠enum AdError.Reason-
+value URL_INVALID_SCHEME
-
-
≠type AdGroupAd-
+field experimentData
-
-
≠type AdGroupAdSelector-
+field experimentId
-
-
≠enum DeprecatedAd.Type-
+value LOCAL_BUSINESS_AD -
+value UNKNOWN
-
-
≠enum DistinctError.Reason-
+value DUPLICATE_TYPE
-
-
≠enum MediaError.Reason -
≠enum OperationAccessDenied.Reason -
≠type Selector -
≠type SelectorError-
+field reason
-
-
≠type Stats-
+field invalidClickRate -
+field invalidClicks
-
-
≠enum TemplateElementField.Type-
+value NUMBER
-
-
≠operation get-
+parameter serviceSelector -
−parameter selector
-
-
−type LocalBusinessAd
-
-
≠AdGroupCriterionService (4 new, 9 changed, 0 removed)-
+type CriterionError -
+enum CriterionError.Reason -
+type SelectorError -
+enum SelectorError.Reason -
≠type AdGroupCriterion-
+field criterionUse
-
-
≠type CriterionError-
+field reason
-
-
≠type CriterionUserList-
−field userListSize
-
-
≠enum DistinctError.Reason-
+value DUPLICATE_TYPE
-
-
≠enum OperationAccessDenied.Reason -
≠type Selector -
≠type SelectorError-
+field reason
-
-
≠type Stats-
+field invalidClickRate -
+field invalidClicks
-
-
≠operation get-
+parameter serviceSelector -
−parameter selector
-
-
-
≠AdGroupService (2 new, 8 changed, 0 removed)-
+type SelectorError -
+enum SelectorError.Reason -
≠enum AdGroupServiceError.Reason-
−value ADGROUP_CAMPAIGN_MISMATCH -
−value BID_EXCEEDS_AUTO_BUDGET -
−value BID_EXCEEDS_CUSTOM_BUDGET -
−value BID_EXCEEDS_DAILY_BUDGET -
−value BID_EXCEEDS_MONTHLY_BUDGET -
−value BIDS_NOT_REQUIRED -
−value ILLEGAL_MANUAL_BID -
−value INCOMPATIBLE_WITH_KEYWORD_AND_SITE_VBB -
−value INCOMPATIBLE_WITH_KEYWORD_CPC -
−value INCOMPATIBLE_WITH_KEYWORD_CPC_AND_SITE_CPC -
−value INCOMPATIBLE_WITH_KEYWORD_CPM -
−value INCOMPATIBLE_WITH_KEYWORD_CPM_AND_SITE_CPM -
−value INCOMPATIBLE_WITH_SITE_CPC -
−value INCOMPATIBLE_WITH_SITE_CPM -
−value INCOMPATIBLE_WITH_VBB -
−value INCOMPATIBLE_WITH_SITE_VBB -
−value MISSING_BID -
−value MULTIPLE_BID_TYPES -
−value NO_CAMPAIGN_BUDGET -
−value NOT_WHITELISTED_FOR_SITE_CPC -
−value SEPARATE_CONTENT_BIDS_INAPPLICABLE -
−value SEPARATE_CONTENT_BIDS_NOT_ENABLED -
−value TOO_MANY_FRACTION_DIGITS
-
-
≠enum DistinctError.Reason-
+value DUPLICATE_TYPE
-
-
≠enum OperationAccessDenied.Reason -
≠enum QuotaError.Reason-
+value TOO_MANY_CRITERIA_PER_ACCOUNT -
+value UNKNOWN
-
-
≠type Selector -
≠type SelectorError-
+field reason
-
-
≠type Stats-
+field invalidClickRate -
+field invalidClicks
-
-
≠operation get-
+parameter serviceSelector -
−parameter selector
-
-
-
≠AdParamService (2 new, 3 changed, 0 removed)-
+type OperationAccessDenied -
+enum OperationAccessDenied.Reason -
≠enum DistinctError.Reason-
+value DUPLICATE_TYPE
-
-
≠type OperationAccessDenied-
+field reason
-
-
≠enum OperationAccessDenied.Reason
-
-
≠AlertService (0 new, 4 changed, 0 removed)-
≠type AlertQuery-
+field triggerTime
-
-
≠enum AlertType-
−value KEYWORD_BELOW_MIN_CPC
-
-
≠enum DistinctError.Reason-
+value DUPLICATE_TYPE
-
-
≠enum TriggerTimeSpec-
+value CUSTOM_TIME
-
-
-
≠BulkMutateJobService (8 new, 21 changed, 2 removed)-
+type CriterionError -
+enum CriterionError.Reason -
+type GeoTargetTypeSetting -
+type RealTimeBiddingSetting -
+type SelectorError -
+enum SelectorError.Reason -
+type SettingError -
+enum SettingError.Reason -
≠enum AdError.Reason-
+value URL_INVALID_SCHEME
-
-
≠enum AdExtensionError.Reason-
+value DISALLOWED_NUMBER_TYPE
-
-
≠type AdGroupAd-
+field experimentData
-
-
≠type AdGroupCriterion-
+field criterionUse
-
-
≠enum AdGroupServiceError.Reason-
−value ADGROUP_CAMPAIGN_MISMATCH -
−value BID_EXCEEDS_AUTO_BUDGET -
−value BID_EXCEEDS_CUSTOM_BUDGET -
−value BID_EXCEEDS_DAILY_BUDGET -
−value BID_EXCEEDS_MONTHLY_BUDGET -
−value BIDS_NOT_REQUIRED -
−value ILLEGAL_MANUAL_BID -
−value INCOMPATIBLE_WITH_KEYWORD_AND_SITE_VBB -
−value INCOMPATIBLE_WITH_KEYWORD_CPC -
−value INCOMPATIBLE_WITH_KEYWORD_CPC_AND_SITE_CPC -
−value INCOMPATIBLE_WITH_KEYWORD_CPM -
−value INCOMPATIBLE_WITH_KEYWORD_CPM_AND_SITE_CPM -
−value INCOMPATIBLE_WITH_SITE_CPC -
−value INCOMPATIBLE_WITH_SITE_CPM -
−value INCOMPATIBLE_WITH_VBB -
−value INCOMPATIBLE_WITH_SITE_VBB -
−value MISSING_BID -
−value MULTIPLE_BID_TYPES -
−value NO_CAMPAIGN_BUDGET -
−value NOT_WHITELISTED_FOR_SITE_CPC -
−value SEPARATE_CONTENT_BIDS_INAPPLICABLE -
−value SEPARATE_CONTENT_BIDS_NOT_ENABLED -
−value TOO_MANY_FRACTION_DIGITS
-
-
≠enum BiddingTransitionError.Reason -
≠type Campaign-
+field networkSetting -
+field settings
-
-
≠enum CampaignCriterionLimitExceeded.CriteriaLimitType-
+value CAMPAIGN_CRITERIA
-
-
≠type CriterionError-
+field reason
-
-
≠type CriterionUserList-
−field userListSize
-
-
≠enum DeprecatedAd.Type-
+value LOCAL_BUSINESS_AD -
+value UNKNOWN
-
-
≠enum DistinctError.Reason-
+value DUPLICATE_TYPE
-
-
≠type JobSelector-
−field customerJobKeys -
−field includeJobsSubmittedByOtherUsers
-
-
≠enum MediaError.Reason -
≠type MobileExtension-
+field isCallOnly
-
-
≠enum OperationAccessDenied.Reason -
≠enum QuotaError.Reason-
+value TOO_MANY_CRITERIA_PER_ACCOUNT -
+value UNKNOWN
-
-
≠type SelectorError-
+field reason
-
-
≠type SettingError-
+field reason
-
-
≠type Stats-
+field invalidClickRate -
+field invalidClicks
-
-
≠enum TemplateElementField.Type-
+value NUMBER
-
-
−type LocalBusinessAd -
−type NetworkTarget
-
-
≠CampaignAdExtensionService (2 new, 8 changed, 0 removed)-
+type SelectorError -
+enum SelectorError.Reason -
≠enum AdExtensionError.Reason-
+value DISALLOWED_NUMBER_TYPE
-
-
≠enum DistinctError.Reason-
+value DUPLICATE_TYPE
-
-
≠type MobileExtension-
+field isCallOnly
-
-
≠enum OperationAccessDenied.Reason -
≠type Selector -
≠type SelectorError-
+field reason
-
-
≠type Stats-
+field invalidClickRate -
+field invalidClicks
-
-
≠operation get-
+parameter serviceSelector -
−parameter selector
-
-
-
≠CampaignCriterionService (4 new, 8 changed, 0 removed)-
+type CriterionError -
+enum CriterionError.Reason -
+type SelectorError -
+enum SelectorError.Reason -
≠enum CampaignCriterionLimitExceeded.CriteriaLimitType-
+value CAMPAIGN_CRITERIA
-
-
≠type CriterionError-
+field reason
-
-
≠type CriterionUserList-
−field userListSize
-
-
≠enum DistinctError.Reason-
+value DUPLICATE_TYPE
-
-
≠enum OperationAccessDenied.Reason -
≠type Selector -
≠type SelectorError-
+field reason
-
-
≠operation get-
+parameter serviceSelector -
−parameter selector
-
-
-
≠CampaignService (6 new, 10 changed, 0 removed)-
+type GeoTargetTypeSetting -
+type RealTimeBiddingSetting -
+type SelectorError -
+enum SelectorError.Reason -
+type SettingError -
+enum SettingError.Reason -
≠enum BiddingTransitionError.Reason -
≠type Campaign-
+field networkSetting -
+field settings
-
-
≠enum DistinctError.Reason-
+value DUPLICATE_TYPE
-
-
≠enum OperationAccessDenied.Reason -
≠enum QuotaError.Reason-
+value TOO_MANY_CRITERIA_PER_ACCOUNT -
+value UNKNOWN
-
-
≠type Selector -
≠type SelectorError-
+field reason
-
-
≠type SettingError-
+field reason
-
-
≠type Stats-
+field invalidClickRate -
+field invalidClicks
-
-
≠operation get-
+parameter serviceSelector -
−parameter selector
-
-
-
≠CampaignTargetService (0 new, 3 changed, 1 removed)-
≠enum DistinctError.Reason-
+value DUPLICATE_TYPE
-
-
≠enum OperationAccessDenied.Reason -
≠enum QuotaError.Reason-
+value TOO_MANY_CRITERIA_PER_ACCOUNT -
+value UNKNOWN
-
-
−type NetworkTarget
-
-
≠CustomerSyncService (0 new, 1 changed, 0 removed)-
≠enum DistinctError.Reason-
+value DUPLICATE_TYPE
-
-
-
≠ExperimentService (2 new, 8 changed, 0 removed)-
+type SelectorError -
+enum SelectorError.Reason -
≠enum DistinctError.Reason-
+value DUPLICATE_TYPE
-
-
≠enum ExperimentServiceError.Reason -
≠type ExperimentSummaryStats-
+field adGroupAdsCount
-
-
≠enum OperationAccessDenied.Reason -
≠enum QuotaError.Reason-
+value TOO_MANY_CRITERIA_PER_ACCOUNT -
+value UNKNOWN
-
-
≠type Selector -
≠type SelectorError-
+field reason
-
-
≠operation get-
+parameter serviceSelector -
−parameter selector
-
-
-
=GeoLocationService (no changes) -
=InfoService (no changes) -
≠MediaService (2 new, 5 changed, 0 removed)-
+type SelectorError -
+enum SelectorError.Reason -
≠enum MediaError.Reason -
≠enum OperationAccessDenied.Reason -
≠type Selector -
≠type SelectorError-
+field reason
-
-
≠operation get-
+parameter serviceSelector -
−parameter selector
-
-
-
≠ReportDefinitionService (6 new, 10 changed, 0 removed)-
+type ClientSelector -
+type DatabaseError -
+enum DatabaseError.Reason -
+type EnumValuePair -
+type SelectorError -
+enum SelectorError.Reason -
≠type DatabaseError-
+field reason
-
-
≠enum DistinctError.Reason-
+value DUPLICATE_TYPE
-
-
≠type ReportDefinition-
+field clientSelectors -
+field crossClient
-
-
≠enum ReportDefinition.DateRangeType-
+value THIS_WEEK_SUN_TODAY -
+value THIS_WEEK_MON_TODAY -
+value LAST_WEEK_SUN_SAT
-
-
≠enum ReportDefinition.ReportType-
+value DEMOGRAPHIC_PERFORMANCE_REPORT -
+value GEO_PERFORMANCE_REPORT -
+value AD_EXTENSIONS_PERFORMANCE_REPORT -
+value DESTINATION_URL_REPORT -
+value CREATIVE_CONVERSION_REPORT -
+value UNKNOWN
-
-
≠enum ReportDefinitionError.Reason-
+value SORTING_NOT_SUPPORTED -
+value PAGING_NOT_SUPPORTED -
+value CUSTOMER_SERVING_TYPE_REPORT_MISMATCH
-
-
≠type ReportDefinitionField-
+field enumValuePairs
-
-
≠type ReportDefinitionSelector-
+field definitionIds
-
-
≠type Selector -
≠type SelectorError-
+field reason
-
-
-
≠ServicedAccountService (0 new, 1 changed, 0 removed)-
≠type Account-
+field currencyCode -
+field dateTimeZone
-
-
-
≠TargetingIdeaService (12 new, 6 changed, 1 removed)-
+type AdGroupBidLandscape -
+enum AdGroupBidLandscape.Type -
+type BidLandscape -
+type BidLandscape.LandscapePoint -
+type BidLandscapeAttribute -
+type CriterionAttribute -
+type CriterionBidLandscape -
+type CurrencyCodeError -
+type DataEntry -
+type DeviceTypeSearchParameter -
+enum OpportunityIdeaType -
+type OpportunityIdeaTypeAttribute -
≠type AdGroupBidLandscape-
+field type
-
-
≠enum AttributeType-
+value CRITERION -
−value KEYWORD -
−value PLACEMENT
-
-
≠type CriterionUserList-
−field userListSize
-
-
≠enum DistinctError.Reason-
+value DUPLICATE_TYPE
-
-
≠type OpportunityIdeaTypeAttribute-
+field value
-
-
≠enum TrafficEstimatorError.Reason-
+value TOO_MANY_CAMPAIGN_ESTIMATE_REQUESTS -
+value TOO_MANY_ADGROUP_ESTIMATE_REQUESTS -
+value TOO_MANY_TARGETS
-
-
−type MobileSearchParameter
-
-
≠TrafficEstimatorService (2 new, 5 changed, 1 removed)-
+type CurrencyCodeError -
+enum CurrencyCodeError.Reason -
≠type CurrencyCodeError-
+field reason
-
-
≠enum DistinctError.Reason-
+value DUPLICATE_TYPE
-
-
≠enum OperationAccessDenied.Reason -
≠type StatsEstimate-
+field clicksPerDay -
−field clicks
-
-
≠enum TrafficEstimatorError.Reason-
+value TOO_MANY_CAMPAIGN_ESTIMATE_REQUESTS -
+value TOO_MANY_ADGROUP_ESTIMATE_REQUESTS -
+value TOO_MANY_TARGETS
-
-
−type NetworkTarget
-
-
≠UserListService (16 new, 15 changed, 0 removed)-
+type ClientTermsError -
+enum ClientTermsError.Reason -
+type DistinctError -
+enum DistinctError.Reason -
+type NotWhitelistedError -
+enum NotWhitelistedError.Reason -
+type QuotaCheckError -
+enum QuotaCheckError.Reason -
+type RateExceededError -
+enum RateExceededError.Reason -
+type RequestError -
+enum RequestError.Reason -
+type SelectorError -
+enum SelectorError.Reason -
+type SizeLimitError -
+enum SizeLimitError.Reason -
≠type ClientTermsError-
+field reason
-
-
≠type DistinctError-
+field reason
-
-
≠enum DistinctError.Reason-
+value DUPLICATE_TYPE
-
-
≠type NotWhitelistedError-
+field reason
-
-
≠enum OperationAccessDenied.Reason -
≠type QuotaCheckError-
+field reason
-
-
≠type RateExceededError-
+field reason
-
-
≠type RequestError-
+field reason
-
-
≠type Selector -
≠type SelectorError-
+field reason
-
-
≠type SizeLimitError-
+field reason
-
-
≠type UserList-
+field accessReason -
+field accountUserListStatus
-
-
≠enum UserListError.Reason-
+value USER_LIST_MUTATE_NOT_SUPPORTED
-
-
≠type UserListSelector-
+field accessReasons
-
-
≠operation get-
+parameter serviceSelector -
−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
getReportFieldsoperation 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
TrafficEstimatorServiceprovides traffic estimates for keywords and supplants the legacy v13 service. - My Client Center (MCC) features
- Use
ServicedAccountServiceto retrieve the hierarchy of accounts managed by your MCC account. UseAlertServiceto 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
ExperimentServiceto 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
UserListServiceand 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
BidLandscapeServiceto return bid simulation data for entire ad groups. For each ad group, two simulations are returned: AUNIFORMsimulation where a the simulated default bid overrides child criteria bids, and aDEFAULTsimulation 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
CustomerSyncServiceto find out which campaign data was changed over a specified date range. - Partial failure support (beta, AdGroupCriterionService only)
- Use the
partialFailureSOAP request header to commit as many error-free operations as possible. Partial failure support is currently only available for AdGroupCriterionService.
API Changes
-
+AlertService -
+CustomerSyncService -
+ExperimentService -
+ServicedAccountService -
+TrafficEstimatorService -
+UserListService -
≠AdExtensionOverrideService (3 new, 2 changed, 0 removed)-
+type ProductCondition -
+type ProductConditionOperand -
+type ProductExtension -
≠type ProductCondition-
+field operand
-
-
≠type Stats-
+field totalConvValue -
+field valuePerConv -
+field valuePerConvManyPerClick -
+field viewThroughConversions
-
-
-
≠AdGroupAdService (1 new, 9 changed, 0 removed)-
+type ProductAd -
≠enum AdError.Reason-
+value BAD_SNIPPET -
+value CANNOT_SET_URL
-
-
≠enum EntityCountLimitExceeded.Reason-
+value ADGROUP_TEXT_AD_LIMIT -
+value ADGROUP_DISPLAY_AD_LIMIT -
+value UNKNOWN
-
-
≠type ImageAd-
+field adToCopyImageFrom
-
-
≠type Media-
+field type -
−field extendedCapabilities -
−field mediaSubType -
−field mediaTypeDb
-
-
≠enum Media.MediaSubType-
+value EXTERNALLY_HOSTED
-
-
≠enum Media.MediaType-
−value HTML -
−value VIDEO_IMAGE
-
-
≠enum MediaError.Reason-
+value INVALID_YOU_TUBE_ID -
+value YOU_TUBE_VIDEO_NOT_FOUND -
+value YOU_TUBE_SERVICE_UNAVAILABLE
-
-
≠type Stats-
+field totalConvValue -
+field valuePerConv -
+field valuePerConvManyPerClick -
+field viewThroughConversions
-
-
≠type Video-
+field youTubeVideoIdString
-
-
-
≠AdGroupCriterionService (6 new, 7 changed, 0 removed)-
+type CriterionUserInterest -
+type CriterionUserList -
+type PercentCPAAdGroupCriterionBids -
+type Product -
+type ProductCondition -
+type ProductConditionOperand -
≠enum AdGroupCriterionError.Reason-
+value CANNOT_EXCLUDE_CRITERIA_TYPE -
+value PRODUCT_FILTER_TOO_LONG -
+value INVALID_PRODUCT_FILTER
-
-
≠type AdGroupCriterionReturnValue-
+field partialFailureErrors
-
-
≠type AdGroupCriterionSelector-
+field experimentId
-
-
≠type BiddableAdGroupCriterion-
+field experimentData
-
-
≠enum EntityCountLimitExceeded.Reason-
+value ADGROUP_TEXT_AD_LIMIT -
+value ADGROUP_DISPLAY_AD_LIMIT -
+value UNKNOWN
-
-
≠type ProductCondition-
+field operand
-
-
≠type Stats-
+field totalConvValue -
+field valuePerConv -
+field valuePerConvManyPerClick -
+field viewThroughConversions
-
-
-
≠AdGroupService (1 new, 4 changed, 0 removed)-
+type PercentCPAAdGroupBids -
≠type AdGroup-
+field experimentData
-
-
≠type AdGroupSelector-
+field adGroupStatuses -
+field experimentId
-
-
≠type AdGroupServiceError-
+field adGroupId
-
-
≠type Stats-
+field totalConvValue -
+field valuePerConv -
+field valuePerConvManyPerClick -
+field viewThroughConversions
-
-
-
≠AdParamService (2 new, 1 changed, 0 removed)-
+type DistinctError -
+enum DistinctError.Reason -
≠type DistinctError-
+field reason
-
-
-
≠BidLandscapeService (4 new, 1 changed, 0 removed)-
+type AdGroupBidLandscape -
+type AdGroupBidLandscapeSelector -
+type EntityNotFound -
+enum EntityNotFound.Reason -
≠type EntityNotFound-
+field reason
-
-
-
≠BulkMutateJobService (23 new, 32 changed, 1 removed)-
+type AdExtensionError -
+enum AdExtensionError.Reason -
+type AdExtensionOverrideError -
+enum AdExtensionOverrideError.Reason -
+type AdExtensionOverrideOperation -
+type CampaignAdExtension -
+enum CampaignAdExtension.ApprovalStatus -
+enum CampaignAdExtension.Status -
+type CampaignAdExtensionError -
+enum CampaignAdExtensionError.Reason -
+type CampaignAdExtensionOperation -
+type CampaignAdExtensionStats -
+type ConversionOptimizerEligibility -
+type CriterionUserInterest -
+type CriterionUserList -
+type PercentCPA -
+type PercentCPAAdGroupBids -
+type PercentCPAAdGroupCriterionBids -
+type Product -
+type ProductAd -
+type ProductCondition -
+type ProductConditionOperand -
+type ProductExtension -
≠enum AdError.Reason-
+value BAD_SNIPPET -
+value CANNOT_SET_URL
-
-
≠type AdExtensionError-
+field reason
-
-
≠enum AdExtensionError.Reason-
+value AD_EXTENSION_NO_LONGER_ACTIVE -
+value CANNOT_HAVE_MULTIPLE_PRODUCT_EXTENSIONS_PER_CAMPAIGN -
+value INVALID_ENUM_CONDITION_OPERATOR -
+value INVALID_STRING_CONDITION_OPERATOR -
+value MISSING_CONDITION_OPERAND -
+value MISSING_CONDITION_STRING_VALUE -
+value NUM_AND_GROUPS_OVER_LIMIT -
+value NUM_CONDITIONS_OVER_LIMIT -
+value NOT_AUTHORIZED_TO_CREATE_EXTENSION
-
-
≠type AdExtensionOverrideError-
+field reason
-
-
≠type AdGroup-
+field experimentData
-
-
≠enum AdGroupCriterionError.Reason-
+value CANNOT_EXCLUDE_CRITERIA_TYPE -
+value PRODUCT_FILTER_TOO_LONG -
+value INVALID_PRODUCT_FILTER
-
-
≠type AdGroupServiceError-
+field adGroupId
-
-
≠type BiddableAdGroupCriterion-
+field experimentData
-
-
≠enum BiddingTransitionError.Reason-
+value IS_PERCENT_CPA_CAMPAIGN -
+value HAS_ACTIVE_EXPERIMENT
-
-
≠type BudgetOptimizer-
+field enhancedCpcEnabled
-
-
≠type Campaign-
+field conversionOptimizerEligibility -
−field autoKeywordMatchingStatus
-
-
≠type CampaignAdExtension-
+field approvalStatus -
+field stats -
+field status
-
-
≠type CampaignAdExtensionError-
+field reason
-
-
≠enum CampaignAdExtensionError.Reason-
+value MUST_USE_CONCRETE_ADEXTENSION -
+value UNKNOWN_ERROR
-
-
≠type CampaignAdExtensionOperation-
+field operand
-
-
≠enum CampaignError.Reason-
+value CANNOT_SET_BUDGET
-
-
≠enum EntityCountLimitExceeded.Reason-
+value ADGROUP_TEXT_AD_LIMIT -
+value ADGROUP_DISPLAY_AD_LIMIT -
+value UNKNOWN
-
-
≠type ImageAd-
+field adToCopyImageFrom
-
-
≠enum JobError.Reason-
+value TOO_LATE_TO_CANCEL_JOB -
+value USER_CANCELED_JOB -
+value UNKNOWN
-
-
≠type JobSelector-
+field includeJobsSubmittedByOtherUsers
-
-
≠enum LoasAuthenticationError.Reason-
−value UNKNOWN
-
-
≠type ManualCPC-
+field enhancedCpcEnabled
-
-
≠type Media-
+field type -
−field extendedCapabilities -
−field mediaSubType -
−field mediaTypeDb
-
-
≠enum Media.MediaSubType-
+value EXTERNALLY_HOSTED
-
-
≠enum Media.MediaType-
−value HTML -
−value VIDEO_IMAGE
-
-
≠enum MediaError.Reason-
+value INVALID_YOU_TUBE_ID -
+value YOU_TUBE_VIDEO_NOT_FOUND -
+value YOU_TUBE_SERVICE_UNAVAILABLE
-
-
≠enum NetworkCoverageType-
+value UNKNOWN
-
-
≠enum PlatformType-
+value UNKNOWN
-
-
≠type ProductCondition-
+field operand
-
-
≠type Stats-
+field totalConvValue -
+field valuePerConv -
+field valuePerConvManyPerClick -
+field viewThroughConversions
-
-
≠enum TargetError.Reason -
≠type Video-
+field youTubeVideoIdString
-
-
−enum LoasAuthenticationError.Reason
-
-
≠CampaignAdExtensionService (7 new, 7 changed, 0 removed)-
+type NewEntityCreationError -
+enum NewEntityCreationError.Reason -
+type ProductCondition -
+type ProductConditionOperand -
+type ProductExtension -
+type RejectedError -
+enum RejectedError.Reason -
≠enum AdExtensionError.Reason-
+value AD_EXTENSION_NO_LONGER_ACTIVE -
+value CANNOT_HAVE_MULTIPLE_PRODUCT_EXTENSIONS_PER_CAMPAIGN -
+value INVALID_ENUM_CONDITION_OPERATOR -
+value INVALID_STRING_CONDITION_OPERATOR -
+value MISSING_CONDITION_OPERAND -
+value MISSING_CONDITION_STRING_VALUE -
+value NUM_AND_GROUPS_OVER_LIMIT -
+value NUM_CONDITIONS_OVER_LIMIT -
+value NOT_AUTHORIZED_TO_CREATE_EXTENSION
-
-
≠type CampaignAdExtension-
+field stats
-
-
≠enum CampaignAdExtensionError.Reason-
+value MUST_USE_CONCRETE_ADEXTENSION -
+value UNKNOWN_ERROR
-
-
≠type NewEntityCreationError-
+field reason
-
-
≠type ProductCondition-
+field operand
-
-
≠type RejectedError-
+field reason
-
-
≠type Stats-
+field totalConvValue -
+field valuePerConv -
+field valuePerConvManyPerClick -
+field viewThroughConversions
-
-
-
≠CampaignCriterionService (5 new, 2 changed, 0 removed)-
+type CriterionUserInterest -
+type CriterionUserList -
+type Product -
+type ProductCondition -
+type ProductConditionOperand -
≠enum EntityCountLimitExceeded.Reason-
+value ADGROUP_TEXT_AD_LIMIT -
+value ADGROUP_DISPLAY_AD_LIMIT -
+value UNKNOWN
-
-
≠type ProductCondition-
+field operand
-
-
-
≠CampaignService (3 new, 6 changed, 0 removed)-
+type ConversionOptimizerEligibility -
+type PercentCPA -
+type PercentCPAAdGroupBids -
≠enum BiddingTransitionError.Reason-
+value IS_PERCENT_CPA_CAMPAIGN -
+value HAS_ACTIVE_EXPERIMENT
-
-
≠type BudgetOptimizer-
+field enhancedCpcEnabled
-
-
≠type Campaign-
+field conversionOptimizerEligibility -
−field autoKeywordMatchingStatus
-
-
≠enum CampaignError.Reason-
+value CANNOT_SET_BUDGET
-
-
≠type ManualCPC-
+field enhancedCpcEnabled
-
-
≠type Stats-
+field totalConvValue -
+field valuePerConv -
+field valuePerConvManyPerClick -
+field viewThroughConversions
-
-
-
≠CampaignTargetService (0 new, 4 changed, 0 removed)-
≠enum CampaignError.Reason-
+value CANNOT_SET_BUDGET
-
-
≠enum NetworkCoverageType-
+value UNKNOWN
-
-
≠enum PlatformType-
+value UNKNOWN
-
-
≠enum TargetError.Reason
-
-
=GeoLocationService (no changes) -
=InfoService (no changes) -
≠MediaService (0 new, 7 changed, 0 removed)-
≠type Media-
+field type -
−field extendedCapabilities -
−field mediaSubType -
−field mediaTypeDb
-
-
≠enum Media.MediaSubType-
+value EXTERNALLY_HOSTED
-
-
≠enum Media.MediaType-
−value HTML -
−value VIDEO_IMAGE
-
-
≠enum MediaError.Reason-
+value INVALID_YOU_TUBE_ID -
+value YOU_TUBE_VIDEO_NOT_FOUND -
+value YOU_TUBE_SERVICE_UNAVAILABLE
-
-
≠type MediaPage-
+field entries -
−field media
-
-
≠type MediaSelector-
+field mediaDimensions -
+field youTubeVideoIds -
−field extendedCapabilityTypes -
−field mediaSubType
-
-
≠type Video-
+field youTubeVideoIdString
-
-
-
≠ReportDefinitionService (4 new, 5 changed, 0 removed)-
+type DateError -
+enum DateError.Reason -
+type NotEmptyError -
+enum NotEmptyError.Reason -
≠type DateError-
+field reason
-
-
≠type NotEmptyError-
+field reason
-
-
≠enum ReportDefinition.DateRangeType-
+value LAST_14_DAYS -
+value LAST_30_DAYS
-
-
≠enum ReportDefinition.ReportType-
+value ACCOUNT_PERFORMANCE_REPORT -
−value ADGROUP_NEGATIVE_KEYWORDS_PERFORMANCE_REPORT -
−value ADGROUP_NEGATIVE_PLACEMENTS_PERFORMANCE_REPORT
-
-
≠type ReportDefinitionField-
+field displayFieldName -
+field xmlAttributeName
-
-
-
≠TargetingIdeaService (2 new, 6 changed, 0 removed)-
+type MatchesRegexError -
+enum MatchesRegexError.Reason -
≠enum AdGroupCriterionError.Reason-
+value CANNOT_EXCLUDE_CRITERIA_TYPE -
+value PRODUCT_FILTER_TOO_LONG -
+value INVALID_PRODUCT_FILTER
-
-
≠type DoubleComparisonOperation-
−field excludes
-
-
≠enum EntityCountLimitExceeded.Reason-
+value ADGROUP_TEXT_AD_LIMIT -
+value ADGROUP_DISPLAY_AD_LIMIT -
+value UNKNOWN
-
-
≠type LongComparisonOperation-
−field excludes
-
-
≠type MatchesRegexError-
+field reason
-
-
≠enum TargetError.Reason
-
v201003
What's New
- Reporting functionality (beta)
- Use
ReportDefinitionServiceto create customized reports about your campaign performance. - Bid simulator
- Use
BidLandscapeServiceto get estimates of how your ads might perform with different maximum bids. - Media uploading for location extensions
- Use
MediaServiceto upload images and icons for location extensions. - Sitelinks extensions
- Use a
SitelinksExtensionto include up to four additional links in your ads to deeper content on your site. - Location sync extensions
- Use a
LocationSyncExtensionto synchronize your location extensions with Google Places (formerly Local Business Center) listings. - Phone extensions
- Use a
MobileExtensionto add a phone number to your text ads when they appear on high-end mobile devices. - Content network targeting by category
- Use the new
Verticalcriterion to target placements on the content network based on their category. - Mobile carrier and device targeting
- Use
MobileCarrierTargetandMobilePlatformTargetto 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
conversionOptimizerBidTypefield toTARGET_CPAto 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
BulkMutateJobServicemust contain at least 100 operations.
API Changes
-
+BidLandscapeService -
+MediaService -
+ReportDefinitionService -
≠AdExtensionOverrideService (8 new, 8 changed, 1 removed)-
+type DatabaseError -
+enum DatabaseError.Reason -
+type LocationSyncExtension -
+type MobileExtension -
+type RateExceededError -
+enum RateExceededError.Reason -
+type RequestError -
+type SitelinksExtension -
≠type ApiError-
+field errorString
-
-
≠type DatabaseError-
+field reason
-
-
≠enum DatabaseError.Reason-
+value DUPLICATE_KEY -
+value DATABASE_ERROR -
+value UNKNOWN
-
-
≠enum InternalApiError.Reason-
+value UNKNOWN
-
-
≠enum QuotaCheckError.Reason-
+value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED -
−value INCOMPLETE_SIGNUP_APP_INFO_MISSING -
−value INCOMPLETE_SIGNUP_APP_INFO_PENDING -
−value INCOMPLETE_SIGNUP_APP_INFO_REJECTED -
−value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
-
-
≠type RateExceededError-
+field reason
-
-
≠enum SizeLimitError.Reason-
+value UNKNOWN
-
-
≠enum Stats.Network-
+value UNKNOWN
-
-
−type QuotaExceededError
-
-
≠AdGroupAdService (5 new, 13 changed, 1 removed)-
+type RateExceededError -
+enum RateExceededError.Reason -
+type RequestError -
+type RichMediaAd -
+type ThirdPartyRedirectAd -
≠type Ad-
+field trademarkDisapproved
-
-
≠enum AdError.Reason-
+value DISPLAY_URL_CANNOT_BE_SPECIFIED -
+value INVALID_RICH_MEDIA_CERTIFIED_VENDOR_FORMAT_ID -
+value URL_HOST_NAME_TOO_LONG
-
-
≠type AdGroupAdSelector-
+field statuses
-
-
≠type ApiError-
+field errorString
-
-
≠enum DatabaseError.Reason-
+value DUPLICATE_KEY -
+value DATABASE_ERROR -
+value UNKNOWN
-
-
≠enum InternalApiError.Reason-
+value UNKNOWN
-
-
≠enum OperationAccessDenied.Reason-
+value UNKNOWN
-
-
≠enum PagingError.Reason-
+value UNKNOWN
-
-
≠enum QuotaCheckError.Reason-
+value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED -
−value INCOMPLETE_SIGNUP_APP_INFO_MISSING -
−value INCOMPLETE_SIGNUP_APP_INFO_PENDING -
−value INCOMPLETE_SIGNUP_APP_INFO_REJECTED -
−value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
-
-
≠type RateExceededError-
+field reason
-
-
≠type RichMediaAd-
+field adDuration -
+field expandable -
−field adDuration -
−field expandable
-
-
≠enum SizeLimitError.Reason-
+value UNKNOWN
-
-
≠enum Stats.Network-
+value UNKNOWN
-
-
−type QuotaExceededError
-
-
≠AdGroupCriterionService (6 new, 14 changed, 1 removed)-
+type RateExceededError -
+enum RateExceededError.Reason -
+type RejectedError -
+enum RejectedError.Reason -
+type RequestError -
+type Vertical -
≠enum AdGroupCriterionError.Reason-
+value INAPPLICABLE_FOR_NEGATIVE -
+value INVALID_VERTICAL_PATH -
+value CANNOT_ADD_CRITERIA_TYPE -
+value UNKNOWN
-
-
≠type ApiError-
+field errorString
-
-
≠enum BiddingError.Reason-
+value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_TARGET_CPA -
+value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_MANY_PER_CLICK -
+value TARGET_CPA_NOT_AVAILABLE_FOR_CUSTOMER -
+value MANY_PER_CLICK_NOT_AVAILABLE_FOR_CUSTOMER -
+value CANNOT_SET_SITE_MAX_CPC -
+value BID_ERROR
-
-
≠type BudgetOptimizerAdGroupCriterionBids-
+field enhancedCpcEnabled
-
-
≠enum DatabaseError.Reason-
+value DUPLICATE_KEY -
+value DATABASE_ERROR -
+value UNKNOWN
-
-
≠enum InternalApiError.Reason-
+value UNKNOWN
-
-
≠type ManualCPCAdGroupCriterionBids-
+field enhancedCpcEnabled
-
-
≠enum OperationAccessDenied.Reason-
+value UNKNOWN
-
-
≠enum PagingError.Reason-
+value UNKNOWN
-
-
≠enum QuotaCheckError.Reason-
+value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED -
−value INCOMPLETE_SIGNUP_APP_INFO_MISSING -
−value INCOMPLETE_SIGNUP_APP_INFO_PENDING -
−value INCOMPLETE_SIGNUP_APP_INFO_REJECTED -
−value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
-
-
≠type RateExceededError-
+field reason
-
-
≠type RejectedError-
+field reason
-
-
≠enum SizeLimitError.Reason-
+value UNKNOWN
-
-
≠enum Stats.Network-
+value UNKNOWN
-
-
−type QuotaExceededError
-
-
≠AdGroupService (5 new, 14 changed, 1 removed)-
+type RateExceededError -
+enum RateExceededError.Reason -
+type RejectedError -
+enum RejectedError.Reason -
+type RequestError -
≠type AdGroupSelector-
+field campaignIds -
−field campaignId
-
-
≠type ApiError-
+field errorString
-
-
≠enum BiddingError.Reason-
+value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_TARGET_CPA -
+value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_MANY_PER_CLICK -
+value TARGET_CPA_NOT_AVAILABLE_FOR_CUSTOMER -
+value MANY_PER_CLICK_NOT_AVAILABLE_FOR_CUSTOMER -
+value CANNOT_SET_SITE_MAX_CPC -
+value BID_ERROR
-
-
≠type BudgetOptimizerAdGroupBids-
+field enhancedCpcEnabled
-
-
≠type ConversionOptimizerAdGroupBids-
+field conversionOptimizerBidType -
+field deduplicationMode
-
-
≠enum DatabaseError.Reason-
+value DUPLICATE_KEY -
+value DATABASE_ERROR -
+value UNKNOWN
-
-
≠enum InternalApiError.Reason-
+value UNKNOWN
-
-
≠type ManualCPCAdGroupBids-
+field enhancedCpcEnabled
-
-
≠enum OperationAccessDenied.Reason-
+value UNKNOWN
-
-
≠enum QuotaCheckError.Reason-
+value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED -
−value INCOMPLETE_SIGNUP_APP_INFO_MISSING -
−value INCOMPLETE_SIGNUP_APP_INFO_PENDING -
−value INCOMPLETE_SIGNUP_APP_INFO_REJECTED -
−value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
-
-
≠type RateExceededError-
+field reason
-
-
≠type RejectedError-
+field reason
-
-
≠enum SizeLimitError.Reason-
+value UNKNOWN
-
-
≠enum Stats.Network-
+value UNKNOWN
-
-
−type QuotaExceededError
-
-
≠AdParamService (3 new, 7 changed, 1 removed)-
+type RateExceededError -
+enum RateExceededError.Reason -
+type RequestError -
≠enum AdParamError.Reason-
+value UNKNOWN
-
-
≠type ApiError-
+field errorString
-
-
≠enum DatabaseError.Reason-
+value DUPLICATE_KEY -
+value DATABASE_ERROR -
+value UNKNOWN
-
-
≠enum InternalApiError.Reason-
+value UNKNOWN
-
-
≠enum QuotaCheckError.Reason-
+value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED -
−value INCOMPLETE_SIGNUP_APP_INFO_MISSING -
−value INCOMPLETE_SIGNUP_APP_INFO_PENDING -
−value INCOMPLETE_SIGNUP_APP_INFO_REJECTED -
−value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
-
-
≠type RateExceededError-
+field reason
-
-
≠enum SizeLimitError.Reason-
+value UNKNOWN
-
-
−type QuotaExceededError
-
-
≠BulkMutateJobService (16 new, 32 changed, 1 removed)-
+type CampaignStats -
+type LocationSyncExtension -
+type MobileCarrierTarget -
+type MobileExtension -
+type MobilePlatformTarget -
+type MobileTarget -
+type MobileTargetList -
+type RateExceededError -
+enum RateExceededError.Reason -
+type RejectedError -
+enum RejectedError.Reason -
+type RequestError -
+type RichMediaAd -
+type SitelinksExtension -
+type ThirdPartyRedirectAd -
+type Vertical -
≠type Ad-
+field trademarkDisapproved
-
-
≠enum AdError.Reason-
+value DISPLAY_URL_CANNOT_BE_SPECIFIED -
+value INVALID_RICH_MEDIA_CERTIFIED_VENDOR_FORMAT_ID -
+value URL_HOST_NAME_TOO_LONG
-
-
≠enum AdExtensionError.Reason-
+value CANNOT_HAVE_MULTIPLE_MOBILE_EXTENSIONS_PER_CAMPAIGN -
+value INVALID_ICON_DIMENSIONS -
+value INVALID_IMAGE_DIMENSIONS -
+value INVALID_INPUT
-
-
≠enum AdGroupCriterionError.Reason-
+value INAPPLICABLE_FOR_NEGATIVE -
+value INVALID_VERTICAL_PATH -
+value CANNOT_ADD_CRITERIA_TYPE -
+value UNKNOWN
-
-
≠type ApiError-
+field errorString
-
-
≠enum BiddingError.Reason-
+value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_TARGET_CPA -
+value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_MANY_PER_CLICK -
+value TARGET_CPA_NOT_AVAILABLE_FOR_CUSTOMER -
+value MANY_PER_CLICK_NOT_AVAILABLE_FOR_CUSTOMER -
+value CANNOT_SET_SITE_MAX_CPC -
+value BID_ERROR
-
-
≠enum BudgetError.Reason-
+value BUDGET_ERROR -
+value BUDGET_PERIOD_NOT_AVAILABLE
-
-
≠type BudgetOptimizerAdGroupBids-
+field enhancedCpcEnabled
-
-
≠type BudgetOptimizerAdGroupCriterionBids-
+field enhancedCpcEnabled
-
-
≠enum BulkMutateJobError.Reason-
+value TOO_FEW_OPERATIONS_IN_JOB -
+value UNKNOWN
-
-
≠type Campaign-
+field campaignStats -
−field stats
-
-
≠enum CampaignCriterionError.Reason-
+value INVALID_VERTICAL_PATH -
+value CANNOT_EXCLUDE_CRITERIA_TYPE -
+value UNKNOWN
-
-
≠enum CampaignError.Reason-
+value FREQUENCY_CAP_TIME_UNIT_CANNOT_BE_NULL -
+value FREQUENCY_CAP_LEVEL_CANNOT_BE_NULL -
+value UNKNOWN
-
-
≠enum ContentLabelType-
+value BRAND_BASIC -
+value BRAND_STANDARD -
+value BELOW_THE_FOLD -
−value BRAND_BASIC -
−value BRAND_STANDARD -
−value CONFLICT_TRAGEDY -
−value EDGY -
−value UGC -
−value SENSITIVE
-
-
≠type ConversionOptimizer-
+field conversionOptimizerBidType -
+field deduplicationMode
-
-
≠type ConversionOptimizerAdGroupBids-
+field conversionOptimizerBidType -
+field deduplicationMode
-
-
≠enum DatabaseError.Reason-
+value DUPLICATE_KEY -
+value DATABASE_ERROR -
+value UNKNOWN
-
-
≠enum InternalApiError.Reason-
+value UNKNOWN
-
-
≠enum Level -
≠enum LoasAuthenticationError.Reason-
+value UNKNOWN
-
-
≠type ManualCPC-
+field positionPreference
-
-
≠type ManualCPCAdGroupBids-
+field enhancedCpcEnabled
-
-
≠type ManualCPCAdGroupCriterionBids-
+field enhancedCpcEnabled
-
-
≠enum OperationAccessDenied.Reason-
+value UNKNOWN
-
-
≠enum PagingError.Reason-
+value UNKNOWN
-
-
≠enum QuotaCheckError.Reason-
+value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED -
−value INCOMPLETE_SIGNUP_APP_INFO_MISSING -
−value INCOMPLETE_SIGNUP_APP_INFO_PENDING -
−value INCOMPLETE_SIGNUP_APP_INFO_REJECTED -
−value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
-
-
≠type RateExceededError-
+field reason
-
-
≠type RejectedError-
+field reason
-
-
≠type RichMediaAd-
+field adDuration -
+field expandable -
−field adDuration -
−field expandable
-
-
≠enum SizeLimitError.Reason-
+value UNKNOWN
-
-
≠enum Stats.Network-
+value UNKNOWN
-
-
≠enum TargetError.Reason-
+value CANNOT_TARGET_MOBILE_CARRIER -
+value CANNOT_TARGET_THE_SAME_TARGET_LIST_TYPE_MULTIPLE_TIMES -
+value INVALID_MOBILE_CARRIER -
+value INVALID_MOBILE_PLATFORM -
+value POLYGON_TOO_MANY_VERTICES -
+value TARGET_ERROR
-
-
−type QuotaExceededError
-
-
≠CampaignAdExtensionService (6 new, 11 changed, 1 removed)-
+type LocationSyncExtension -
+type MobileExtension -
+type RateExceededError -
+enum RateExceededError.Reason -
+type RequestError -
+type SitelinksExtension -
≠enum AdExtensionError.Reason-
+value CANNOT_HAVE_MULTIPLE_MOBILE_EXTENSIONS_PER_CAMPAIGN -
+value INVALID_ICON_DIMENSIONS -
+value INVALID_IMAGE_DIMENSIONS -
+value INVALID_INPUT
-
-
≠type ApiError-
+field errorString
-
-
≠type CampaignAdExtensionSelector-
+field adExtensionIds
-
-
≠enum DatabaseError.Reason-
+value DUPLICATE_KEY -
+value DATABASE_ERROR -
+value UNKNOWN
-
-
≠enum InternalApiError.Reason-
+value UNKNOWN
-
-
≠enum OperationAccessDenied.Reason-
+value UNKNOWN
-
-
≠enum PagingError.Reason-
+value UNKNOWN
-
-
≠enum QuotaCheckError.Reason-
+value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED -
−value INCOMPLETE_SIGNUP_APP_INFO_MISSING -
−value INCOMPLETE_SIGNUP_APP_INFO_PENDING -
−value INCOMPLETE_SIGNUP_APP_INFO_REJECTED -
−value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
-
-
≠type RateExceededError-
+field reason
-
-
≠enum SizeLimitError.Reason-
+value UNKNOWN
-
-
≠enum Stats.Network-
+value UNKNOWN
-
-
−type QuotaExceededError
-
-
≠CampaignCriterionService (4 new, 10 changed, 1 removed)-
+type RateExceededError -
+enum RateExceededError.Reason -
+type RequestError -
+type Vertical -
≠type ApiError-
+field errorString
-
-
≠enum CampaignCriterionError.Reason-
+value INVALID_VERTICAL_PATH -
+value CANNOT_EXCLUDE_CRITERIA_TYPE -
+value UNKNOWN
-
-
≠enum ContentLabelType-
+value BRAND_BASIC -
+value BRAND_STANDARD -
+value BELOW_THE_FOLD -
−value BRAND_BASIC -
−value BRAND_STANDARD -
−value CONFLICT_TRAGEDY -
−value EDGY -
−value UGC -
−value SENSITIVE
-
-
≠enum DatabaseError.Reason-
+value DUPLICATE_KEY -
+value DATABASE_ERROR -
+value UNKNOWN
-
-
≠enum InternalApiError.Reason-
+value UNKNOWN
-
-
≠enum OperationAccessDenied.Reason-
+value UNKNOWN
-
-
≠enum PagingError.Reason-
+value UNKNOWN
-
-
≠enum QuotaCheckError.Reason-
+value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED -
−value INCOMPLETE_SIGNUP_APP_INFO_MISSING -
−value INCOMPLETE_SIGNUP_APP_INFO_PENDING -
−value INCOMPLETE_SIGNUP_APP_INFO_REJECTED -
−value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
-
-
≠type RateExceededError-
+field reason
-
-
≠enum SizeLimitError.Reason-
+value UNKNOWN
-
-
−type QuotaExceededError
-
-
≠CampaignService (6 new, 19 changed, 1 removed)-
+type CampaignStats -
+type RateExceededError -
+enum RateExceededError.Reason -
+type RejectedError -
+enum RejectedError.Reason -
+type RequestError -
≠type ApiError-
+field errorString
-
-
≠enum BiddingError.Reason-
+value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_TARGET_CPA -
+value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_MANY_PER_CLICK -
+value TARGET_CPA_NOT_AVAILABLE_FOR_CUSTOMER -
+value MANY_PER_CLICK_NOT_AVAILABLE_FOR_CUSTOMER -
+value CANNOT_SET_SITE_MAX_CPC -
+value BID_ERROR
-
-
≠enum BudgetError.Reason-
+value BUDGET_ERROR -
+value BUDGET_PERIOD_NOT_AVAILABLE
-
-
≠type BudgetOptimizerAdGroupBids-
+field enhancedCpcEnabled
-
-
≠type Campaign-
+field campaignStats -
−field stats
-
-
≠enum CampaignError.Reason-
+value FREQUENCY_CAP_TIME_UNIT_CANNOT_BE_NULL -
+value FREQUENCY_CAP_LEVEL_CANNOT_BE_NULL -
+value UNKNOWN
-
-
≠type ConversionOptimizer-
+field conversionOptimizerBidType -
+field deduplicationMode
-
-
≠type ConversionOptimizerAdGroupBids-
+field conversionOptimizerBidType -
+field deduplicationMode
-
-
≠enum DatabaseError.Reason-
+value DUPLICATE_KEY -
+value DATABASE_ERROR -
+value UNKNOWN
-
-
≠enum InternalApiError.Reason-
+value UNKNOWN
-
-
≠enum Level -
≠type ManualCPC-
+field positionPreference
-
-
≠type ManualCPCAdGroupBids-
+field enhancedCpcEnabled
-
-
≠enum OperationAccessDenied.Reason-
+value UNKNOWN
-
-
≠enum QuotaCheckError.Reason-
+value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED -
−value INCOMPLETE_SIGNUP_APP_INFO_MISSING -
−value INCOMPLETE_SIGNUP_APP_INFO_PENDING -
−value INCOMPLETE_SIGNUP_APP_INFO_REJECTED -
−value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
-
-
≠type RateExceededError-
+field reason
-
-
≠type RejectedError-
+field reason
-
-
≠enum SizeLimitError.Reason-
+value UNKNOWN
-
-
≠enum Stats.Network-
+value UNKNOWN
-
-
−type QuotaExceededError
-
-
≠CampaignTargetService (9 new, 11 changed, 1 removed)-
+type MobileCarrierTarget -
+type MobilePlatformTarget -
+type MobileTarget -
+type MobileTargetList -
+type RateExceededError -
+enum RateExceededError.Reason -
+type RejectedError -
+enum RejectedError.Reason -
+type RequestError -
≠type ApiError-
+field errorString
-
-
≠enum BiddingError.Reason-
+value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_TARGET_CPA -
+value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_MANY_PER_CLICK -
+value TARGET_CPA_NOT_AVAILABLE_FOR_CUSTOMER -
+value MANY_PER_CLICK_NOT_AVAILABLE_FOR_CUSTOMER -
+value CANNOT_SET_SITE_MAX_CPC -
+value BID_ERROR
-
-
≠enum CampaignError.Reason-
+value FREQUENCY_CAP_TIME_UNIT_CANNOT_BE_NULL -
+value FREQUENCY_CAP_LEVEL_CANNOT_BE_NULL -
+value UNKNOWN
-
-
≠enum DatabaseError.Reason-
+value DUPLICATE_KEY -
+value DATABASE_ERROR -
+value UNKNOWN
-
-
≠enum InternalApiError.Reason-
+value UNKNOWN
-
-
≠enum OperationAccessDenied.Reason-
+value UNKNOWN
-
-
≠enum QuotaCheckError.Reason-
+value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED -
−value INCOMPLETE_SIGNUP_APP_INFO_MISSING -
−value INCOMPLETE_SIGNUP_APP_INFO_PENDING -
−value INCOMPLETE_SIGNUP_APP_INFO_REJECTED -
−value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
-
-
≠type RateExceededError-
+field reason
-
-
≠type RejectedError-
+field reason
-
-
≠enum SizeLimitError.Reason-
+value UNKNOWN
-
-
≠enum TargetError.Reason-
+value CANNOT_TARGET_MOBILE_CARRIER -
+value CANNOT_TARGET_THE_SAME_TARGET_LIST_TYPE_MULTIPLE_TIMES -
+value INVALID_MOBILE_CARRIER -
+value INVALID_MOBILE_PLATFORM -
+value POLYGON_TOO_MANY_VERTICES -
+value TARGET_ERROR
-
-
−type QuotaExceededError
-
-
≠GeoLocationService (3 new, 5 changed, 1 removed)-
+type RateExceededError -
+enum RateExceededError.Reason -
+type RequestError -
≠type ApiError-
+field errorString
-
-
≠enum InternalApiError.Reason-
+value UNKNOWN
-
-
≠enum QuotaCheckError.Reason-
+value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED -
−value INCOMPLETE_SIGNUP_APP_INFO_MISSING -
−value INCOMPLETE_SIGNUP_APP_INFO_PENDING -
−value INCOMPLETE_SIGNUP_APP_INFO_REJECTED -
−value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
-
-
≠type RateExceededError-
+field reason
-
-
≠enum SizeLimitError.Reason-
+value UNKNOWN
-
-
−type QuotaExceededError
-
-
≠InfoService (3 new, 6 changed, 1 removed)-
+type RateExceededError -
+enum RateExceededError.Reason -
+type RequestError -
≠type ApiError-
+field errorString
-
-
≠enum ApiUsageError.Reason-
+value INVALID_TOKEN_HEADER
-
-
≠enum InternalApiError.Reason-
+value UNKNOWN
-
-
≠enum QuotaCheckError.Reason-
+value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED -
−value INCOMPLETE_SIGNUP_APP_INFO_MISSING -
−value INCOMPLETE_SIGNUP_APP_INFO_PENDING -
−value INCOMPLETE_SIGNUP_APP_INFO_REJECTED -
−value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
-
-
≠type RateExceededError-
+field reason
-
-
≠enum SizeLimitError.Reason-
+value UNKNOWN
-
-
−type QuotaExceededError
-
-
≠TargetingIdeaService (6 new, 14 changed, 2 removed)-
+type AdShareSearchParameter -
+type IdeaTextMatchesSearchParameter -
+type RateExceededError -
+enum RateExceededError.Reason -
+type RequestError -
+type SearchShareSearchParameter -
≠enum AdGroupCriterionError.Reason-
+value INAPPLICABLE_FOR_NEGATIVE -
+value INVALID_VERTICAL_PATH -
+value CANNOT_ADD_CRITERIA_TYPE -
+value UNKNOWN
-
-
≠type ApiError-
+field errorString
-
-
≠enum AttributeType-
+value UNKNOWN -
−value PUBLISHER_DESCRIPTION
-
-
≠enum BiddingError.Reason-
+value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_TARGET_CPA -
+value PAY_PER_CONVERSION_NOT_ALLOWED_WITH_MANY_PER_CLICK -
+value TARGET_CPA_NOT_AVAILABLE_FOR_CUSTOMER -
+value MANY_PER_CLICK_NOT_AVAILABLE_FOR_CUSTOMER -
+value CANNOT_SET_SITE_MAX_CPC -
+value BID_ERROR
-
-
≠enum BudgetError.Reason-
+value BUDGET_ERROR -
+value BUDGET_PERIOD_NOT_AVAILABLE
-
-
≠enum DatabaseError.Reason-
+value DUPLICATE_KEY -
+value DATABASE_ERROR -
+value UNKNOWN
-
-
≠enum InternalApiError.Reason-
+value UNKNOWN
-
-
≠enum QuotaCheckError.Reason-
+value INCOMPLETE_SIGNUP_LATEST_ADWORDS_API_TNC_NOT_AGREED -
−value INCOMPLETE_SIGNUP_APP_INFO_MISSING -
−value INCOMPLETE_SIGNUP_APP_INFO_PENDING -
−value INCOMPLETE_SIGNUP_APP_INFO_REJECTED -
−value INCOMPLETE_SIGNUP_LATEST_NETAPI_TNC_NOT_AGREED
-
-
≠type RateExceededError-
+field reason
-
-
≠enum SiteConstants.AdFormat -
≠enum SiteConstants.AdType -
≠enum SiteConstants.PlacementType -
≠enum SizeLimitError.Reason-
+value UNKNOWN
-
-
≠enum TargetError.Reason-
+value CANNOT_TARGET_MOBILE_CARRIER -
+value CANNOT_TARGET_THE_SAME_TARGET_LIST_TYPE_MULTIPLE_TIMES -
+value INVALID_MOBILE_CARRIER -
+value INVALID_MOBILE_PLATFORM -
+value POLYGON_TOO_MANY_VERTICES -
+value TARGET_ERROR
-
-
−type NgramGroupsSearchParameter -
−type QuotaExceededError
-
v200909
What's New
- Asynchronous bulk job support: Use
BulkMutateJobServiceto build, schedule, and retrieve jobs that can operate on thousands of campaign objects. - Location extension support: Use
CampaignAdExtensionServiceto augment your text ads with information about your business's physical location. You can also override location extensions on a per-ad basis usingAdExtensionOverrideServiceFor more information about how ad extensions work, read the AdWords Help Center overview. - Keyword and placement ideas: Use
TargetingIdeaServiceto generate new keyword and placement ideas for your campaign ads. - API usage retrieval: Use
InfoServiceto 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
AdParamServiceto perform on-the-fly updates to parameterized snippets of ad text.
API Changes
-
+AdExtensionOverrideService -
+AdParamService -
+BulkMutateJobService -
+CampaignAdExtensionService -
+GeoLocationService -
≠AdGroupAdService (3 new, 2 changed, 0 removed)-
+type Audio -
+type DeprecatedAd -
+type TemplateAd -
≠enum AdError.Reason-
+value CUSTOMER_NOT_ELIGIBLE_FOR_UPDATING_BEACON_URL -
+value DIMENSION_ALREADY_IN_UNION -
+value DIMENSION_MUST_BE_SET -
+value DIMENSION_NOT_IN_UNION -
+value DOMESTIC_PHONE_NUMBER_FORMAT -
+value EMERGENCY_PHONE_NUMBER -
+value INCONSISTENT_STATUS_IN_TEMPLATE_UNION -
+value INVALID_AD_TYPE -
+value INVALID_ATTRIBUTES_FOR_MOBILE_IMAGE -
+value INVALID_ATTRIBUTES_FOR_MOBILE_TEXT -
+value INVALID_INPUT -
+value INVALID_MARKUP_LANGUAGE -
+value INVALID_MOBILE_CARRIER -
+value INVALID_NUMBER_OF_ELEMENTS -
+value INVALID_PHONE_NUMBER_FORMAT -
+value INVALID_TEMPLATE_DATA -
+value INVALID_TEMPLATE_ELEMENT_FIELD_TYPE -
+value INVALID_TEMPLATE_ID -
+value MARKUP_LANGUAGES_PRESENT -
+value MISSING_ADDRESS_COMPONENT -
+value MISSING_ADVERTISEMENT_NAME -
+value MISSING_BUSINESS_NAME -
+value MISSING_MARKUP_LANGUAGES -
+value MISSING_MOBILE_CARRIER -
+value MISSING_PHONE -
+value MISSING_REQUIRED_TEMPLATE_FIELDS -
+value MISSING_TEMPLATE_FIELD_VALUE -
+value MISSING_URL_AND_PHONE -
+value MUST_USE_TEMP_AD_UNION_ID_ON_ADD -
+value UNION_DIMENSIONS_CANNOT_CHANGE -
+value UNKNOWN_ADDRESS_COMPONENT -
+value UNKNOWN_FIELD_NAME -
+value UNKNOWN_UNIQUE_NAME -
+value USER_DOES_NOT_HAVE_ACCESS_TO_TEMPLATE
-
-
≠enum AdGroupAdError.Reason-
+value CANNOT_CREATE_DEPRECATED_ADS
-
-
-
=AdGroupCriterionService (no changes) -
=AdGroupService (no changes) -
=CampaignCriterionService (no changes) -
≠CampaignService (0 new, 2 changed, 0 removed)-
≠enum BudgetError.Reason-
+value INVALID_BUDGET_SCHEDULE
-
-
≠enum CampaignError.Reason
-
-
≠CampaignTargetService (0 new, 1 changed, 0 removed)-
≠enum CampaignError.Reason
-
-
=InfoService (no changes) -
≠TargetingIdeaService (0 new, 1 changed, 0 removed)-
≠enum BudgetError.Reason-
+value INVALID_BUDGET_SCHEDULE
-
-
v200906
Initial release of Adwords API v2009