How AdWords API features are mapped to the Google Ads API

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 ConversionTrackingSettings

Use Customer.conversion_tracking_setting
Mutate Customer

Support for RemarketingSettings

Use Customer.remarketing_setting
Mutate Customer

Support for upgraded URLs: finalUrlSuffix, trackingTemplate, customParameters, autoTaggingEnabled, parallelTrackingEnabled

Use the related fields on the Customer resource. Note that the parallelTrackingEnabled field is deprecated in Google Ads.
Mutate ServiceLinks

Support for ServiceType.MERCHANT_CENTER

Use MerchantCenterLinkService.MutateMerchantCenterLink
Mutate Label and TextLabel

Use LabelService.MutateLabels
Mutate Label and TextLabel

Support for DisplayAttribute (description, color)

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 ManagedCustomer.AccountLabels

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 ManagedCustomer accounts

Use the CreateCustomerClientRequest.email_address field when using the CustomerService.CreateCustomerClient method. Note that this feature is for allowlisted users only.
Mutate ManagedCustomerLink

Set ManagedCustomer role for sending invite when creating

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), systemManagedEntitySource, devicePreference

Create and Get Ad (fields defined on base class Ad)

Upgraded URLs (final, finalMobile, finalApp, trackingTemplate, customParams)

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

Image support

Use GmailAd and this Help Center article about Gmail Ads.
Mutate GmailAd

Video support

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 support in various fields

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

AssetLink support in various fields

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

Platform, PreferredContent support

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: AgeRange, AppPaymentModel, CriterionCustomAffinity, CriterionCustomIntent, CriterionUserInterest, CriterionUserList, Gender, IncomeRange, Keyword, MobileAppCategory, MobileApplication, Parent, Placement, ProductPartition, Vertical,

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

AdGroupRotationMode support

Use AdGroup.ad_rotation_mode
Mutate AdGroups

Support for AdGroup types: SEARCH_STANDARD, SEARCH_DYNAMIC_ADS, DISPLAY_STANDARD, SHOPPING_PRODUCT_ADS, SHOPPING_SHOWCASE_ADS, SHOPPING_GOAL_OPTIMIZED_AD

In Google Ads SHOPPING_SHOWCASE_AD has been deprecated and SHOPPING_GOAL_OPTIMIZED_AD functionality is represented by ShoppingSmartAd
Mutate AdGroups

BiddingStrategyConfiguration support

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

contentBidCriterionTypeGroup support

AdGroup.contentBidCriterionTypeGroup is represented by AdGroup.display_custom_bid_dimension in Google Ads
Mutate AdGroups

CustomParameters

Use AdGroup.url_custom_parameters
Mutate AdGroups

ExplorerAutoOptimizerSetting, TargetingSetting

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, (finalUrlSuffix, trackingTemplate, customParameters)

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

ImageAsset (JPG, GIF, PNG)

Use ImageAsset
Mutate MediaBundleAssets

MediaBundleAsset

Use MediaBundleAsset
Mutate YouTubeVideoAssets

YouTubeVideoAsset

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 the Criteria migration guide.

Mutate SharedSetCriterion

Use the SharedCriterionService
Mutate SharedSetCriterion

Support for criteria types Keyword, Placement

Use SharedCriterion.criterion
Mutate SharedSets

Use the SharedSetService
Mutate SharedSets

Support for criteria types Keyword, Placement

Use SharedSet.type
Mutate CampaignCriterion or NegativeCampaignCriterion

Use the CampaignCriterionService
AdSchedule criterion

Campaign-level positive targeting

Use AdScheduleInfo
AgeRange criterion

Campaign-level negative targeting

Use AgeRangeInfo
AgeRange criterion

Ad-group-level biddable targeting

Use AgeRangeInfo
AgeRange criterion

Ad-group-level negative targeting

Use AgeRangeInfo
Carrier criterion

Campaign-level positive targeting

Use CarrierInfo
ContentLabel criterion

Campaign-level negative targeting

Use ContentLabelInfo
CriterionUserInterest criterion

Campaign-level negative targeting

Use UserInterestInfo
CriterionUserInterest criterion

Ad-group-level biddable targeting

Use UserInterestInfo
CriterionUserInterest criterion

Ad-group-level negative targeting

Use UserInterestInfo
CriterionUserList criterion

Campaign-level positive targeting

Use UserListInfo
CriterionUserList criterion

Campaign-level negative targeting

Use UserListInfo
CriterionUserList criterion

Ad-group-level biddable targeting

Use UserListInfo
CriterionUserList criterion

Ad-group-level negative targeting

Use UserListInfo
Gender criterion

Campaign-level negative targeting

Use GenderInfo
Gender criterion

Ad-group-level biddable targeting

Use GenderInfo
Gender criterion

Ad-group-level negative targeting

Use GenderInfo
IpBlock criterion

Campaign-level negative targeting

Use IpBlockInfo
Keyword criterion

Campaign-level negative targeting

Use KeywordInfo
Keyword criterion

Ad-group-level biddable targeting

Use KeywordInfo
Keyword criterion

Ad-group-level negative targeting

Use KeywordInfo
Language criterion

Campaign-level positive targeting

Use LanguageInfo
Location criterion

Campaign-level positive targeting

Use LocationInfo
Location criterion

Campaign-level negative targeting

Use LocationInfo
LocationGroup criterion

Campaign-level positive targeting

Use LocationGroupInfo
MobileAppCategory criterion

Campaign-level negative targeting

Use MobileAppCategoryInfo
MobileAppCategory criterion

Ad-group-level biddable targeting

Use MobileAppCategoryInfo
MobileAppCategory criterion

Ad-group-level negative targeting

Use MobileAppCategoryInfo
MobileApplication criterion

Campaign-level negative targeting

Use MobileApplicationInfo
MobileApplication criterion

Ad-group-level biddable targeting

Use MobileApplicationInfo
MobileApplication criterion

Ad-group-level negative targeting

Use MobileApplicationInfo
MobileDevice criterion

Campaign-level positive targeting

Use MobileDeviceInfo
OperatingSystemVersion criterion

Campaign-level positive targeting

Use OperatingSystemVersionInfo
Parent criterion

Campaign-level negative targeting

Use ParentalStatusInfo
Parent criterion

Ad-group-level biddable targeting

Use ParentalStatusInfo
Parent criterion

Ad-group-level negative targeting

Use ParentalStatusInfo
Placement criterion

Campaign-level negative targeting

Use PlacementInfo
Placement criterion

Ad-group-level biddable targeting

Use PlacementInfo
Placement criterion

Ad-group-level negative targeting

Use PlacementInfo
Platform criterion

Campaign-level positive targeting

Use DeviceInfo
ProductScope criterion

Campaign-level positive targeting

Use ListingScopeInfo
Proximity criterion

Campaign-level positive targeting

Use ProximityInfo
Vertical criterion

Campaign-level negative targeting

Use TopicInfo
Vertical criterion

Ad-group-level biddable targeting

Use TopicInfo
Vertical criterion

Ad-group-level negative targeting

Use TopicInfo
YouTubeChannel criterion

Campaign-level negative targeting

Use YouTubeChannelInfo
YouTubeChannel criterion

Ad-group-level biddable targeting

Use YouTubeChannelInfo
YouTubeChannel criterion

Ad-group-level negative targeting

Use YouTubeChannelInfo
YouTubeVideo criterion

Campaign-level negative targeting

Use YouTubeVideoInfo
YouTubeVideo criterion

Ad-group-level biddable targeting

Use YouTubeVideoInfo
YouTubeVideo criterion

Ad-group-level negative targeting

Use YouTubeVideoInfo
Webpage criterion

Campaign-level negative targeting

Use WebpageInfo
Webpage criterion

Ad-group-level biddable targeting

Use WebpageInfo
Webpage criterion

Ad-group-level negative targeting

Use WebpageInfo
Add or remove CustomAffinityTokens

Use CustomInterestMember, part of the members field on CustomInterest in the CustomInterestService
Create CustomAffinity

Use CustomInterestService
Create CustomAffinity

Support for type CUSTOM_INTENT

Use CustomInterestService
Mutate common CustomAffinity attributes

Use CustomInterestService
Specify URL or KEYWORD CustomAffinityToken

Use CustomInterestMember, part of the members field on CustomInterest in the CustomInterestService
Mutate CustomerNegativeCriterion

Support for ContentLabel, MobileAppCategory, MobileApplication, Placement, YouTubeChannel, YouTubeVideo

Use CustomerNegativeCriterion.criterion

Audiences

Mutate common UserList attributes

Use the UserListService
Mutate common UserList attributes

Integration code (external ID)

Use UserList.integration_code
Mutate BasicUserList

Manage conversion actions

Use the Visitors Who Took Specific Actions guide.
Mutate CrmBasedUserList

Mobile Ad ID - specify app

Use CrmBasedUserListInfo.app_id
Mutate CrmBasedUserList

Specify source (1st party, 3rd party credit bureau, 3rd party voter file)

Use CrmBasedUserListInfo.data_source_type
CrmBasedUserList member upload

Add or remove single member

Use the OfflineUserDataJobService
CrmBasedUserList member upload

Read member type (single)

Use the UserListService.GetUserList method or the user_list.crm_based_user_list.upload_key_type report field
CrmBasedUserList member upload

Read status of member upload or remove all upload

Use OfflineUserDataJob.status
CrmBasedUserList member upload

Remove all members

Use OfflineUserDataJobOperation.remove_all
CrmBasedUserList member upload

Upload member based on advertiser assigned user ID

Use UserIdentifier.third_party_user_id
CrmBasedUserList member upload

Upload member based on contact info (email, phone, address including hashed first name, hashed last name, zip code, country)

Use UserIdentifier.hashed_email
CrmBasedUserList member upload

Upload member based on Mobile Ad ID

Use the Customer Match with Mobile Device IDs guide
Mutate ExpressionRuleUserList

Create

Use ExpressionRuleUserListInfo.rule
Mutate LogicalUserList

ALL, ANY, NONE (not) rule for user lists

Use LogicalUserListInfo.rules
Mutate RuleBasedUserList

Combine rules and rule item groups using CNF or DNF

Use UserListRuleInfo.rule_type
Mutate RuleBasedUserList

Combine rules into a rule item group

Use UserListRuleInfo.rule_item_groups
Mutate RuleBasedUserList

Combine rules with AND and AND_NOT

Use CombinedRuleUserListInfo.rule_operator
Mutate RuleBasedUserList

Create date rule for relative or absolute date

Use UserListDateRuleItemInfo
Mutate RuleBasedUserList

Create NumberRuleItem

Use UserListNumberRuleItemInfo
Mutate RuleBasedUserList

Create StringRuleItem

Use UserListStringRuleItemInfo
Mutate RuleBasedUserList

Read prepopulation status

Use RuleBasedUserListInfo.prepopulation_status
Access read-only UserList attributes

Access info

Use UserList.access_reason
Access read-only UserList attributes

Network eligibility, whether Search or Display

Use UserList.eligible_for_search
Access read-only UserList attributes

Reason for closing

Use UserList.closing_reason
Access read-only UserList attributes

UserList size and size range

In Google Ads, size and size range are broken out by network, specifically UserList.size_for_display, UserList.size_for_search, UserList.size_range_for_display, and UserList.size_range_for_search
Read SimilarUserList

Read seed UserList ID or other identifier

Use SimilarUserListInfo.seed_user_list

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 the BiddingStrategyService. 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.

Mutate SharedBiddingStrategy

SharedBiddingStrategy is referred to as BiddingStrategy in Google Ads. Use the BiddingStrategyService
Mutate MaximizeConversionsBiddingScheme

Support at the portfolio (shared) level.

Use the BiddingStrategy.maximize_conversions field
Mutate MaximizeConversionValueBiddingScheme

Support at the portfolio (shared) level.

Use the BiddingStrategy.maximize_conversion_value field
Mutate TargetRoasBiddingScheme

Support at the portfolio (shared) level.

Use BiddingStrategy.target_roas.
Mutate TargetCpaBiddingScheme

Support at the portfolio (shared) level.

Use BiddingStrategy.target_cpa.
Mutate TargetSpendBiddingScheme

Support at the portfolio (shared) level.

Use BiddingStrategy.target_spend
Mutate BiddingStrategyConfiguration

Support at the Campaign (non-shared) level.

Use the Campaign.campaign_bidding_strategy field. Campaign-level bidding strategies are set using the CampaignService
Mutate ManualCpcBiddingScheme

Support at the Campaign (non-shared) level.

Use the Campaign.campaign_bidding_strategy field, where manual_cpc can be set as a oneof field.
Mutate ManualCpmBiddingScheme

Support at the Campaign (non-shared) level.

Use the Campaign.campaign_bidding_strategy field, where manual_cpm can be set as a oneof field.
Mutate MaximizeConversionsBiddingScheme

Support at the Campaign (non-shared) level.

Use the Campaign.maximize_conversions field
Mutate MaximizeConversionValueBiddingScheme

Support at the Campaign (non-shared) level.

Use the Campaign.maximize_conversion_value field
Mutate TargetRoasBiddingScheme

Support at the Campaign (non-shared) level.

Use Campaign.maximize_conversion_value, with a non-zero target_roas value.
Mutate TargetCpaBiddingScheme

Support at the Campaign (non-shared) level.

Use Campaign.maximize_conversions, with a non-zero target_cpa value.
Mutate TargetSpendBiddingScheme

Support at the Campaign (non-shared) level.

Use Campaign.target_spend
Mutate CampaignBidModifier

Use the CampaignBidModifierService
Mutate CampaignBidModifier

Support for the InteractionType field

Use CampaignBidModifier.interaction_type

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

AdServingOptimizationStatus

Use Campaign.ad_serving_optimization_status
Mutate Campaign

Support for AdvertisingChannelSubType: SEARCH_MOBILE_APP, DISPLAY_MOBILE_APP, SEARCH_EXPRESS, DISPLAY_EXPRESS, UNIVERSAL_APP_CAMPAIGN, DISPLAY_SMART_CAMPAIGN, SHOPPING_GOAL_OPTIMIZED_ADS, DISPLAY_GMAIL_AD

Use AdvertisingChannelSubTypeEnum
Mutate Campaign

Support for AdvertisingChannelType: SEARCH, DISPLAY, SHOPPING, MULTI_CHANNEL

Use AdvertisingChannelTypeEnum
Mutate Campaign

BiddingStrategyConfiguration

Use Campaign.campaign_bidding_strategy
Mutate Campaign

Budget

Use Campaign.campaign_budget
Mutate Campaign

Support for Setting: DynamicSearchAdsSetting, GeoTargetTypeSetting, UniversalAppCampaignSetting, RealTimeBiddingSetting, ShoppingSetting, TargetingSetting, TrackingSetting

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 NetworkSettings: targetGoogleSearch, targetSearchNetwork, targetContentNetwork, targetPartnerSearchNetwork

Use Campaign.NetworkSettings
Mutate Campaign

SelectiveOptimization

Use Campaign.selective_optimization
Mutate Campaign

UniversalAppCampaignInfo

Use Campaign.app_campaign_setting
Mutate Campaign

Upgraded URLs: finalUrlSuffix, trackingTemplate, customParameters

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 NEGATIVE_KEYWORDS and NEGATIVE_PLACEMENTS

Use the CampaignSharedSetService

Change history

Get CustomerChangeData

Retrieve the changed entities for a Customer account or Campaign

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 LocationCriterion constants

Use the GeoTargetConstantService

Conversions

Mutate common ConversionTracker attributes

Instead of ConversionTracker see ConversionAction and the ConversionActionService
Mutate AppConversion

Support for ANDROID_MARKET, ITUNES, and MOBILE_APP_CHANNEL vendor types

Use ConversionAction.mobile_app_vendor
Mutate AppConversion

Support for DOWNLOAD, IN_APP_PURCHASE, or FIRST_OPEN conversion types

Use ConversionAction.conversion_action_type
Mutate AdCallMetricsConversion

Support for setting call duration

Use ConversionAction.phone_call_duration_seconds
Mutate UploadCallConversion

Use ConversionActionType.upload_calls
Mutate UploadClickConversion

Support for specifying whether externally attributed

Use AttributionModel#external
Mutate WebsiteCallMetricsConversion

Support for setting call duration

Use ConversionAction.phone_call_duration_seconds
Mutate AdWordsConversionTracker

Support for setting tracking code type

Use TagSnippet.type
Read read-only ConversionTracker attributes

Support for event snippet, Google tag, data driven model status, and owner customer

Use TagSnippet.event_snippet, TagSnippet.global_site_tag, AttributionModelSettings.data_driven_model_status, and ConversionAction.owner_customer
Read read-only ConversionTracker attributes

Get most recent conversion/request information

Use metrics.conversion_last_conversion_date and metrics.conversion_last_received_request_date_time in the conversion_action report.
Mutate OfflineCallConversionFeed

Use ConversionUploadService.UploadCallConversions
Mutate OfflineConversionFeed

Use ConversionUploadService.UploadClickConversions
Mutate OfflineConversionFeed

Support for external attribution

Use ConversionAction.attribution_model_settings
Mutate GclidOfflineConversionAdjustmentFeed or OrderIdOfflineConversionAdjustmentFeed

Use ConversionAdjustment.conversion_identifier
Mutate GclidOfflineConversionAdjustmentFeed or OrderIdOfflineConversionAdjustmentFeed

Support for AdjustmentType.RESTATE

Use ConversionAdjustment.adjustment_type
Mutate GclidOfflineConversionAdjustmentFeed or OrderIdOfflineConversionAdjustmentFeed

Support for AdjustmentType.RETRACT

Use ConversionAdjustment.adjustment_type
Mutate OfflineDataUpload

Support for store sales transactions

Use OfflineUserDataJob.store_sales_metadata
Mutate OfflineDataUpload

Support for external upload ID

Use OfflineUserDataJob.external_id
Mutate OfflineDataUpload

Support for first party upload

Use OfflineUserDataJob.type
Mutate OfflineDataUpload

Support for third party upload

Use OfflineUserDataJob.type

Experiments

Get DraftAsyncError

Retrieving asynchronous errors from promoting Drafts

Use CampaignDraftService.ListCampaignDraftAsyncErrors
Mutate Draft

Use CampaignDraftService
Mutate Draft

Archive Draft

Use CampaignDraftStatus.removed
Mutate Draft

Promote Draft

Use CampaignDraftService
Get TrialAsyncError

Get asynchronous errors from creating and promoting Trials

Use CampaignExperimentService
Mutate Trial

Use CampaignExperimentService
Get Trial

Support for common Trial attributes

Use CampaignExperimentService
Mutate Trial

Support for promoting Trials

Use CampaignExperimentService
Mutate Trial

Support for graduating Trials

Use CampaignExperimentService

Feeds

Mutate common AdCustomizerFeed attributes

Use the Customize Ads guide
Mutate AdGroupExtensionSetting

Use the AdGroupExtensionSettingService
Mutate AdGroupExtensionSetting

Support for extension types: APP, CALL, CALLOUT, MESSAGE, PRICE, PROMOTION, SITELINK, STRUCTURED_SNIPPET

Use ExtensionTypeEnum
Mutate AdGroupFeeds

Use the AdGroupFeedService
Mutate AdGroupFeeds

Support for extension types: APP, CALL, CALLOUT, MESSAGE, PRICE, PROMOTION, SITELINK, STRUCTURED_SNIPPET

AdGroupFeedService and the Feeds guide
Mutate AdGroupFeeds

Function.Operator IN, EQUALS, AND, CONTAINS_ANY, IDENTITY

Use MatchingFunction.operator
Mutate CampaignExtensionSetting

Use the CampaignExtensionSettingService
Mutate CampaignExtensionSetting

Support for extension types: APP, CALL, CALLOUT, MESSAGE, PRICE, PROMOTION, SITELINK, STRUCTURED_SNIPPET

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 IN, EQUALS, AND, CONTAINS_ANY, IDENTITY

Use MatchingFunctionOperatorEnum
Mutate CustomerExtensionSetting

Support for extension types: APP, CALL, CALLOUT, MESSAGE, PRICE, PROMOTION, SITELINK, STRUCTURED_SNIPPET

Use the CustomerExtensionSettingService
Mutate CustomerFeed

Use the CustomerFeedService
Mutate CustomerFeed

Support for placeholder types: APP, CALL, CALLOUT, MESSAGE, PRICE, PROMOTION, SITELINK, STRUCTURED_SNIPPET, LOCATION, AFFILIATE_LOCATION, AD_CUSTOMIZER

Use PlaceholderTypeEnum
Mutate CustomerFeed

Support for Function.Operator IN, EQUALS, AND, CONTAINS_ANY, IDENTITY

Use MatchingFunction
Mutate FeedItem

Use the FeedItemService
Mutate FeedItem

CustomParameter

Use FeedItem.url_custom_parameters
Mutate FeedItem

FeedItemAttributeValue

Use FeedItem.attribute_values
Mutate FeedItem

FeedItemGeoRestriction

Use FeedItem.geo_targeting_restriction
Mutate FeedItemTarget

Use FeedItemTargetService
Mutate FeedItemTarget

Support for FeedItemTargetType CAMPAIGN, AD_GROUP, CRITERION

Use FeedItemTarget.feed_item_target_type
Mutate FeedMapping

Use FeedMappingService
Mutate FeedMapping

AttributeFieldMapping

Use FeedMapping.attribute_field_mappings
Mutate FeedMapping

CriterionType (for location and DSA feeds)

Use FeedMapping.criterion_type
Mutate FeedMapping

PlaceholderType

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 FeedAttribute types: INT64, INT64_LIST, FLOAT, FLOAT_LIST, STRING, STRING_LIST, BOOLEAN, BOOLEAN_LIST, URL, URL_LIST, DATE_TIME, DATE_TIME_LIST, PRICE

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 IDEAS

Use KeywordPlanIdeaService.GenerateKeywordIdeas
Get TargetingIdea

Support for request type STATS

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

adAsImage support

This feature will not be migrated to Google Ads
Mutate ThirdPartyRedirectAd

This feature will not be migrated to Google Ads
Mutate ThirdPartyRedirectAd

certifiedVendorFormatId support

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 AdvertisingChannelType field

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