The AdWords API supports a large number of features, most of which have been migrated to the Google Ads API. This guide aims to list each feature of the AdWords API, whether it's been migrated to the Google Ads API, and where the documentation for the new functionality can be found.
Since the complete list of features in the AdWords API is so large, this guide
may omit some general functionality, for example retrieving Campaigns, in order
to focus on more detailed features. It also does not cover many Get
methods
since that functionality is better covered in the Migrating Report
Fields guide.
Migrated features
Below is a list of AdWords API features that are currently available in the Google Ads API.
Account management
Mutate AccountLabels
|
Combined with LabelService . Use the Labels guide for more details.
|
Mutate Customer
|
Use CustomerService.MutateCustomer
|
Mutate Customer
Support for |
Use Customer.conversion_tracking_setting
|
Mutate Customer
Support for |
Use Customer.remarketing_setting
|
Mutate Customer
Support for upgraded URLs: |
Use the related fields on the Customer resource. Note that the parallelTrackingEnabled field is deprecated in Google Ads.
|
Mutate ServiceLinks
Support for |
Use MerchantCenterLinkService.MutateMerchantCenterLink
|
Mutate Label and TextLabel
|
Use LabelService.MutateLabels
|
Mutate Label and TextLabel
Support for |
Use the TextLabel resource.
|
Mutate ManagedCustomer
|
Use CustomerService.MutateCustomer when updating a Customer and CustomerService.CreateCustomerClient when creating a new one.
|
Mutate ManagedCustomerLabel
Support for |
Use CustomerClient.applied_label_ids
|
Mutate ManagedCustomerLink
|
The functionality of the ManagedCustomerLink resource is split across multiple services in the Google Ads API. To mutate customer-client links, use the CustomerClientLinkService , to mutate customer-manager links use the CustomerManagerLinkService .
|
Mutate ManagedCustomerLink
Support for moving client customer accounts to new managers |
Use CustomerManagerLinkService.MoveManagerLink
|
Mutate ManagedCustomerLink
Send invitation emails for |
Use the CreateCustomerClientRequest.email_address field when using the CustomerService.CreateCustomerClient method. Note that this feature is for allowlisted users only.
|
Mutate ManagedCustomerLink
Set |
Use the CreateCustomerClientRequest.access_role field when using the CustomerService.CreateCustomerClient method.
|
Ads
Create and Get Ad (fields defined on base class Ad )
automated (boolean), |
|
Create and Get Ad (fields defined on base class Ad )
Upgraded URLs ( |
|
Mutate CallOnlyAd
|
Use CallAdInfo
|
Mutate ExpandedDynamicSearchAd
|
ExpandedDynamicSearchAds in AdWords are covered by DynamicSearchAds in Google Ads.
|
Mutate ExpandedTextAd
|
Use ExpandedTextAd
|
Mutate GmailAd
|
Use GmailAd and this Help Center article about Gmail Ads.
|
Mutate GmailAd
|
Use GmailAd and this Help Center article about Gmail Ads.
|
Mutate GmailAd
|
Use GmailAd and this Help Center article about Gmail Ads.
|
Mutate GoalOptimizedShoppingAd
|
GoalOptimizedShoppingAd does not explicitly exist in Google Ads, but its functionality is covered by ShoppingSmartAd .
|
Mutate ImageAd
|
Use ImageAdInfo
|
Update Image field on ImageAd
|
Use ImageAdInfo.image
|
Mutate ResponsiveDisplayAd
|
Use LegacyResponsiveDisplayAdInfo
|
Mutate TextAd
|
Use ExpandedTextAd
|
Mutate MultiAssetResponsiveDisplayAd
|
Use ResponsiveDisplayAd
|
Mutate MultiAssetResponsiveDisplayAd
|
AssetLink is represented in Google Ads by AdImageAsset , AdTextAsset , and AdVideoAsset .
|
Mutate ProductAd
|
Use ShoppingProductAd
|
Mutate ResponsiveSearchAd
|
Use ResponsiveSearchAd
|
Mutate UniversalAppAd
|
UniversalAppAd is represented as AppAd in Google Ads and is part of App Campaigns. Use this Help Center article about App Campaigns and the App Campaigns guide for more details
|
Mutate UniversalAppAd
|
On the AppAd resource in Google Ads, AssetLink is represented by AdImageAsset , AdTextAsset , AdVideoAsset , and MediaBundleAsset
|
Mutate AdGroupAd
|
Use the AdGroupAdService.MutateAdGroupAds method
|
Mutate AdGroupAdLabel
|
Use the AdGroupAdLabelService
|
Request policy violation exemption for AdGroupAd
|
Use AdGroupAdOperation.policy_validation_parameter
|
Mutate AdGroupBidModifier
|
Use the AdGroupBidModifierService.MutateAdGroupBidModifiers method
|
Mutate AdGroupBidModifier
|
In Google Ads Platform is represented by AdGroupBidModifier.device , and PreferredContent is represented by AdGroupBidModifier.preferred_content
|
Mutate BiddableAdGroupCriterion or NegativeAdGroupCriterion
|
In Google Ads BiddableAdGroupCriterion and NegativeAdGroupCriterion are not distinct types, instead the behavior is represented directly on AdGroupCriterion
|
Mutate BiddableAdGroupCriterion or NegativeAdGroupCriterion
Support for criterion types: |
In Google Ads Vertical is represented by AdGroupCriterion.topic , and ProductPartition is represented by AdGroupCriterion.listing_group . Use the Criteria Guide for more details.
|
Mutate BiddableAdGroupCriterion or NegativeAdGroupCriterion
BiddingStrategyConfiguration |
In Google Ads bidding strategy type can only be set at the Campaign level so there's no way to override it at the AdGroupCriterion level, however you can override bid amounts at the AdGroupCriterion level. See the Bidding Guide for more details.
|
Mutate BiddableAdGroupCriterion or NegativeAdGroupCriterion
Upgraded URLs support |
All Upgraded URL fields are represented in Google Ads except finalAppUrls , which has been deprecated. Use the Upgraded URLs Guide for more details.
|
Mutate AdGroupCriterionLabel
|
Use the AdGroupCriterionLabelService
|
Mutate AdGroupLabel
|
Use the AdGroupLabelService
|
Mutate AdGroups
|
Use the AdGroupService
|
Mutate AdGroups
|
Use AdGroup.ad_rotation_mode
|
Mutate AdGroups
Support for |
In Google Ads SHOPPING_SHOWCASE_AD has been deprecated and SHOPPING_GOAL_OPTIMIZED_AD functionality is represented by ShoppingSmartAd
|
Mutate AdGroups
|
In Google Ads bidding strategy type can only be set at the Campaign level so there's no way to override it at the AdGroup level, however you can override bid amounts at the AdGroup level. See the Bidding Guide for more details.
|
Mutate AdGroups
|
AdGroup.contentBidCriterionTypeGroup is represented by AdGroup.display_custom_bid_dimension in Google Ads
|
Mutate AdGroups
|
Use AdGroup.url_custom_parameters
|
Mutate AdGroups
|
Instead of being included in AdGroup.settings , ExplorerAutoOptimizerSetting and TargetingSetting objects are represented by the distinct fields AdGroup.explorer_auto_optimizer_setting and AdGroup.targeting_setting in Google Ads.
|
Mutate AdGroups
Upgraded URLs support, ( |
Use AdGroup.tracking_url_template and the Upgraded URLs guide
|
Mutate AdParams
|
Use the AdParameterService
|
Get and update CallOnlyAd
|
Use Ad.call_ad
|
Get and update ExpandedTextAd
|
Use Ad.expanded_text_ad
|
Get and update MultiAssetResponsiveDisplayAd
|
MultiAssetResponsiveDisplayAd is represented as Ad.responsive_display_ad in Google Ads
|
Get and update ResponsiveDisplayAd
|
ResponsiveDisplayAd is represented by Ad.legacy_responsive_display_ad in Google Ads.
|
Get and update ResponsiveSearchAd
|
Use Ad.responsive_search_ad
|
Get and update UniversalAppAd
|
UniversalAppAd is represented by Ad.app_ad in Google Ads and is part of App Campaigns
|
Mutate Assets
|
Use the AssetService
|
Mutate ImageAssets
|
Use ImageAsset
|
Mutate MediaBundleAssets
|
Use MediaBundleAsset
|
Mutate YouTubeVideoAssets
|
Use YoutubeVideoAsset
|
Create Audio
|
Use MediaFile.audio
|
Create Image
|
Use MediaFile.image
|
Create MediaBundle
|
Use MediaFile.media_bundle
|
Create Video
|
Use MediaFile.video
|
Criteria
For more detailed information on each targeting criterion, see theCriteria
migration guide.
Audiences
Batch jobs
Create BatchJob
|
Use the BatchJobService
|
Get status of BatchJob
|
Use BatchJob.status
|
Get status of BatchJob
ProgressStats |
Use BatchJob.metadata
|
Add operations to BatchJob
UploadUrl |
Use the AddBatchJobOperations method
|
Get status of BatchJob
DownloadUrl |
Use the ListBatchJobResults method
|
Bidding
To create or update a portfolio (shared) bidding strategy, use theBiddingStrategyService
.
To create or update standard (non-shared) bidding strategies, use the
CampaignService
and set the strategy
directly on the Campaign
object. A shared bidding strategy can be set on a Campaign by using the
Campaign.bidding_strategy
with a
shared bidding strategy
resource_name
.
Billing
Mutate BudgetOrder
Support for billing account ID, start date and end date fields |
Use BillingSetup in the BillingSetupService
|
Read BillingAccounts
|
Use PaymentsAccountService.ListPaymentsAccounts
|
Campaigns
Mutate Budgets
|
Use CampaignBudget.MutateCampaignBudgets
|
Mutate Campaign
|
Use the CampaignService
|
Mutate Campaign
|
Use Campaign.ad_serving_optimization_status
|
Mutate Campaign
Support for |
Use AdvertisingChannelSubTypeEnum
|
Mutate Campaign
Support for |
Use AdvertisingChannelTypeEnum
|
Mutate Campaign
BiddingStrategyConfiguration |
Use Campaign.campaign_bidding_strategy
|
Mutate Campaign
Budget |
Use Campaign.campaign_budget
|
Mutate Campaign
Support for |
In Google Ads Campaign settings are assigned their own individual field instead of being compiled into a single "settings" field. For example, see Campaign.real_time_bidding_setting
|
Mutate Campaign
FrequencyCap |
Use Campaign.frequency_caps
|
Mutate Campaign
Support for |
Use Campaign.NetworkSettings
|
Mutate Campaign
SelectiveOptimization |
Use Campaign.selective_optimization
|
Mutate Campaign
UniversalAppCampaignInfo |
Use Campaign.app_campaign_setting
|
Mutate Campaign
Upgraded URLs: |
Use Campaign.tracking_url_template
|
Mutate Campaign
VanityPharma |
Use Campaign.vanity_pharma
|
Mutate Campaign label associations
TextLabel |
Use Campaign.labels
|
Mutate CampaignLabel
|
Use the CampaignLabelService
|
Mutate CampaignSharedSet
Support for |
Use the CampaignSharedSetService
|
Change history
Get CustomerChangeData
Retrieve the changed entities for a |
Use the change_status resource
|
Constants
AgeRangeCriterion
|
In Google Ads these criterion constants are defined on the AgeRangeType enum
|
GenderCriterion
|
In Google Ads these criterion constants are defined on the GenderType enum
|
LocationCriterion
Retrieve |
Use the GeoTargetConstantService
|
Conversions
Experiments
Get DraftAsyncError
Retrieving asynchronous errors from promoting |
Use CampaignDraftService.ListCampaignDraftAsyncErrors
|
Mutate Draft
|
Use CampaignDraftService
|
Mutate Draft
Archive |
Use CampaignDraftStatus.removed
|
Mutate Draft
Promote |
Use CampaignDraftService
|
Get TrialAsyncError
Get asynchronous errors from creating and promoting |
Use CampaignExperimentService
|
Mutate Trial
|
Use CampaignExperimentService
|
Get Trial
Support for common |
Use CampaignExperimentService
|
Mutate Trial
Support for promoting |
Use CampaignExperimentService
|
Mutate Trial
Support for graduating |
Use CampaignExperimentService
|
Feeds
Mutate common AdCustomizerFeed attributes
|
Use the Customize Ads guide |
Mutate AdGroupExtensionSetting
|
Use the AdGroupExtensionSettingService
|
Mutate AdGroupExtensionSetting
Support for extension types: |
Use ExtensionTypeEnum
|
Mutate AdGroupFeeds
|
Use the AdGroupFeedService
|
Mutate AdGroupFeeds
Support for extension types: |
AdGroupFeedService and the Feeds guide
|
Mutate AdGroupFeeds
|
Use MatchingFunction.operator
|
Mutate CampaignExtensionSetting
|
Use the CampaignExtensionSettingService
|
Mutate CampaignExtensionSetting
Support for extension types: |
Use ExtensionTypeEnum
|
Mutate CampaignFeed
|
Use the CampaignFeedService
|
Mutate CampaignFeed
Support for all placeholder types |
Use the CampaignFeedService and the Extensions guide
|
Mutate CampaignFeed
Support for function operators |
Use MatchingFunctionOperatorEnum
|
Mutate CustomerExtensionSetting
Support for extension types: |
Use the CustomerExtensionSettingService
|
Mutate CustomerFeed
|
Use the CustomerFeedService
|
Mutate CustomerFeed
Support for placeholder types: |
Use PlaceholderTypeEnum
|
Mutate CustomerFeed
Support for |
Use MatchingFunction
|
Mutate FeedItem
|
Use the FeedItemService
|
Mutate FeedItem
|
Use FeedItem.url_custom_parameters
|
Mutate FeedItem
|
Use FeedItem.attribute_values
|
Mutate FeedItem
|
Use FeedItem.geo_targeting_restriction
|
Mutate FeedItemTarget
|
Use FeedItemTargetService
|
Mutate FeedItemTarget
Support for |
Use FeedItemTarget.feed_item_target_type
|
Mutate FeedMapping
|
Use FeedMappingService
|
Mutate FeedMapping
|
Use FeedMapping.attribute_field_mappings
|
Mutate FeedMapping
|
Use FeedMapping.criterion_type
|
Mutate FeedMapping
|
Use FeedMapping.placeholder_type
|
Mutate Feed
|
Use Feed
|
Mutate Feed
Create affiliate location feed based on chainId |
Use AffiliateLocationFeedData.chain_ids
|
Mutate Feed
Support for |
Use FeedAttributeTypeEnum
|
Create Business Profile-linked location Feed
|
Use PlacesLocationFeedData
|
Create Business Profile-linked location Feed
Filter Business Profile-linked location feed by business name |
Use PlacesLocationFeedData.business_name_filter
|
Create Business Profile-linked location Feed
Filter Business Profile-linked location feed by category |
Use PlacesLocationFeedData.category_filters
|
Create Business Profile-linked location Feed
Filter Business Profile-linked location feed by label |
Use PlacesLocationFeedData.label_filters
|
Create Business Profile-linked location Feed
Specify auth for Business Profile-linked Location feed |
Use PlacesLocationFeedData.oauth_info
|
Mutate Feed
Add feed attributes to a feed |
Use Feed.attribute_operations
|
Mutate Feed
Identify primary key attribute of feed items with the FeedAttribute isPartOfKey field |
Use FeedAttribute.is_part_of_key
|
Get Feed
Detect system and user-managed feeds |
Use Feed.origin
|
Planning
Get TargetingIdea
Support for request type |
Use KeywordPlanIdeaService.GenerateKeywordIdeas
|
Get TargetingIdea
Support for request type |
Use KeywordPlanService.GenerateHistoricalMetrics
|
Get CampaignEstimate
|
TrafficEstimatorService has been split into a number of different services, see the Generate Forecast Metrics guide for more information. |
Reporting
For more detailed information on how to migrate individual reports, see the Migrating Report Fields guide.
Get ReportDefinition
|
There is no direct equivalent for ReportDefition in Google Ads because reporting is based on individual resources instead of pre-defined reports. It is possible to get information about report resources programmatically using the GoogleAdsFieldService . Use the Migrating Report Fields guide to determine the equivalent report resources and fields for AdWords report fields.
|
Deprecated features
Below is a list of AdWords API features that will not be migrated to the Google Ads API.
Ads
Mutate DeprecatedAd
|
DeprecatedAd is not a real ad type. In AdWords it was a way to access data for old ads that were of types that have been deprecated. When retrieved from the Google Ads API, ads of this type will have an Ad.type of UNKNOWN .
|
Mutate DynamicSearchAd
|
DynamicSearchAd was deprecated and replaced with ExpandedDynamicSearchAd in AdWords. In Google Ads information about expanded dynamic search ads can be read using the Ad.expanded_dynamic_search_ad field.
|
Mutate RichMediaAd
|
This feature will not be migrated to Google Ads |
Mutate ShowcaseAd
|
This feature will not be migrated to Google Ads |
Mutate TemplateAd
|
TemplateAd does not exist in Google Ads, however some ad formats are available in DisplayUploadAd
|
Mutate TemplateAd
|
This feature will not be migrated to Google Ads |
Mutate ThirdPartyRedirectAd
|
This feature will not be migrated to Google Ads |
Mutate ThirdPartyRedirectAd
|
This feature will not be migrated to Google Ads |
Get and update ThirdPartyRedirectAd
|
This feature will not be migrated to Google Ads |
Get and update ShowcaseAd
|
This feature will not be migrated to Google Ads |
Bidding
Mutate CampaignBidModifier
Support for the |
This feature will not be migrated to Google Ads |
Campaigns
Mutate Campaign
ConversionOptimizerEligibility |
This feature will not be migrated to Google Ads |
Mutate CampaignGroupPerformanceTarget
|
This feature will not be migrated to Google Ads |
Mutate CampaignGroup
|
This feature will not be migrated to Google Ads |
Conversions
Mutate AppConversion
Support for app post-back URL for app download conversion |
This feature will not be migrated to Google Ads |