Release Notes for Previous Versions

Return to the release notes for the latest API version (v201705).

v201702

Text ads and responsive display ads

  • Any attempt to create a new standard text ad will fail with the more specific AdGroupAdError reason of CANNOT_CREATE_TEXT_ADS.
  • Calls to AdGroupAdService get() and query() methods will no longer return the following fields unless specifically requested in the selector:

Bidding improvements and changes

Extensions

Error handling

  • ApiError objects have a new fieldPathElements collection that contains each element of the path in fieldPath. Instead of parsing the fieldPath string, use fieldPathElements in your error handling to get the field name and index that caused an error.
  • When a request fails due to the access level of the request's developer token, the rateScope and rateName of RateExceededError and its accompanying message will now provide more intuitive values. Check out Rate Limits for more details.
  • Requests that attempt to change a non-shared budget to a shared budget will now fail with a BudgetError with the more specific reason of CANNOT_UPDATE_BUDGET_TO_EXPLICITLY_SHARED.
  • Additional details for policy issues can now be retrieved from the new policySummary field of AdGroupAd.

Remarketing

Shopping

Targeting

Template ads

Account management

Reporting

Current model conversion columns

To help you view and compare conversion stats for historical data after you've changed attribution models, the following fields were added to multiple reports:

  • CostPerCurrentModelAttributedConversion
  • CurrentModelAttributedConversions
  • CurrentModelAttributedConversionValue
  • ValuePerCurrentModelAttributedConversion

Field behavior changes

  • Fields of type Double that do not represent percentages are now always returned without a thousands separator and with two decimal places. See the migration guide for the complete list of impacted fields.
  • The AdGroupName and AdGroupStatus fields of the AUDIENCE_PERFORMANCE_REPORT now behave as segments instead of attributes for consistency with the AdGroupId field.
  • All fields of the CALL_METRICS_CALL_DETAILS_REPORT now behave as attributes, since each row in the report represents a single call.
  • The LanguageCriteriaId field of the SHOPPING_PERFORMANCE_REPORT now returns the language ID instead of the language name.
  • The ViewThroughConversions and ClickType fields are no longer compatible.

New report fields

  • The AdGroupType field was added to the ADGROUP_PERFORMANCE_REPORT to allow you to differentiate between different types of shopping ad groups.
  • The CombinedApprovalStatus and ImageCreativeMimeType fields were added to the AD_PERFORMANCE_REPORT to provide additional approval information and the mime type of image ads, respectively.

Renamed report fields

The AccountTimeZoneId field was renamed to AccountTimeZone since this field returns the display name of the time zone, not a numeric ID.

Removed report fields

New enum values

  • The AdType enum has a new value of SHOWCASE_AD for Showcase Shopping ads.
  • The ExternalConversionSource enum has a new value of THIRD_PARTY_APP_ANALYTICS for linked third-party app analytics events.

Migration guide

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

API changes

  1. AccountLabelService (0 new, 2 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  2. AdCustomizerFeedService (0 new, 3 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum FeedError.Reason
      1. + value INVALID_AFFILIATE_CHAIN_ID
      2. + value CANNOT_CHANGE_SYSTEM_FEED_GENERATION_DATA_TYPE
      3. + value UNSUPPORTED_AFFILIATE_LOCATION_RELATIONSHIP_TYPE
    3. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  3. AdGroupAdService (3 new, 9 changed, 0 removed)
    1. + type AdGroupAdPolicySummary
    2. + type AdSharingError
    3. + type ShowcaseAd
    4. type Ad
      1. + field urlData
    5. enum Ad.Type
      1. + value SHOWCASE_AD
    6. enum AdCustomizerError.Reason
      1. + value UNKNOWN_USER_LIST
    7. enum AdError.Reason
      1. + value CANNOT_SET_WITH_URL_DATA
      2. + value ILLEGAL_TAG_USE
    8. type AdGroupAd
      1. + field policySummary
    9. enum AdGroupAdError.Reason
      1. + value CANNOT_CREATE_TEXT_ADS
    10. type ApiError
      1. + field fieldPathElements
    11. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
    12. enum UrlError.Reason
      1. + value DUPLICATE_URL_ID
      2. + value INVALID_URL_ID
  4. AdGroupBidModifierService (0 new, 3 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum CriterionError.Reason
      1. + value CANNOT_ADD_CLOSED_USER_LIST
    3. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  5. AdGroupCriterionService (0 new, 6 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum BiddingErrors.Reason
      1. + value ENHANCED_CPC_ENABLED_NOT_SUPPORTED_ON_PORTFOLIO_TARGET_SPEND_STRATEGY
    3. enum CriterionError.Reason
      1. + value CANNOT_ADD_CLOSED_USER_LIST
    4. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
    5. type TargetSpendBiddingScheme
      1. + field enhancedCpcEnabled
    6. enum UrlError.Reason
      1. + value DUPLICATE_URL_ID
      2. + value INVALID_URL_ID
  6. AdGroupExtensionSettingService (3 new, 9 changed, 0 removed)
    1. + type MessageFeedItem
    2. + type NewEntityCreationError
    3. + enum NewEntityCreationError.Reason
    4. type AdGroupExtensionSettingReturnValue
      1. + field partialFailureErrors
    5. type ApiError
      1. + field fieldPathElements
    6. enum CriterionError.Reason
      1. + value CANNOT_ADD_CLOSED_USER_LIST
    7. enum ExtensionSettingError.Reason
      1. + value UNSUPPORTED_VALUE_IN_SELECTED_LANGUAGE
    8. enum Feed.Type
      1. + value MESSAGE
    9. type NewEntityCreationError
      1. + field reason
    10. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
    11. type PriceTableRow
      1. + field finalMobileUrls
    12. enum UrlError.Reason
      1. + value DUPLICATE_URL_ID
      2. + value INVALID_URL_ID
  7. AdGroupFeedService (0 new, 2 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  8. AdGroupService (0 new, 7 changed, 0 removed)
    1. type AdGroup
      1. + field adGroupType
    2. enum AdGroupServiceError.Reason
      1. + value AD_GROUP_TYPE_NOT_VALID_FOR_ADVERTISING_CHANNEL_TYPE
      2. + value ADGROUP_TYPE_NOT_SUPPORTED_FOR_CAMPAIGN_SALES_COUNTRY
    3. type ApiError
      1. + field fieldPathElements
    4. enum BiddingErrors.Reason
      1. + value ENHANCED_CPC_ENABLED_NOT_SUPPORTED_ON_PORTFOLIO_TARGET_SPEND_STRATEGY
    5. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
    6. type TargetSpendBiddingScheme
      1. + field enhancedCpcEnabled
    7. enum UrlError.Reason
      1. + value DUPLICATE_URL_ID
      2. + value INVALID_URL_ID
  9. AdParamService (0 new, 2 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  10. AdwordsUserListService (0 new, 7 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. type CrmBasedUserList
      1. + field dataUploadResult
    3. type DateRuleItem
      1. + field relativeValue
    4. enum MutateMembersOperand.DataType
      1. + value MOBILE_ID
    5. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
    6. type RuleBasedUserList
      1. + field prepopulationStatus
    7. type UserList
      1. + field closingReason
  11. BatchJobService (0 new, 2 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  12. BiddingStrategyService (0 new, 5 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum BiddingErrors.Reason
      1. + value ENHANCED_CPC_ENABLED_NOT_SUPPORTED_ON_PORTFOLIO_TARGET_SPEND_STRATEGY
    3. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
    4. type SharedBiddingStrategy
      1. field systemStatus
    5. type TargetSpendBiddingScheme
      1. + field enhancedCpcEnabled
  13. BudgetOrderService (0 new, 2 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  14. BudgetService (0 new, 3 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum BudgetError.Reason
      1. + value CANNOT_UPDATE_BUDGET_TO_EXPLICITLY_SHARED
    3. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  15. CampaignCriterionService (0 new, 3 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum CriterionError.Reason
      1. + value CANNOT_ADD_CLOSED_USER_LIST
    3. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  16. CampaignExtensionSettingService (3 new, 9 changed, 0 removed)
    1. + type MessageFeedItem
    2. + type NewEntityCreationError
    3. + enum NewEntityCreationError.Reason
    4. type ApiError
      1. + field fieldPathElements
    5. type CampaignExtensionSettingReturnValue
      1. + field partialFailureErrors
    6. enum CriterionError.Reason
      1. + value CANNOT_ADD_CLOSED_USER_LIST
    7. enum ExtensionSettingError.Reason
      1. + value UNSUPPORTED_VALUE_IN_SELECTED_LANGUAGE
    8. enum Feed.Type
      1. + value MESSAGE
    9. type NewEntityCreationError
      1. + field reason
    10. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
    11. type PriceTableRow
      1. + field finalMobileUrls
    12. enum UrlError.Reason
      1. + value DUPLICATE_URL_ID
      2. + value INVALID_URL_ID
  17. CampaignFeedService (0 new, 2 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  18. CampaignService (0 new, 6 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum BiddingErrors.Reason
      1. + value ENHANCED_CPC_ENABLED_NOT_SUPPORTED_ON_PORTFOLIO_TARGET_SPEND_STRATEGY
    3. enum BudgetError.Reason
      1. + value CANNOT_UPDATE_BUDGET_TO_EXPLICITLY_SHARED
    4. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
    5. type TargetSpendBiddingScheme
      1. + field enhancedCpcEnabled
    6. enum UrlError.Reason
      1. + value DUPLICATE_URL_ID
      2. + value INVALID_URL_ID
  19. CampaignSharedSetService (0 new, 3 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum CampaignSharedSetError.Reason
      1. value SHARED_SET_NOT_ACTIVE
    3. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  20. ConstantDataService (0 new, 2 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  21. ConversionTrackerService (0 new, 2 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  22. CustomerExtensionSettingService (3 new, 9 changed, 0 removed)
    1. + type MessageFeedItem
    2. + type NewEntityCreationError
    3. + enum NewEntityCreationError.Reason
    4. type ApiError
      1. + field fieldPathElements
    5. enum CriterionError.Reason
      1. + value CANNOT_ADD_CLOSED_USER_LIST
    6. type CustomerExtensionSettingReturnValue
      1. + field partialFailureErrors
    7. enum ExtensionSettingError.Reason
      1. + value UNSUPPORTED_VALUE_IN_SELECTED_LANGUAGE
    8. enum Feed.Type
      1. + value MESSAGE
    9. type NewEntityCreationError
      1. + field reason
    10. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
    11. type PriceTableRow
      1. + field finalMobileUrls
    12. enum UrlError.Reason
      1. + value DUPLICATE_URL_ID
      2. + value INVALID_URL_ID
  23. CustomerFeedService (0 new, 2 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  24. CustomerService (0 new, 4 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. type Customer
      1. field companyName
    3. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
    4. enum UrlError.Reason
      1. + value DUPLICATE_URL_ID
      2. + value INVALID_URL_ID
  25. CustomerSyncService (0 new, 2 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  26. DataService (0 new, 2 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  27. DraftAsyncErrorService (1 new, 10 changed, 0 removed)
    1. + type AdSharingError
    2. enum AdError.Reason
      1. + value CANNOT_SET_WITH_URL_DATA
      2. + value ILLEGAL_TAG_USE
    3. enum AdGroupAdError.Reason
      1. + value CANNOT_CREATE_TEXT_ADS
    4. enum AdGroupServiceError.Reason
      1. + value AD_GROUP_TYPE_NOT_VALID_FOR_ADVERTISING_CHANNEL_TYPE
      2. + value ADGROUP_TYPE_NOT_SUPPORTED_FOR_CAMPAIGN_SALES_COUNTRY
    5. type ApiError
      1. + field fieldPathElements
    6. enum BiddingErrors.Reason
      1. + value ENHANCED_CPC_ENABLED_NOT_SUPPORTED_ON_PORTFOLIO_TARGET_SPEND_STRATEGY
    7. enum CampaignSharedSetError.Reason
      1. value SHARED_SET_NOT_ACTIVE
    8. enum CriterionError.Reason
      1. + value CANNOT_ADD_CLOSED_USER_LIST
    9. enum FeedError.Reason
      1. + value INVALID_AFFILIATE_CHAIN_ID
      2. + value CANNOT_CHANGE_SYSTEM_FEED_GENERATION_DATA_TYPE
      3. + value UNSUPPORTED_AFFILIATE_LOCATION_RELATIONSHIP_TYPE
    10. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
    11. enum UrlError.Reason
      1. + value DUPLICATE_URL_ID
      2. + value INVALID_URL_ID
  28. DraftService (0 new, 3 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum BiddingErrors.Reason
      1. + value ENHANCED_CPC_ENABLED_NOT_SUPPORTED_ON_PORTFOLIO_TARGET_SPEND_STRATEGY
    3. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  29. FeedItemService (0 new, 4 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum CriterionError.Reason
      1. + value CANNOT_ADD_CLOSED_USER_LIST
    3. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
    4. enum UrlError.Reason
      1. + value DUPLICATE_URL_ID
      2. + value INVALID_URL_ID
  30. FeedMappingService (0 new, 2 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  31. FeedService (5 new, 5 changed, 0 removed)
    1. + type AffiliateLocationFeedData
    2. + type Chain
    3. + type CollectionSizeError
    4. + enum CollectionSizeError.Reason
    5. + enum RelationshipType
    6. type AffiliateLocationFeedData
      1. + field chains
      2. + field relationshipType
    7. type ApiError
      1. + field fieldPathElements
    8. type CollectionSizeError
      1. + field reason
    9. enum FeedError.Reason
      1. + value INVALID_AFFILIATE_CHAIN_ID
      2. + value CANNOT_CHANGE_SYSTEM_FEED_GENERATION_DATA_TYPE
      3. + value UNSUPPORTED_AFFILIATE_LOCATION_RELATIONSHIP_TYPE
    10. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  32. LabelService (0 new, 2 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  33. LocationCriterionService (0 new, 2 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  34. ManagedCustomerService (0 new, 2 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  35. MediaService (0 new, 2 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  36. OfflineCallConversionFeedService (0 new, 3 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum OfflineConversionError.Reason
      1. + value ATTRIBUTED_CREDIT_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION
      2. + value ATTRIBUTION_MODEL_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION
      3. + value ATTRIBUTED_CREDIT_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION
      4. + value ATTRIBUTED_CREDIT_ZERO_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION
      5. + value ATTRIBUTION_MODEL_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION
      6. + value ORDER_ID_NOT_PERMITTED_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION
    3. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  37. OfflineConversionFeedService (0 new, 4 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum OfflineConversionError.Reason
      1. + value ATTRIBUTED_CREDIT_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION
      2. + value ATTRIBUTION_MODEL_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION
      3. + value ATTRIBUTED_CREDIT_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION
      4. + value ATTRIBUTED_CREDIT_ZERO_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION
      5. + value ATTRIBUTION_MODEL_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION
      6. + value ORDER_ID_NOT_PERMITTED_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION
    3. type OfflineConversionFeed
      1. + field externalAttributionCredit
      2. + field externalAttributionModel
    4. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  38. ReportDefinitionService (0 new, 2 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  39. SharedCriterionService (0 new, 3 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum CriterionError.Reason
      1. + value CANNOT_ADD_CLOSED_USER_LIST
    3. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  40. SharedSetService (0 new, 2 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  41. TargetingIdeaService (0 new, 4 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum BudgetError.Reason
      1. + value CANNOT_UPDATE_BUDGET_TO_EXPLICITLY_SHARED
    3. enum CriterionError.Reason
      1. + value CANNOT_ADD_CLOSED_USER_LIST
    4. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  42. TrafficEstimatorService (0 new, 2 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
  43. TrialAsyncErrorService (1 new, 10 changed, 0 removed)
    1. + type AdSharingError
    2. enum AdError.Reason
      1. + value CANNOT_SET_WITH_URL_DATA
      2. + value ILLEGAL_TAG_USE
    3. enum AdGroupAdError.Reason
      1. + value CANNOT_CREATE_TEXT_ADS
    4. enum AdGroupServiceError.Reason
      1. + value AD_GROUP_TYPE_NOT_VALID_FOR_ADVERTISING_CHANNEL_TYPE
      2. + value ADGROUP_TYPE_NOT_SUPPORTED_FOR_CAMPAIGN_SALES_COUNTRY
    5. type ApiError
      1. + field fieldPathElements
    6. enum BiddingErrors.Reason
      1. + value ENHANCED_CPC_ENABLED_NOT_SUPPORTED_ON_PORTFOLIO_TARGET_SPEND_STRATEGY
    7. enum CampaignSharedSetError.Reason
      1. value SHARED_SET_NOT_ACTIVE
    8. enum CriterionError.Reason
      1. + value CANNOT_ADD_CLOSED_USER_LIST
    9. enum FeedError.Reason
      1. + value INVALID_AFFILIATE_CHAIN_ID
      2. + value CANNOT_CHANGE_SYSTEM_FEED_GENERATION_DATA_TYPE
      3. + value UNSUPPORTED_AFFILIATE_LOCATION_RELATIONSHIP_TYPE
    10. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE
    11. enum UrlError.Reason
      1. + value DUPLICATE_URL_ID
      2. + value INVALID_URL_ID
  44. TrialService (0 new, 4 changed, 0 removed)
    1. type ApiError
      1. + field fieldPathElements
    2. enum BiddingErrors.Reason
      1. + value ENHANCED_CPC_ENABLED_NOT_SUPPORTED_ON_PORTFOLIO_TARGET_SPEND_STRATEGY
    3. enum BudgetError.Reason
      1. + value CANNOT_UPDATE_BUDGET_TO_EXPLICITLY_SHARED
    4. enum OperationAccessDenied.Reason
      1. + value OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE

v201609

What's new

Universal app campaigns

Account management

Conversions

Targeting

  • Using the new removeAll field of MutateMembersOperand, you can now indicate if your REMOVE operation should remove all members of a CrmBasedUserList, or only the members listed in the operand.
  • To prevent the addition of display network-only criteria to search campaigns, if you attempt to add any of the following criteria to a search campaign or its ad groups, the request will now fail with an OperationAccessDenied.OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE error:
    • AppPaymentModel
    • Carrier
    • MobileDevice
    • OperatingSystemVersion
    For a breakdown of the availability of each criteria type by campaign type, check out the criteria usage reference documentation.
  • Similarly, if you attempt to add a Webpage criterion to a display campaign, you will get an OperationAccessDenied.OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE error since Webpage criteria are specifically for Dynamic Search Ads.
  • The CAN_NOT_MUTATE_SENSITIVE_USERLIST error reason was added to UserListError to indicate if a user list in a mutate operation has been marked immutable due to privacy or legal reasons.

AdWords campaign experiments

Reporting

Segmentation by conversion source
  • The ExternalConversionSource field was added to several reports. Use this field to segment your conversions by source, for example: Website, Analytics, Import from calls.
Reporting on universal app campaigns
Video quartile columns and click type
  • The video quartile columns (VideoQuartile25, VideoQuartile50, VideoQuartile75, VideoQuartile100) are no longer compatible with the ClickType column. If you include any video quartile columns in a report request that also includes ClickType, you will get a ReportDefinitionError.INVALID_FIELD_NAME_FOR_REPORT error.
Campaign level criteria on the audience report
  • The AUDIENCE_PERFORMANCE_REPORT now includes audiences targeted at the campaign level. Previously, this report only included audiences targeted at the ad group level.
Exclusions on the audience report
New report fields
  • The following fields were added to the CLICK_PERFORMANCE_REPORT to provide additional details for the area of interest (AOI) and location of presence (LOP) criteria for each click:
    • AoiCountryCriteriaId
    • AoiRegionCriteriaId
    • AoiMetroCriteriaId
    • AoiCityCriteriaId
    • LopCountryCriteriaId
    • LopRegionCriteriaId
    • LopMetroCriteriaId
    • LopCityCriteriaId
  • The EnhancedDisplayCreativeLogoImageMediaId and EnhancedDisplayCreativeMarketingImageMediaId fields corresponding to logoImage and marketingImage of ResponsiveDisplayAd were added to the AD_PERFORMANCE_REPORT.
Removed report fields

The following fields related to the removed ExperimentService have been removed from all reports:

  • AdvertiserExperimentSegmentationBin
  • ClickSignificance
  • CostSignificance
  • CpcSignificance
  • CpmSignificance
  • CtrSignificance
  • ImpressionSignificance
  • PositionSignificance
  • ViewThroughConversionsSignificance

Migration guide

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

API changes

  1. - ExperimentService
  2. + OfflineCallConversionFeedService
  3. = AccountLabelService (no changes)
  4. = AdCustomizerFeedService (no changes)
  5. AdGroupAdService (0 new, 2 changed, 1 removed)
    1. type AdGroupAd
      1. field experimentData
    2. enum MediaError.Reason
      1. + value INVALID_MIME_TYPE
    3. type ExperimentError
  6. AdGroupBidModifierService (0 new, 1 changed, 0 removed)
    1. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
  7. AdGroupCriterionService (0 new, 4 changed, 1 removed)
    1. type BiddableAdGroupCriterion
      1. field experimentData
    2. enum BiddingErrors.Reason
      1. value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
      2. value CANNOT_CHANGE_BIDDING_STRATEGY_IN_CAMPAIGN_WITH_EXPERIMENT
    3. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
    4. enum MultiplierError.Reason
      1. value MULTIPLIER_NOT_ALLOWED_FOR_EXPERIMENT_DELTA_STATUS
    5. type ExperimentError
  8. AdGroupExtensionSettingService (0 new, 3 changed, 0 removed)
    1. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
    2. enum ExtensionSettingError.Reason
      1. + value PRICE_EXTENSION_HAS_TOO_MANY_ITEMS
    3. enum FeedItemQualityDisapprovalReasons
      1. + value DESCRIPTION_HAS_PRICE_QUALIFIERS
      2. + value UNSUPPORTED_LANGUAGE
      3. + value HEADER_OR_DESCRIPTION_HAS_PRICE
  9. = AdGroupFeedService (no changes)
  10. AdGroupService (0 new, 4 changed, 1 removed)
    1. type AdGroup
      1. field experimentData
    2. enum BiddingErrors.Reason
      1. value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
      2. value CANNOT_CHANGE_BIDDING_STRATEGY_IN_CAMPAIGN_WITH_EXPERIMENT
    3. enum MultiplierError.Reason
      1. value MULTIPLIER_NOT_ALLOWED_FOR_EXPERIMENT_DELTA_STATUS
    4. enum SettingError.Reason
      1. + value UNIVERSAL_APP_CAMPAIGN_SETTING_DUPLICATE_DESCRIPTION
      2. + value UNIVERSAL_APP_CAMPAIGN_SETTING_DESCRIPTION_LINE_WIDTH_TOO_LONG
      3. + value UNIVERSAL_APP_CAMPAIGN_SETTING_APP_ID_CANNOT_BE_MODIFIED
      4. + value TOO_MANY_YOUTUBE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN
      5. + value TOO_MANY_IMAGE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN
      6. + value MEDIA_INCOMPATIBLE_FOR_UNIVERSAL_APP_CAMPAIGN
    5. type ExperimentError
  11. = AdParamService (no changes)
  12. AdwordsUserListService (0 new, 3 changed, 0 removed)
    1. enum MutateMembersError.Reason
      1. + value INVALID_REMOVEALL_OPERATION
      2. + value INVALID_OPERATION_ORDER
    2. type MutateMembersOperand
      1. + field removeAll
    3. enum UserListError.Reason
      1. + value CAN_NOT_MUTATE_SENSITIVE_USERLIST
      2. + value CANNOT_MODIFY_BILLABLE_RECORD_COUNT
  13. = BatchJobService (no changes)
  14. BiddingStrategyService (0 new, 1 changed, 0 removed)
    1. enum BiddingErrors.Reason
      1. value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
      2. value CANNOT_CHANGE_BIDDING_STRATEGY_IN_CAMPAIGN_WITH_EXPERIMENT
  15. BudgetOrderService (0 new, 1 changed, 0 removed)
    1. type BudgetOrder
      1. + field totalAdjustments
  16. = BudgetService (no changes)
  17. CampaignCriterionService (0 new, 3 changed, 0 removed)
    1. type CampaignCriterion
      1. + field campaignCriterionStatus
    2. enum CampaignCriterionError.Reason
      1. + value CANNOT_SET_STATUS_FOR_CRITERIA_TYPE
      2. + value CANNOT_SET_STATUS_FOR_EXCLUDED_CRITERIA
    3. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
  18. CampaignExtensionSettingService (0 new, 3 changed, 0 removed)
    1. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
    2. enum ExtensionSettingError.Reason
      1. + value PRICE_EXTENSION_HAS_TOO_MANY_ITEMS
    3. enum FeedItemQualityDisapprovalReasons
      1. + value DESCRIPTION_HAS_PRICE_QUALIFIERS
      2. + value UNSUPPORTED_LANGUAGE
      3. + value HEADER_OR_DESCRIPTION_HAS_PRICE
  19. = CampaignFeedService (no changes)
  20. CampaignService (8 new, 12 changed, 0 removed)
    1. + type ListError
    2. + enum ListError.Reason
    3. + enum PolicyTopicEvidenceType
    4. + type TargetingSetting
    5. + type TargetingSettingDetail
    6. + enum UniversalAppBiddingStrategyGoalType
    7. + enum UniversalAppCampaignAsset
    8. + type UniversalAppCampaignSetting
    9. enum AdvertisingChannelSubType
      1. + value UNIVERSAL_APP_CAMPAIGN
    10. enum AdvertisingChannelType
      1. + value MULTI_CHANNEL
    11. enum BiddingErrors.Reason
      1. value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
      2. value CANNOT_CHANGE_BIDDING_STRATEGY_IN_CAMPAIGN_WITH_EXPERIMENT
    12. type Campaign
      1. + field selectiveOptimization
    13. enum CampaignError.Reason
      1. + value MISSING_UNIVERSAL_APP_CAMPAIGN_SETTING
      2. + value AT_LEAST_ONE_CONVERSION_MUST_BE_SELECTED
      3. value CANNOT_SET_END_DATE_BEFORE_EXPERIMENT_END_DATE
    14. type ListError
      1. + field reason
    15. enum PolicyTopicEntryType
      1. + value UNKNOWN
      2. + value PROHIBITED
      3. + value LIMITED
    16. type PolicyTopicEvidence
      1. + field policyTopicEvidenceType
    17. enum SettingError.Reason
      1. + value UNIVERSAL_APP_CAMPAIGN_SETTING_DUPLICATE_DESCRIPTION
      2. + value UNIVERSAL_APP_CAMPAIGN_SETTING_DESCRIPTION_LINE_WIDTH_TOO_LONG
      3. + value UNIVERSAL_APP_CAMPAIGN_SETTING_APP_ID_CANNOT_BE_MODIFIED
      4. + value TOO_MANY_YOUTUBE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN
      5. + value TOO_MANY_IMAGE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN
      6. + value MEDIA_INCOMPATIBLE_FOR_UNIVERSAL_APP_CAMPAIGN
    18. type TargetingSetting
      1. + field details
    19. type UniversalAppCampaignAdsPolicyDecisions
      1. + field universalAppCampaignAsset
    20. type UniversalAppCampaignSetting
      1. + field universalAppBiddingStrategyGoalType
  21. = CampaignSharedSetService (no changes)
  22. = ConstantDataService (no changes)
  23. ConversionTrackerService (1 new, 2 changed, 0 removed)
    1. + type UploadCallConversion
    2. type ConversionTracker
      1. + field attributionModelType
      2. + field dataDrivenModelStatus
    3. enum ConversionTrackingError.Reason
      1. + value ATTRIBUTION_MODEL_IS_UNEDITABLE
      2. + value DATA_DRIVEN_MODEL_WAS_NEVER_GENERATED
      3. + value DATA_DRIVEN_MODEL_IS_EXPIRED
      4. + value DATA_DRIVEN_MODEL_IS_STALE
      5. + value DATA_DRIVEN_MODEL_IS_UNKNOWN
  24. CustomerExtensionSettingService (0 new, 3 changed, 0 removed)
    1. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
    2. enum ExtensionSettingError.Reason
      1. + value PRICE_EXTENSION_HAS_TOO_MANY_ITEMS
    3. enum FeedItemQualityDisapprovalReasons
      1. + value DESCRIPTION_HAS_PRICE_QUALIFIERS
      2. + value UNSUPPORTED_LANGUAGE
      3. + value HEADER_OR_DESCRIPTION_HAS_PRICE
  25. = CustomerFeedService (no changes)
  26. CustomerService (2 new, 5 changed, 0 removed)
    1. + operation getServiceLinks
    2. + operation mutateServiceLinks
    3. type ConversionTrackingSettings
      1. field conversionOptimizerMode
    4. enum CustomerError.Reason
      1. + value INVALID_SERVICE_LINK
      2. + value INVALID_STATUS
    5. enum SettingError.Reason
      1. + value UNIVERSAL_APP_CAMPAIGN_SETTING_DUPLICATE_DESCRIPTION
      2. + value UNIVERSAL_APP_CAMPAIGN_SETTING_DESCRIPTION_LINE_WIDTH_TOO_LONG
      3. + value UNIVERSAL_APP_CAMPAIGN_SETTING_APP_ID_CANNOT_BE_MODIFIED
      4. + value TOO_MANY_YOUTUBE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN
      5. + value TOO_MANY_IMAGE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN
      6. + value MEDIA_INCOMPATIBLE_FOR_UNIVERSAL_APP_CAMPAIGN
    6. operation getServiceLinks
      1. + response rval
      2. + parameter selector
    7. operation mutateServiceLinks
      1. + parameter operations
      2. + response rval
  27. = CustomerSyncService (no changes)
  28. = DataService (no changes)
  29. DraftAsyncErrorService (0 new, 7 changed, 0 removed)
    1. enum BiddingErrors.Reason
      1. value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
      2. value CANNOT_CHANGE_BIDDING_STRATEGY_IN_CAMPAIGN_WITH_EXPERIMENT
    2. enum CampaignCriterionError.Reason
      1. + value CANNOT_SET_STATUS_FOR_CRITERIA_TYPE
      2. + value CANNOT_SET_STATUS_FOR_EXCLUDED_CRITERIA
    3. enum CampaignError.Reason
      1. + value MISSING_UNIVERSAL_APP_CAMPAIGN_SETTING
      2. + value AT_LEAST_ONE_CONVERSION_MUST_BE_SELECTED
      3. value CANNOT_SET_END_DATE_BEFORE_EXPERIMENT_END_DATE
    4. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
    5. enum MediaError.Reason
      1. + value INVALID_MIME_TYPE
    6. enum MultiplierError.Reason
      1. value MULTIPLIER_NOT_ALLOWED_FOR_EXPERIMENT_DELTA_STATUS
    7. enum SettingError.Reason
      1. + value UNIVERSAL_APP_CAMPAIGN_SETTING_DUPLICATE_DESCRIPTION
      2. + value UNIVERSAL_APP_CAMPAIGN_SETTING_DESCRIPTION_LINE_WIDTH_TOO_LONG
      3. + value UNIVERSAL_APP_CAMPAIGN_SETTING_APP_ID_CANNOT_BE_MODIFIED
      4. + value TOO_MANY_YOUTUBE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN
      5. + value TOO_MANY_IMAGE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN
      6. + value MEDIA_INCOMPATIBLE_FOR_UNIVERSAL_APP_CAMPAIGN
  30. DraftService (0 new, 1 changed, 0 removed)
    1. enum BiddingErrors.Reason
      1. value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
      2. value CANNOT_CHANGE_BIDDING_STRATEGY_IN_CAMPAIGN_WITH_EXPERIMENT
  31. FeedItemService (0 new, 2 changed, 0 removed)
    1. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
    2. enum FeedItemQualityDisapprovalReasons
      1. + value DESCRIPTION_HAS_PRICE_QUALIFIERS
      2. + value UNSUPPORTED_LANGUAGE
      3. + value HEADER_OR_DESCRIPTION_HAS_PRICE
  32. = FeedMappingService (no changes)
  33. = FeedService (no changes)
  34. = LabelService (no changes)
  35. = LocationCriterionService (no changes)
  36. ManagedCustomerService (0 new, 1 changed, 0 removed)
    1. type ManagedCustomer
      1. field companyName
  37. MediaService (0 new, 1 changed, 0 removed)
    1. enum MediaError.Reason
      1. + value INVALID_MIME_TYPE
  38. OfflineConversionFeedService (0 new, 1 changed, 0 removed)
    1. enum OfflineConversionError.Reason
      1. + value TOO_RECENT_CONVERSION_TYPE
  39. = ReportDefinitionService (no changes)
  40. SharedCriterionService (0 new, 1 changed, 0 removed)
    1. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
  41. = SharedSetService (no changes)
  42. TargetingIdeaService (0 new, 1 changed, 0 removed)
    1. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
  43. = TrafficEstimatorService (no changes)
  44. TrialAsyncErrorService (0 new, 7 changed, 0 removed)
    1. enum BiddingErrors.Reason
      1. value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
      2. value CANNOT_CHANGE_BIDDING_STRATEGY_IN_CAMPAIGN_WITH_EXPERIMENT
    2. enum CampaignCriterionError.Reason
      1. + value CANNOT_SET_STATUS_FOR_CRITERIA_TYPE
      2. + value CANNOT_SET_STATUS_FOR_EXCLUDED_CRITERIA
    3. enum CampaignError.Reason
      1. + value MISSING_UNIVERSAL_APP_CAMPAIGN_SETTING
      2. + value AT_LEAST_ONE_CONVERSION_MUST_BE_SELECTED
      3. value CANNOT_SET_END_DATE_BEFORE_EXPERIMENT_END_DATE
    4. enum CriterionError.Reason
      1. + value CANNOT_EXCLUDE_SIMILAR_USER_LIST
      2. + value CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP
    5. enum MediaError.Reason
      1. + value INVALID_MIME_TYPE
    6. enum MultiplierError.Reason
      1. value MULTIPLIER_NOT_ALLOWED_FOR_EXPERIMENT_DELTA_STATUS
    7. enum SettingError.Reason
      1. + value UNIVERSAL_APP_CAMPAIGN_SETTING_DUPLICATE_DESCRIPTION
      2. + value UNIVERSAL_APP_CAMPAIGN_SETTING_DESCRIPTION_LINE_WIDTH_TOO_LONG
      3. + value UNIVERSAL_APP_CAMPAIGN_SETTING_APP_ID_CANNOT_BE_MODIFIED
      4. + value TOO_MANY_YOUTUBE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN
      5. + value TOO_MANY_IMAGE_MEDIA_IDS_IN_UNIVERSAL_APP_CAMPAIGN
      6. + value MEDIA_INCOMPATIBLE_FOR_UNIVERSAL_APP_CAMPAIGN
  45. TrialService (0 new, 2 changed, 0 removed)
    1. enum BiddingErrors.Reason
      1. value BIDDING_STRATEGY_NOT_SUPPORTED_FOR_CAMPAIGNS_WITH_EXPERIMENTS
      2. value CANNOT_CHANGE_BIDDING_STRATEGY_IN_CAMPAIGN_WITH_EXPERIMENT
    2. enum CampaignError.Reason
      1. + value MISSING_UNIVERSAL_APP_CAMPAIGN_SETTING
      2. + value AT_LEAST_ONE_CONVERSION_MUST_BE_SELECTED
      3. value CANNOT_SET_END_DATE_BEFORE_EXPERIMENT_END_DATE

v201607

What's new

Expanded text ads

Ad extensions

App install campaigns

Account management

Quality score

Optimization

  • In all versions of the AdWords API, TargetingIdeaService and TrafficEstimatorService responses now include a count for operations consumed under the ResponseHeader element. Previously, this value was always 0 for these services.

Location targeting

Batch processing

Reporting

Filtering and displaying criteria with or without quality score
Displaying default values for final URLs
Quoting of values in comma-separated output
  • On all reports, fields that begin with the special characters - (minus) or + (plus) will be double-quoted without a leading space in the CSV, CSVFOREXCEL, GZIPPED_CSV, and TSV download formats to avoid treating the values as formula when importing report output into spreadsheets. Previously, these values were not double-quoted and had a leading space, but double-quoting the values is more consistent with the rest of the reporting API.

New report fields

In v201607:

  • The following fields were added to the CAMPAIGN_PERFORMANCE_REPORT:
    • CampaignDesktopBidModifier
    • CampaignTabletBidModifier
    These fields, along with the CampaignMobileBidModifier field added for v201605, allow you to report on all campaign-level platform bid adjustments.
  • The following fields were added to the ADGROUP_PERFORMANCE_REPORT:
    • AdGroupDesktopBidModifier
    • AdGroupTabletBidModifier
    These fields, along with the AdGroupMobileBidModifier field added for v201605, allow you to report on all ad group-level platform bid adjustments.
  • The GeoTargetingRestriction field was added to the PLACEHOLDER_FEED_ITEM_REPORT.
  • The CallOnlyPhoneNumber field was added to the AD_PERFORMANCE_REPORT.
  • The CreativeConversions and CreativeConversionRate fields were added to the CREATIVE_CONVERSION_REPORT to replace ConvertedClicks and ClickConversionRate, respectively. See the removed report fields section below for related changes to other reports.

In all versions:

  • The following fields were added to the VIDEO_PERFORMANCE_REPORT for consistency with other reports:
    • AccountCurrencyCode
    • AccountDescriptiveName
    • AccountTimeZoneId
    • CustomerDescriptiveName
    • ExternalCustomerId
    • PrimaryCompanyName
  • The list of enum values for the ClickType field has expanded to also include APP_DEEPLINK, VIDEO_END_CAP_CLICKS, and WIRELESS_PLAN.
Removed report fields

Send feedback about...

AdWords API
AdWords API
Need help? Visit our support page.