AdWords API 支持大量功能,其中大多数功能都已迁移到 Google Ads API。本指南旨在列出 AdWords API 的每项功能,无论它们是否已迁移到 Google Ads API 以及在哪里可以找到有关新功能的文档。
由于 AdWords API 中功能的完整列表非常庞大,因此本指南可能省略了一些常规功能(如检索广告系列),以便重点关注更详细的功能。也未涵盖许多 Get
方法,因为迁移报告字段指南对此功能进行了更好的介绍。
迁移的功能
下面列出了目前可以在 Google Ads API 中使用的 AdWords API 功能。
帐号管理
Ads
创建和获取 Ad (在基类 Ad 中定义的字段)
自动(布尔值)、 |
|
创建和获取 Ad (在基类 Ad 中定义的字段)
升级版网址( |
|
转变 CallOnlyAd
|
使用 CallOnlyAdInfo
|
转变 ExpandedDynamicSearchAd
|
AdWords 中的 ExpandedDynamicSearchAds 在 Google Ads 中涵盖DynamicSearchAds 。
|
转变 ExpandedTextAd
|
使用 ExpandedTextAd
|
转变 GmailAd
|
请参阅 GmailAd 这篇关于 Gmail 广告的帮助中心文章。
|
转变 GmailAd
|
请参阅 GmailAd 这篇关于 Gmail 广告的帮助中心文章。
|
转变 GmailAd
|
请参阅 GmailAd 这篇关于 Gmail 广告的帮助中心文章。
|
转变 GoalOptimizedShoppingAd
|
GoalOptimizedShoppingAd 未明确包含在 Google Ads 中,但其功能在 ShoppingSmartAd 的涵盖范围内。 |
转变 ImageAd
|
使用 ImageAdInfo
|
更新 ImageAd 中的 Image 字段
|
使用 ImageAdInfo.image
|
转变 ResponsiveDisplayAd
|
使用 LegacyResponsiveDisplayAdInfo
|
转变 TextAd
|
使用 ExpandedTextAd
|
转变 MultiAssetResponsiveDisplayAd
|
使用 ResponsiveDisplayAd
|
转变 MultiAssetResponsiveDisplayAd
各个字段中的 |
在 Google Ads 中,AssetLink 由 AdImageAsset 、AdTextAsset 和 AdVideoAsset 表示。
|
转变 ProductAd
|
使用 ShoppingProductAd
|
转变 ResponsiveSearchAd
|
使用 ResponsiveSearchAd
|
转变 UniversalAppAd
|
UniversalAppAd 在 Google Ads 中以 AppAd 的形式表示,是应用广告系列的一部分。如需了解详情,请参阅应用广告系列简介这篇帮助中心文章和应用广告系列指南
|
转变 UniversalAppAd
各个字段中的 |
在 Google Ads 中的 AppAd 资源中,AssetLink 由 AdImageAsset 、AdTextAsset 、AdVideoAsset 和 AdBundleAsset 表示
|
转变 AdGroupAd
|
使用 AdGroupAdService.MutateAdGroupAds 方法
|
转变 AdGroupAdLabel
|
使用 AdGroupAdLabelService
|
针对 AdGroupAd 申请豁免违规情况
|
使用 AdGroupAdOperation.policy_validation_parameter
|
转变 AdGroupBidModifier
|
使用 AdGroupBidModifierService.MutateAdGroupBidModifiers 方法
|
转变 AdGroupBidModifier
|
在 Google Ads 中,Platform 由 AdGroupBidModifier.device 表示,PreferredContent 由 AdGroupBidModifier.preferred_content 表示
|
转变 BiddableAdGroupCriterion 或 NegativeAdGroupCriterion
|
在 Google Ads 中,BiddableAdGroupCriterion 和 NegativeAdGroupCriterion 不是不同类型的,而是直接以 AdGroupCriterion 的形式表示
|
转变 BiddableAdGroupCriterion 或 NegativeAdGroupCriterion
支持条件类型: |
在 Google Ads 中,Vertical 由 AdGroupCriterion.topic 表示,ProductPartition 由 AdGroupCriterion.listing_group 表示。如需了解更多详情,请参阅条件指南。
|
转变 BiddableAdGroupCriterion 或 NegativeAdGroupCriterion
BiddingStrategyConfiguration |
在 Google Ads 出价策略类型中,只能在Campaign 一级设置,因此无法在AdGroupCriterion 一级覆盖,但您可以在AdGroupCriterion 一级替换出价金额。如需了解详情,请参阅出价指南。 |
转变 BiddableAdGroupCriterion 或 NegativeAdGroupCriterion
支持升级版网址 |
在 Google Ads 中,除finalAppUrls (已弃用)之外,所有升级版网址字段都以 Google Ads 表示。如需了解详情,请参阅升级版网址指南。
|
转变 AdGroupCriterionLabel
|
使用 AdGroupCriterionLabelService
|
转变 AdGroupLabel
|
使用 AdGroupLabelService
|
转变 AdGroups
|
使用 AdGroupService
|
转变 AdGroups
|
使用 AdGroup.ad_rotation_mode
|
转变 AdGroups
支持 |
Google Ads 已弃用 SHOPPING_SHOWCASE_AD ,并使用 ShoppingSmartAd 表示 SHOPPING_GOAL_OPTIMIZED_AD 功能
|
转变 AdGroups
|
在 Google Ads 出价策略类型中,只能在Campaign 一级设置,因此无法在AdGroup 一级覆盖,但您可以在AdGroup 一级替换出价金额。如需了解详情,请参阅出价指南。 |
转变 AdGroups
|
在 Google Ads 中,AdGroup.contentBidCriterionTypeGroup 由 AdGroup.display_custom_bid_dimension 表示
|
转变 AdGroups
|
使用 AdGroup.url_custom_parameters
|
转变 AdGroups
|
ExplorerAutoOptimizerSetting 和 TargetingSetting 对象不是由 AdGroup.settings 构成,而是由 Google Ads 中不同的字段 AdGroup.explorer_auto_optimizer_setting 和 AdGroup.targeting_setting 表示。
|
转变 AdGroups
支持升级版网址( |
参考 AdGroup.tracking_url_template 和升级版网址指南
|
转变 AdParams
|
使用 AdParameterService
|
获取和更新 CallOnlyAd
|
使用 Ad.call_only_ad
|
获取和更新 ExpandedTextAd
|
使用 Ad.expanded_text_ad
|
获取和更新 MultiAssetResponsiveDisplayAd
|
MultiAssetResponsiveDisplayAd 在 Google Ads 中以 Ad.responsive_display_ad 表示
|
获取和更新 ResponsiveDisplayAd
|
在 Google Ads 中,ResponsiveDisplayAd 由 Ad.legacy_responsive_display_ad 表示。
|
获取和更新 ResponsiveSearchAd
|
使用 Ad.responsive_search_ad
|
获取和更新 UniversalAppAd
|
UniversalAppAd 在 Google Ads 中由 Ad.app_ad 表示,属于应用广告系列
|
转变 Assets
|
使用 AssetService
|
转变 ImageAssets
|
使用 ImageAsset
|
转变 MediaBundleAssets
|
使用 MediaBundleAsset
|
转变 YouTubeVideoAssets
|
使用 YouTubeVideoAsset
|
创建 Audio
|
使用 MediaFile.audio
|
创建 Image
|
使用 MediaFile.image
|
创建 MediaBundle
|
使用 MediaFile.media_bundle
|
创建 Video
|
使用 MediaFile.video
|
条件
如需详细了解每个定位条件,请参阅Criteria
迁移指南。
受众群体
批处理作业
创建 BatchJob
|
使用 BatchJobService
|
获取 BatchJob 的状态
|
使用 BatchJob.status
|
获取 BatchJob 的状态
进度统计信息 |
使用 BatchJob.metadata
|
向 BatchJob 添加操作
UploadUrl |
使用 AddBatchJobOperations 方法
|
获取 BatchJob 的状态
下载网址 |
使用 ListBatchJobResults 方法
|
出价
如需创建或更新组合(共享)出价策略,请使用BiddingStrategyService
。如需创建或更新标准(非共享)出价策略,请使用 CampaignService
,并直接在 Campaign
对象上设置该策略。您可以通过将 Campaign.bidding_strategy
与共享出价策略 resource_name
配合使用来为广告系列设置共享出价策略。
结算
转变 BudgetOrder
支持结算帐号 ID、开始日期和结束日期字段 |
在 BillingSetupService 中使用 BillingSetup
|
转变 BudgetOrder
支持采购订单编号、支出限额和调整项 |
对于 转变,请参阅 AccountBudgetProposalService 中的 AccountBudget ;对于读取,请参阅 AccountBudgetService 中的 AccountBudget |
阅读 BillingAccounts
|
使用 PaymentsAccountService.ListPaymentsAccounts
|
广告系列
转变 Budgets
|
使用 CampaignBudget.MutateCampaignBudgets
|
转变 Campaign
|
使用 CampaignService
|
转变 Campaign
|
使用 Campaign.ad_serving_optimization_status
|
转变 Campaign
支持 |
使用 AdvertisingChannelSubTypeEnum
|
转变 Campaign
支持 |
使用 AdvertisingChannelTypeEnum
|
转变 Campaign
BiddingStrategyConfiguration |
使用 Campaign.campaign_bidding_strategy
|
转变 Campaign
预算 |
使用 Campaign.campaign_budget
|
转变 Campaign
支持 |
在 Google Ads 中,系统会为广告系列设置分配各自的字段,而不是编译到单个“设置”字段中。有关示例,请参阅 Campaign.real_time_bidding_setting
|
转变 Campaign
频次上限 |
使用 Campaign.frequency_caps
|
转变 Campaign
支持 |
使用 Campaign.NetworkSettings
|
转变 Campaign
SelectiveOptimized |
使用 Campaign.selective_optimization
|
转变 Campaign
UniversalAppCampaignInfo |
使用 Campaign.app_campaign_setting
|
转变 Campaign
升级版网址: |
使用 Campaign.tracking_url_template
|
转变 Campaign
VanityPharma |
使用 Campaign.vanity_pharma
|
转变 Campaign 标签关联
文本标签 |
使用 Campaign.labels
|
转变 CampaignLabel
|
使用 CampaignLabelService
|
转变 CampaignSharedSet
支持 |
使用 CampaignSharedSetService
|
更改历史记录
获取 CustomerChangeData
检索 |
使用 change_status 资源
|
常量
AgeRangeCriterion
|
在 Google Ads 中,这些条件常量是在 AgeRangeType 枚举
|
CarrierConstantCriterion
|
使用 CarrierConstantService
|
GenderCriterion
|
在 Google Ads 中,这些条件常量是在 GenderType 枚举
|
LanguageCriterion
|
使用 LanguageConstantService
|
MobileAppCategoryCriterion
|
使用 MobileAppCategoryConstantService
|
MobileDeviceCriterion
|
使用 MobileDeviceConstantService
|
OperatingSystemVersionCriterion
|
使用 OperatingSystemVersionConstantService
|
ProductBiddingCategoryData
|
使用 ProductBiddingCategoryConstantService
|
UserInterestCriterion
|
使用 UserInterestService
|
VerticalCriterion
|
使用 TopicConstantService
|
LocationCriterion
检索 |
使用 GeoTargetConstantService
|
转化情况
实验
获取 DraftAsyncError
通过提升 |
使用 CampaignDraftService.ListCampaignDraftAsyncErrors
|
转变 Draft
|
使用 CampaignDraftService
|
转变 Draft
归档 |
使用 CampaignDraftStatus.removed
|
转变 Draft
推广 |
使用 CampaignDraftService
|
获取 TrialAsyncError
创建和提升 |
使用 CampaignExperimentService
|
转变 Trial
|
使用 CampaignExperimentService
|
获取 Trial
支持常见的 |
使用 CampaignExperimentService
|
转变 Trial
支持宣传 |
使用 CampaignExperimentService
|
转变 Trial
支持升级 |
使用 CampaignExperimentService
|
Feed
规划
获取 TargetingIdea
支持请求类型 |
使用 KeywordPlanIdeaService.GenerateKeywordIdeas
|
获取 TargetingIdea
支持请求类型 |
使用 KeywordPlanService.GenerateHistoricalMetrics
|
获取 CampaignEstimate
|
TrafficEstimatorService 已拆分为多个不同的服务,请参阅生成预测指标指南了解详情。 |
报告
如需详细了解如何迁移个别报告,请参阅迁移报告字段指南。
获取 ReportDefinition
|
Google Ads 中没有针对 ReportDefition 的直接等同项,因为报告是基于具体的资源(而不是预定义的报告)。您可以使用 GoogleAdsFieldService 以编程方式获取有关报告资源的信息。请使用迁移报告字段指南,确定 AdWords 报告字段的等效报告资源和字段。
|
已弃用的功能
下面列出了一些不会迁移到 Google Ads API 的 AdWords API 功能。
Ads
转变 DeprecatedAd
|
DeprecatedAd 不是真正的广告类型。在 AdWords 中,您可以通过它访问已弃用类型的旧广告的数据。从 Google Ads API 中检索时,此类广告的 Ad.type 将为 UNKNOWN 。
|
转变 DynamicSearchAd
|
AdWords 已弃用 DynamicSearchAd ,取而代之的是 ExpandedDynamicSearchAd 。在 Google Ads 中,可使用 Ad.expanded_dynamic_search_ad 字段读取有关加大型动态搜索广告的信息。 |
转变 RichMediaAd
|
此功能不会迁移到 Google Ads |
转变 ShowcaseAd
|
此功能不会迁移到 Google Ads |
转变 TemplateAd
|
Google Ads 中不存在 TemplateAd ,但 DisplayUploadAd 支持部分广告格式
|
转变 TemplateAd
|
此功能不会迁移到 Google Ads |
转变 ThirdPartyRedirectAd
|
此功能不会迁移到 Google Ads |
转变 ThirdPartyRedirectAd
|
此功能不会迁移到 Google Ads |
获取和更新 ThirdPartyRedirectAd
|
此功能不会迁移到 Google Ads |
获取和更新 ShowcaseAd
|
此功能不会迁移到 Google Ads |
出价
转变 CampaignBidModifier
支持 |
此功能不会迁移到 Google Ads |
广告系列
转变 Campaign
ConversionOptimizerEligability |
此功能不会迁移到 Google Ads |
转变 CampaignGroupPerformanceTarget
|
此功能不会迁移到 Google Ads |
转变 CampaignGroup
|
此功能不会迁移到 Google Ads |
转化情况
转变 AppConversion
支持应用下载转化的应用回传网址 |
此功能不会迁移到 Google Ads |