Migrating AdWords API Services to Google Ads API Services

The Google Ads API shares most of the same functionality as the AdWords API, however, a small number of services have changed. Some have been deprecated, some have been split into multiple new services, and some have been consolidated into a single new service.

To help in your migration to the Google Ads API, below is a comprehensive list of all of the AdWords services and their Google Ads API equivalent.

AdWords API Service	Equivalent Google Ads API Service
`AccountLabelService`	`LabelService` Account-level labels are now just referred to as `Labels`.
`AdCustomizerFeedService`	`FeedService CustomerFeedService CampaignFeedService AdGroupFeedService FeedMappingService` Note: Feed-based extensions are scheduled for deprecation beginning October 2021. See Migrating Feed-based Extensions.
`AdGroupAdService`	`AdGroupAdService` `AdGroupAdService` is used to create and mutate ad group ads. Learn more.
`AdGroupBidModifierService`	`AdGroupBidModifierService`
`AdGroupCriterionService`	`AdGroupCriterionService`
`AdGroupExtensionSettingService`	`AdGroupExtensionSettingService` Note: Feed-based extensions are scheduled for deprecation beginning October 2021. See Migrating Feed-based Extensions.
`AdGroupFeedService`	`AdGroupFeedService` Note: Feed-based extensions are scheduled for deprecation beginning October 2021. See Migrating Feed-based Extensions.
`AdGroupService`	`AdGroupService`
`AdParamService`	`AdParameterService`
`AdService`	`AdService`
`AdwordsUserListService`	`OfflineUserDataJobService UserListService` Use `OfflineUserDataJobService` to mutate members of an existing user list, and `UserListService` to mutate and read user lists. Learn more.
`AssetService`	`AssetService` Learn more.
`BatchJobService`	`BatchJobService` Learn more.
`BiddingStrategyService`	`BiddingStrategyService` Learn more.
`BudgetOrderService`	`AccountBudgetProposalService BillingSetupService PaymentsAccountService` The services that now make up billing allow for both payments setup and account budget creation. For budget reporting, check out `account_budget`.
`BudgetService`	`CampaignBudgetService` Learn more.
`CampaignBidModifierService`	`CampaignBidModifierService` Learn more.
`CampaignCriterionService`	`CampaignCriterionService`
`CampaignExtensionSettingService`	`CampaignExtensionSettingService` Learn more. Note: Feed-based extensions are scheduled for deprecation beginning October 2021. See Migrating Feed-based Extensions.
`CampaignFeedService`	`CampaignFeedService` Note: Feed-based extensions are scheduled for deprecation beginning October 2021. See Migrating Feed-based Extensions.
`CampaignGroupPerformanceTargetService`	`DEPRECATED`
`CampaignGroupService`	`DEPRECATED`
`CampaignService`	`CampaignService` Learn more.
`CampaignSharedSetService`	`CampaignSharedSetService`
`ConstantDataService`	`GoogleAdsService` The mapping from ConstantDataService method return type to Google Ads API type is as follows: `getAgeRangeCriterion` -> `AgeRangeTypeEnum` `getCarrierCriterion` -> `CarrierConstant` `getGenderCriterion` -> `GenderTypeEnum` `getLanguageCriterion` -> `LanguageConstant` `getMobileAppCategoryCriterion` -> `MobileAppCategoryConstant` `getMobileDeviceCriterion` -> `MobileDeviceConstant` `getOperatingSystemVersionCriterion` -> `OperatingSystemVersionConstant` `getProductBiddingCategoryData` -> `ProductBiddingCategoryConstant` `getUserInterestCriterion` -> `UserInterest` `getVerticalCriterion` -> `TopicConstant` Use `GoogleAdsService.search` or `GoogleAdsService.searchStream` to retrieve any of these resources, with the exception of age ranges and genders, which are now represented as `AgeRangeTypeEnum` and `GenderTypeEnum`, respectively. Learn more.
`ConversionTrackerService`	`ConversionActionService RemarketingActionService` In the AdWords API, both conversion actions and remarketing actions were available using the `ConversionTrackerService`, with remarketing actions represented as immutable `AdWordsConversionTracker` objects with `status=HIDDEN` and `category=REMARKETING`. In the Google Ads API, remarketing actions are a separate resource type that's managed using the `RemarketingActionService`.
`CustomAffinityService`	`CustomInterestService` To get custom interest data query the `custom_interest` resource using Search.
`CustomerExtensionSettingService`	`CustomerExtensionSettingService` Note: Feed-based extensions are scheduled for deprecation beginning October 2021. See Migrating Feed-based Extensions.
`CustomerFeedService`	`CustomerFeedService` Note: Feed-based extensions are scheduled for deprecation beginning October 2021. See Migrating Feed-based Extensions.
`CustomerNegativeCriterionService`	`CustomerNegativeCriterionService`
`CustomerService`	`CustomerService` Learn more.
`CustomerSyncService`	Query the report resource: `change_status`. Learn more.
`DataService`	Query these report resources: `ad_group_criterion_simulation ad_group_simulation campaign_criterion_simulation`
`DraftAsyncErrorService`	`CampaignDraftService` Use the `ListCampaignDraftAsyncErrors` method.
`DraftService`	`CampaignDraftService`
`FeedItemService`	`FeedItemService` Note: Feed-based extensions are scheduled for deprecation beginning October 2021. See Migrating Feed-based Extensions.
`FeedItemTargetService`	`FeedItemTargetService`
`FeedMappingService`	`FeedMappingService` Note: Feed-based extensions are scheduled for deprecation beginning October 2021. See Migrating Feed-based Extensions.
`FeedService`	`FeedService` Learn more. Note: Feed-based extensions are scheduled for deprecation beginning October 2021. See Migrating Feed-based Extensions.
`LabelService`	`AdGroupAdLabelService AdGroupCriterionLabelService AdGroupLabelService CampaignLabelService CustomerLabelService` Retrieving Labels is done through the `LabelService`, however mutations are done by using entirely new services instead of methods on resource-specific services. For example, In the AdWords API, mutating a campaign label was done with the `CampaignService.mutatelabel` method, but in the Google Ads API it's done with the `CampaignLabelService`. All of the `#mutatelabel` methods have been moved to new services as follows: `AdGroupAdService#mutatelabel` -> `AdGroupAdLabelService` `AdGroupCriterionService#mutatelabel` -> `AdGroupCriterionLabelService` `AdGroupService#mutatelabel` -> `AdGroupLabelService` `CampaignService#mutatelabel` -> `CampaignLabelService` `ManagedCustomerService#mutatelabel` -> `CustomerLabelService` Note that to mutate Account Labels you should use the `LabelService` in Google Ads.
`LocationCriterionService`	`GeoTargetConstantService` Learn more.
`ManagedCustomerService`	`CustomerClientLinkService CustomerManagerLinkService` To mutate customer-client links use the `CustomerClientLinkService`. To mutate customer-manager links use the `CustomerManagerLinkService`. To get customer clients, use the `customer_client` report resource.
`MediaService`	`MediaFileService`
`OfflineCallConversionFeedService`	`ConversionUploadService` To upload offline call conversions use the `UploadCallConversions` method on the `ConversionUploadService`.
`OfflineConversionAdjustmentFeedService`	`ConversionAdjustmentUploadService`
`OfflineConversionFeedService`	`ConversionUploadService` To upload offline click conversions use the `UploadClickConversions` method.
`OfflineDataUploadService`	`OfflineUserDataJobService` Use `OfflineUserDataJobService` for asynchronous bulk uploads of customer match data and store sales direct transactions.
`ReportDefinitionService`	`GoogleAdsFieldService` Instead of retrieving report fields, `GoogleAdsFieldService` will show you all of the resources, resource's fields, segmentation keys and metrics available in the `GoogleAdsService.search` and `GoogleAdsService.searchStream` methods.
`Reports`	`GoogleAdsService` Reporting is now part of the unified query model implemented through Search, part of `GoogleAdsService`. How reporting fields are mapped.
`SharedCriterionService`	`SharedCriterionService`
`SharedSetService`	`SharedSetService`
`TargetingIdeaService`	`KeywordPlanIdeaService` Business Category and Seed Ad Group have been removed.
`TrafficEstimatorService`	`KeywordPlanAdGroupService KeywordPlanCampaignService KeywordPlanIdeaService KeywordPlanService` Use these services to create a keyword plan entity with ad groups, criteria, etc. and the entire plan can be priced. Learn more. You can also query these report resources: `keyword_plan_ad_group_keyword keyword_plan_campaign_keyword`
`TrialAsyncErrorService`	`CampaignExperimentService` Caution: This version of the experiments feature is deprecated. Use the latest version instead. Use the `ListCampaignExperimentAsyncErrors` method.
`TrialService`	`CampaignExperimentService` Learn more.

URL reports

Migrating to UserDataService