報表

您可以透過報表瞭解帳戶中各種資源。 您可以擷取廣告活動、廣告群組及其統計資料的相關資訊，以及帳戶的變更記錄等。報表基礎架構由 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 時，即使在查詢中已在 underscore_case 中指定傳回的欄位，系統仍會在 lowerCamelCase 中。舉例來說，如果查詢中的欄位是 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 說明文件，瞭解所有可能的設定。