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

API 结构

资源

Google Ads API 由多个资源和服务组成。一个资源表示一个 Google Ads 实体。

资源示例:

每个资源都由一个 resource_name 字符串进行了唯一标识,该字符串会将相应资源及其父项连接到路径中。例如,广告系列资源名称的格式如下:

customers/customer_id/campaigns/campaign_id

因此,在客户 ID 为 1234567 的 Google Ads 帐号中,对于 ID 为 987654 的广告系列,resource_name 将是:

customers/1234567/campaigns/987654

服务

服务用于检索和处理 Google Ads 实体,它具有以下三种类型:

修改 (mutate) 对象

此类服务通过 mutate 请求来修改关联资源类型的实例。此外,它们还提供用于检索单个资源实例的 get 请求,这对于分析资源的结构非常有用。

服务示例:

获取对象和效果统计信息

GoogleAdsService 是一项统一的服务,用于同时检索对象和效果统计信息。

所有针对 GoogleAdsService 的搜索请求都需要一个查询,以指定要查询的资源、要检索的资源属性和效果指标、用于过滤请求的谓词,以及用于进一步细分效果统计信息的细分。如需详细了解查询的格式,请参阅 Google Ads 查询语言指南

检索元数据

GoogleAdsFieldService 用于检索有关 Google Ads API 中资源的元数据,例如资源的可用属性及其数据类型。

此服务提供了构建 GoogleAdsService 查询所需的信息。为方便起见,字段参考文档中也提供了 GoogleAdsFieldService 返回的信息。