报告

报告会提供有关您账号中所有不同资源的信息。 您可以获取广告系列、广告组及其统计信息的相关信息 历史记录等信息报告基础架构以 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 用于提取数据。如果您遇到以下情况， 您计划以编程方式处理数据，而且某些字段可能 如果它们无法转换为 Flat 格式，则可采用 search 格式 表示。
。

报告示例

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 文档。