報表

報表會提供帳戶中所有不同資源的相關資訊。 您可以擷取廣告活動、廣告群組及其統計資料的相關資訊 以及帳戶紀錄等等報告基礎架構採用 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敬上 瞭解所有可能設定的說明文件。