Share your feedback about the AdWords API! Take our annual survey.

Migration Guide (v201806)

See Deprecation Schedule for deprecation and sunset dates.

This page covers incremental changes introduced in v201806 that may remove or change functionality provided in previous versions. If you're moving multiple versions at once, make sure to consult each migration guide in sequence for a complete picture of API changes.

Changes to services and their components
CampaignService ShoppingSetting

The purchasePlatform field was removed.

CampaignService AdvertisingChannelType

The AdvertisingChannelSubType enum value SHOPPING_UNIVERSAL_ADS was renamed to SHOPPING_GOAL_OPTIMIZED_ADS.

AdGroupService AdGroupType

The AdGroupType enum value SHOPPING_UNIVERSAL_ADS was renamed to SHOPPING_GOAL_OPTIMIZED_ADS.

FeedItemService FeedItem

All targeting fields were removed from FeedItem:

  • devicePreference
  • scheduling
  • campaignTargeting
  • adGroupTargeting
  • keywordTargeting
  • geoTargeting

Use the FeedItemTargetService to set targeting for feed items instead.

FeedItemService
AdGroupExtensionSettingService
CampaignExtensionSettingService
CustomerExtensionSettingService
FeedItem
ExtensionFeedItem

The policyData field was removed. Use the policySummaries field instead.

CampaignService
AdGroupService
AdGroupCriterionService
BiddingStrategyService
EnhancedCpcBiddingScheme

EnhancedCpcBiddingScheme was removed.

AdGroupAdService UniversalShoppingAd

The type UniversalShoppingAd was renamed to GoalOptimizedShoppingAd.

CampaignGroupService CampaignGroup

The DELETED value of the status field was renamed to REMOVED.

CustomerService ConversionTrackingSettings

The optimizeOnEstimatedConversions field was removed.

AdwordsUserListService CrmBasedUserList

When specifying a CrmBasedUserList with uploadKeyType of MOBILE_ADVERTISING_ID, appId must also be set. If not, an APP_ID_NOT_SET error will be thrown.

When specifying a CrmBasedUserList with uploadKeyType of any other value, appId must be left blank, or else an APP_ID_NOT_ALLOWED error will be thrown.

Additionally, some values for the name field for CrmBasedUserList will now result in a USERLIST_NAME_IS_RESERVED_FOR_SYSTEM_LIST error. If you encounter this error, please choose a new name.

MediaService
AdGroupAdService
MediaBundleError

The new error type CUSTOM_EXIT_NOT_ALLOWED might be thrown when uploading a media bundle. This was always an error case, but the new error type provides more specificity about why the media bundle was rejected.

MediaService
AdGroupAdService
MimeType

The MimeType enum was renamed to LegacyMimeType.

Reporting Campaign Performance Report

The CampaignStatus now returns an enum status when useRawEnumValues is set to true, rather than a string status. For example, instead of Status_Active, ENABLED will be return.

Reporting Campaign Performance Report

The AdvertisingChannelSubType field will now return a value of "Shopping Campaign (goal-optimized)" where it previously returned "Universal Shopping Campaign".

Reporting Campaign Performance Report

The AdvertisingChannelSubType field will now return a value of -- instead of an empty string for Smart display campaigns.

Reporting Ad Group Performance Report

The AdGroupType field will now return a value of "Shopping - Goal-optimized" where it previously returned "Shopping - Universal", and the corresponding enum value changed from SHOPPING_UNIVERSAL_ADS to SHOPPING_GOAL_OPTIMIZED_ADS.

Reporting Ad Performance Report

The PolicySummary field now has a display value of "Policy" instead of "Ad policies".

Reporting Exclusive fields

Requests that select either of the following incompatible combinations will now fail with ReportDefinitionError.INVALID_FIELD_NAME_FOR_REPORT:

  • ClickType and ConversionLagBucket
  • HourOfDay and any of the following:
    • CostPerCurrentModelAttributedConversion
    • CurrentModelAttributedConversions
    • CurrentModelAttributedConversionValue
    • ValuePerCurrentModelAttributedConversion

Send feedback about...

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