将 AdWords API 服务迁移到 Google Ads API 服务

Google Ads API 的大部分功能都与 AdWords API 相同,但有少数服务发生了变化。一些服务已弃用,一些服务拆分成为多项新服务,还有一些服务则合并成为一项新服务。

为帮助您顺利迁移到 Google Ads API,我们在下面提供了所有 AdWords 服务及其 Google Ads API 等效服务的完整列表。

AdWords API 服务等效的 Google Ads API 服务
AccountLabelService LabelService

帐号级标签现在简称为 Labels

AdCustomizerFeedService FeedService
CustomerFeedService
CampaignFeedService
AdGroupFeedService
FeedMappingService

注意:基于 Feed 的附加信息将于 2021 年 10 月起弃用。请参阅迁移基于 Feed 的扩展程序

AdGroupAdService AdGroupAdService

AdGroupAdService 用于制作和更改广告组的广告。了解详情

AdGroupBidModifierService AdGroupBidModifierService
AdGroupCriterionService AdGroupCriterionService
AdGroupExtensionSettingService AdGroupExtensionSettingService

注意:基于 Feed 的附加信息将于 2021 年 10 月起弃用。请参阅迁移基于 Feed 的扩展程序

AdGroupFeedService AdGroupFeedService

注意:基于 Feed 的附加信息将于 2021 年 10 月起弃用。请参阅迁移基于 Feed 的扩展程序

AdGroupService AdGroupService
AdParamService AdParameterService
AdService AdService
AdwordsUserListService OfflineUserDataJobService
UserListService

使用 OfflineUserDataJobService 可更改现有用户列表的成员,使用 UserListService 可更改和读取用户列表。了解详情。

AssetService AssetService

了解详情

BatchJobService BatchJobService

了解详情

BiddingStrategyService BiddingStrategyService

了解详情

BudgetOrderService AccountBudgetProposalService
BillingSetupService
PaymentsAccountService

现在,构成结算的服务支持付款设置和创建帐号预算。如需了解预算报告,请参阅 account_budget

BudgetService CampaignBudgetService

了解详情

CampaignBidModifierService CampaignBidModifierService

了解详情

CampaignCriterionService CampaignCriterionService
CampaignExtensionSettingService CampaignExtensionSettingService

了解详情

注意:基于 Feed 的附加信息将于 2021 年 10 月起弃用。请参阅迁移基于 Feed 的扩展程序

CampaignFeedService CampaignFeedService

注意:基于 Feed 的附加信息将于 2021 年 10 月起弃用。请参阅迁移基于 Feed 的扩展程序

CampaignGroupPerformanceTargetService DEPRECATED
CampaignGroupService DEPRECATED
CampaignService CampaignService

了解详情

CampaignSharedSetService CampaignSharedSetService
ConstantDataService GoogleAdsService

ConstantDataService 方法返回类型到 Google Ads API 类型的映射如下所示:

  • getAgeRangeCriterion -> AgeRangeTypeEnum
  • getCarrierCriterion -> CarrierConstant
  • getGenderCriterion -> GenderTypeEnum
  • getLanguageCriterion -> LanguageConstant
  • getMobileAppCategoryCriterion -> MobileAppCategoryConstant
  • getMobileDeviceCriterion -> MobileDeviceConstant
  • getOperatingSystemVersionCriterion -> OperatingSystemVersionConstant
  • getProductBiddingCategoryData -> ProductBiddingCategoryConstant
  • getUserInterestCriterion -> UserInterest
  • getVerticalCriterion -> TopicConstant

可以使用 GoogleAdsService.searchGoogleAdsService.searchStream 检索这些资源(年龄段和性别除外,它们现在分别表示为 AgeRangeTypeEnumGenderTypeEnum)。了解详情

ConversionTrackerService ConversionActionService
RemarketingActionService

在 AdWords API 中,转化操作和再营销操作均通过 ConversionTrackerService 获得,其中转化操作表示为不可变的 AdWordsConversionTracker 对象,包括 status=HIDDENcategory=REMARKETING

在 Google Ads API 中,再营销操作是使用 RemarketingActionService 管理的独立资源类型。

CustomAffinityService CustomInterestService

如需获取自定义兴趣数据,请使用“搜索”功能查询 custom_interest 资源。

CustomerExtensionSettingService CustomerExtensionSettingService

注意:基于 Feed 的附加信息将于 2021 年 10 月起弃用。请参阅迁移基于 Feed 的扩展程序

CustomerFeedService CustomerFeedService

注意:基于 Feed 的附加信息将于 2021 年 10 月起弃用。请参阅迁移基于 Feed 的扩展程序

CustomerNegativeCriterionService CustomerNegativeCriterionService
CustomerService CustomerService

了解详情

CustomerSyncService

查询报告资源:change_status

了解详情

DataService

查询以下报表资源:
ad_group_criterion_simulation
ad_group_simulation
campaign_criterion_simulation

DraftAsyncErrorService CampaignDraftService

使用 ListCampaignDraftAsyncErrors 方法。

DraftService CampaignDraftService
FeedItemService FeedItemService

注意:基于 Feed 的附加信息将于 2021 年 10 月起弃用。请参阅迁移基于 Feed 的扩展程序

FeedItemTargetService FeedItemTargetService
FeedMappingService FeedMappingService

注意:基于 Feed 的附加信息将于 2021 年 10 月起弃用。请参阅迁移基于 Feed 的扩展程序

FeedService FeedService

了解详情

注意:基于 Feed 的附加信息将于 2021 年 10 月起弃用。请参阅迁移基于 Feed 的扩展程序

LabelService AdGroupAdLabelService
AdGroupCriterionLabelService
AdGroupLabelService
CampaignLabelService
CustomerLabelService

检索标签是通过 LabelService 完成的,但转变操作是使用全新服务(而不是特定于资源的服务上的方法)完成的。例如,在 AdWords API 中,更改广告系列标签的操作是通过 CampaignService.mutatelabel 方法完成的,但在 Google Ads API 中,则是通过 CampaignLabelService 方法完成的。所有 #mutatelabel 方法都已移至新服务,如下所示:

  • AdGroupAdService#mutatelabel -> AdGroupAdLabelService
  • AdGroupCriterionService#mutatelabel -> AdGroupCriterionLabelService
  • AdGroupService#mutatelabel -> AdGroupLabelService
  • CampaignService#mutatelabel -> CampaignLabelService
  • ManagedCustomerService#mutatelabel -> CustomerLabelService

请注意,如需更改帐号标签,您应在 Google Ads 中使用 LabelService

LocationCriterionService GeoTargetConstantService

了解详情

ManagedCustomerService CustomerClientLinkService
CustomerManagerLinkService

如需转变客户方客户端关联,请使用 CustomerClientLinkService。如需转变客户服务经理关联,请使用 CustomerManagerLinkService。 如需获得客户客户端,请使用 customer_client 报告资源。

MediaService MediaFileService
OfflineCallConversionFeedService ConversionUploadService

要上传线下转化数据,请使用 ConversionUploadService 中的 UploadCallConversions 方法。

OfflineConversionAdjustmentFeedService ConversionAdjustmentUploadService
OfflineConversionFeedService ConversionUploadService

要上传线下转化数据,请使用 UploadClickConversions 方法。

OfflineDataUploadService OfflineUserDataJobService

使用 OfflineUserDataJobService 异步上传目标客户匹配数据和实体店销售直接交易。

ReportDefinitionService GoogleAdsFieldService

GoogleAdsFieldService 会检索 GoogleAdsService.searchGoogleAdsService.searchStream 方法中提供的所有资源、资源字段、细分键和指标,而不会检索报告字段。

Reports GoogleAdsService

报告现在是通过 Google 搜索实现的统一查询模型的一部分,是 GoogleAdsService 的一部分。报告字段的映射方式

SharedCriterionService SharedCriterionService
SharedSetService SharedSetService
TargetingIdeaService KeywordPlanIdeaService

业务类别和种子广告组已移除。

TrafficEstimatorService KeywordPlanAdGroupService
KeywordPlanCampaignService
KeywordPlanIdeaService
KeywordPlanService

使用这些服务创建包含广告组和条件等的关键字方案实体,整个方案都可定价。了解详情

您还可以查询以下报告资源:
keyword_plan_ad_group_keyword
keyword_plan_campaign_keyword

TrialAsyncErrorService CampaignExperimentService

使用 ListCampaignExperimentAsyncErrors 方法。

TrialService CampaignExperimentService

了解详情