報表

報表會提供帳戶中所有不同資源的相關資訊。您可以擷取廣告活動、廣告群組及其統計資料的相關資訊，以及帳戶變更記錄等。報表基礎架構由 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 說明文件。