Google Ads API is returning to beta status. Please read our blog post for more details.

将 AdWords 服务迁移到 Google Ads 服务

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

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

AdWords API 服务与 Google Ads API 服务的映射表
AccountLabelService LabelService

帐号一级的标签现已简称为 Labels

AdCustomizerFeedService IN AN UPCOMING RELEASE
AdGroupAdService AdGroupAdService

AdGroupAdService 用于制作和转变 AdGroupAds,以及在 Google Ads API 中制作广告。

AdGroupBidModifierService AdGroupBidModifierService
AdGroupCriterionService AdGroupCriterionService
AdGroupExtensionSettingService AdGroupExtensionSettingService
AdGroupFeedService AdGroupFeedService
AdGroupService AdGroupService
AdParamService AdParameterService
AdService IN AN UPCOMING RELEASE
AdwordsUserListService UserListService
AssetService AssetService
BatchJobService MutateJobService
BiddingStrategyService BiddingStrategyService
BudgetOrderService AccountBudgetProposalService
AccountBudgetService
BillingSetupService
PaymentsAccountService

这些都是当前用于结算的服务,还同时支持付款设置和帐号预算制定。

BudgetService CampaignBudgetService
CampaignBidModifierService CampaignBidModifierService
CampaignCriterionService CampaignCriterionService
CampaignExtensionSettingService CampaignExtensionSettingService
CampaignFeedService CampaignFeedService
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.search 可检索上述任一资源,但年龄段和性别除外,这两种资源当前分别表示为 AgeRangeTypeEnumGenderTypeEnum

ConversionTrackerService ConversionActionService
RemarketingActionService

在 AdWords API 中,转化操作和再营销操作均可通过 ConversionTrackerService 跟踪,再营销操作表示为不可更改的 AdWordsConversionTracker 对象,其中,status=HIDDEN 并且 category=REMARKETING

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

CustomAffinityService CustomInterestService

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

CustomerExtensionSettingService CustomerExtensionSettingService
CustomerFeedService CustomerFeedService
CustomerNegativeCriterionService CustomerNegativeCriterionService
CustomerService CustomerService
CustomerSyncService ChangeStatusService

请参阅本指南,了解 Change Status 服务。

DataService AdGroupCriterionSimulationService
AdGroupSimulationService
CampaignCriterionSimulationService
DraftAsyncErrorService CampaignDraftService

使用 CampaignDraftService.ListCampaignDraftAsyncErrors 方法。

DraftService CampaignDraftService
FeedItemService FeedItemService
FeedItemTargetService FeedItemTargetService
FeedMappingService FeedMappingService
FeedService FeedService
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
CustomerClientService
CustomerManagerLinkService

要转变客户方客户端关联,请使用 CustomerClientLinkService。要获取客户方客户端,请使用 CustomerClientService。要转变客户-经理关联,请使用 CustomerManagerLinkService

MediaService MediaFileService
OfflineCallConversionFeedService ConversionUploadService

要上传离线致电转化数据,请使用 ConversionUploadServiceUploadCallConversions 方法。

OfflineConversionAdjustmentFeedService ConversionAdjustmentUploadService
OfflineConversionFeedService ConversionUploadService

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

OfflineDataUploadService ConversionUploadService
ReportDefinitionService GoogleAdsFieldService

GoogleAdsFieldService 不会检索报告字段,而是显示 GoogleAdsService.search 界面中提供的所有资源、资源的字段、细分键和指标。

SharedCriterionService SharedCriterionService
SharedSetService SharedSetService
TargetingIdeaService KeywordPlanIdeaService

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

TrafficEstimatorService KeywordPlanAdGroupService
KeywordPlanCampaignService
KeywordPlanIdeaService
KeywordPlanKeywordService
KeywordPlanNegativeKeywordService
KeywordPlanService

您可以使用这些服务创建包含广告组、条件等的关键字方案实体,并为整个方案定价。

TrialAsyncErrorService CampaignExperimentService

使用 CampaignExperimentService.ListCampaignExperimentAsyncErrors 方法。

TrialService CampaignExperimentService
Reports GoogleAdsService

现在,报告成了通过“搜索”实现的统一查询模型的一部分,而“搜索”又是 GoogleAdsService 的一部分。有关所有报告字段是如何映射的,请参阅本指南