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

Google Ads API 中的工作流程更改

AdWords API 中的一些常规工作流程在 Google Ads API 中发生了变化。例如,搜索实体目前在转变时会改为使用单独的服务。

字段名称

在 AdWords API 中,不同实体的类似概念会对应不同的字段,例如 CampaignIdAdGroupId。在 Google Ads API 中,现在使用的是嵌套字段名称,例如 campaign.idad_group.id。您也可以进一步嵌套,例如 ad_group.campaign.id

服务用例

在 AdWords API 中,一个给定实体类型的所有操作都会使用同一个服务。比如,CampaignService 就用于执行 get(包括搜索和过滤)和 mutate 操作。

在 Google Ads API 中,搜索使用自己的服务 GoogleAdsService。如果您需要获取符合某些条件的实体列表,请始终使用此服务查找结果列表。与在 AdWords API 中一样,对此服务的调用仅填充响应中专门请求的字段。

在 Google Ads API 中的每个实体的特定服务上,仍然存在 get 请求。比如,您可以从 CampaignService 通过 get 操作获取广告系列信息。不过,此调用的目的与 AdWords API 中的同名调用不同。您不能在 get 请求中进行过滤,而只能获取指定实体的全部详情。您以标识符的形式将实体的资源名称传递出去,响应会包括已填写的每个字段,无需另行全部列出。

在 Google Ads API 中的特定实体的服务上,也有 mutate 请求。就像在 AdWords API 中一样,您可以让每项操作只影响一个实体,也可以在单个请求中传递多项操作。

报告

在 AdWords API 中,报告与其他服务是完全分开的。但在 Google Ads API 中,这种情况不复存在。通过使用 GoogleAdsService(同时用于搜索实体),然后在请求中仅添加统计信息字段即可生成报告。

AdWords API 报告与 Google Ads API 报告的其他主要区别如下:

  • AdWords API 中提供的是报告类型,而 Google Ads API 提供的是 campaign 等资源以及 keyword_view 等资源视图。
  • Google Ads API 中的报告不会返回纯文本或 XML,相反 GoogleAdsService.Search 方法会返回包含对象的 GoogleAdsRows。例如,当您检索 campaign.idcampaign.namemetrics.clicks 时,系统会返回一个 GoogleAdsRow,其中包含设置了 idname 字段的广告系列对象,以及设置了 clicks 字段的 metrics 对象。
  • 默认情况下,Google Ads API 会返回展示次数为零的行。该 API 不包含 includeZeroImpressions 参数。如果您要排除展示次数为零的行,请在 Google Ads 查询语言中使用 metrics.impressions > 0 等谓词。
  • GoogleAdsFieldService 类似于 AdWords API ReportDefinitionService,但不返回报告类型的元数据,而是返回资源和资源视图的元数据。
  • 如果比率字段(如每次转化费用)的分母值为零,则 AdWords API 会返回 0 值。在这种情况下,Google Ads API 返回的是 null 值,以匹配 Google Ads 界面中的行为。