GoogleAdsService 是统一的对象
Google Ads API 的获取和报告服务。该服务具有可实现以下目的的方法：
- 检索对象的特定属性。
- 根据日期范围检索对象的效果指标。
- 根据对象的属性对对象进行排序。
- 使用条件来指明要在响应中返回的对象。
- 限制返回的对象数量。
GoogleAdsService 可以返回以下结果：
两种方法：
GoogleAdsService.SearchStream在单个流式响应中返回所有行，这对于 大型（超过 10,000 行）结果集。这种方式可能更合适 如果批处理应用希望以尽可能快的速度下载GoogleAdsService.Search拆分 并放入便于管理的搜索结果页面。可能还有更多 如果您的交互式应用在 。
详细了解分页与流式。
发出请求
搜索方法要求使用
SearchGoogleAdsRequest，其中包含
以下属性之一：
customer_id- Google Ads 查询语言
query，用于指明要查询的资源、属性 要检索的细分和指标，以及用于限制 返回哪些对象 - （仅限
GoogleAdsService.Search）Apage_size来指示在以下情况下，单个响应中要返回的对象数量： 使用分页。 - （仅限
GoogleAdsService.Search） 可选的page_token，用于在使用 分页。
有关 Google Ads 查询语言的详情，请参阅 Google Ads 查询语言 指南。
处理响应
GoogleAdsService 会返回
GoogleAdsRow 对象。
每个 GoogleAdsRow 代表一个查询返回的对象，由
一组属性，这些属性依据
SELECT 子句。SELECT 子句中未包含的属性不
在响应中的 GoogleAdsRow 对象上填充。
例如，虽然 ad_group_criterion 具有 status 属性，但
该行的 ad_group_criterion 属性的 status 字段未填充到
对 SELECT 子句不包含的查询的响应
ad_group_criterion.status。同样，该行的 campaign 属性为
如果 SELECT 子句不包含
campaign 资源。
每个GoogleAdsRow可以有另一行中的不同属性和指标
同一结果集中；因此这些行应被视为对象
表格的固定行。
UNKNOWN 枚举类型
在UNKNOWN
该 API 版本。这些资源可能是通过
例如 Google Ads 界面您可以在资源具有
UNKNOWN 类型，但您无法通过该 API 更改资源。一个
例如，在界面中引入新的广告系列或广告
您查询的 API 版本不支持此功能。
请注意以下几点：
- 类型为
UNKNOWN的资源以后可支持，或保持为UNKNOWN。 - 类型为
UNKNOWN的新对象随时可能出现。这些对象是 向后兼容，因为枚举值已经可用。资源 会随此次更改推出，以便您拥有 以便准确了解账号情况出现UNKNOWN资源的原因可能是 出现新活动时， 已不再受支持。 UNKNOWN资源可以附加有 可查询。UNKNOWN资源通常在 Google Ads 界面中完全可见。UNKNOWN资源通常无法更改。
细分
对于以下字段的每个组合，响应都包含一个 GoogleAdsRow：
以下：
FROM子句中指定的主要资源的实例- 每个所选
segment字段的值
例如，对于一个选择 FROM campaign 且包含
SELECT 子句中的 segments.ad_network_type 和 segments.date 将
以下项的每种组合各占一行：
campaignsegments.ad_network_typesegments.date
结果按主要资源的每个实例进行隐式细分，而不是按 所选各个字段的值例如，
SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS
则每个 campaign 会占一行，而不是
campaign.status 字段。