报告

报告会提供有关您账号中所有不同资源的信息。您可以提取有关广告系列、广告组及其统计信息的信息，查看账号的更改记录等。报告基础架构由 Google Ads API 提供支持，并使用 GAQL 指定您要设置的字段、指标和条件。

举报与搜索

报告机制主要有两种。它们都接受相同类型的查询，主要区别在于返回结果的方式。

对于这两种情况，我们将使用以下查询：

SELECT
  campaign.id,
  campaign.status,
  metrics.clicks,
  metrics.impressions,
  customer.id
FROM campaign
WHERE
  metrics.impressions > 0

AdsApp.report()

这将返回搜索结果的扁平字典式表示法。您可以像使用字典一样访问字段，例如直接使用 row["campaign.id"] 和 row["metrics.impressions"]。使用此格式，您可以使用 exportToSheet() 方法直接将结果导出到电子表格。这不是 Google Ads API 返回结果的原生格式，因此在某些情况下，部分字段可能无法以此格式提供。如果是这种情况，您应改用 search。

AdsApp.search()

这将返回一个 GoogleAdsRow 对象列表，其中包含各种字段，每个字段都可能包含子字段。因此，您需要访问 row.campaign.id 和 row.metrics.impressions 才能提取数据。如果您打算以编程方式处理数据，这种方式通常更实用；如果某些字段无法转换为扁平表示法，则可能只能以 search 格式提供。

注意： 使用 AdsApp.search 时，返回的字段将采用 lowerCamelCase 格式，即使它们在查询中是采用 underscore_case 格式指定的。例如，如果查询中的字段为 campaign.start_date，则如需从行中提取结果，您需要使用 campaign.startDate。

报告示例

let report = AdsApp.report(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

let rows = report.rows();
while (rows.hasNext()) {
    let row = rows.next();
    let query = row["search_term_view.search_term"];
    let impressions = row["metrics.impressions"];
}

如需详细了解如何使用此视图，请参阅 AdsApp.report 文档。

搜索示例

let search = AdsApp.search(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

while (search.hasNext()) {
    let row = search.next();
    let query = row.searchTermView.searchTerm;
    let impressions = row.metrics.impressions;
}

如需了解所有可能的设置，请参阅完整的 Adsapp.search 文档。