Google Ads 查詢建立工具

Google Ads 查詢建立工具是互動式工具，可協助您使用 Google Ads 查詢語言 (GAQL) 互動式建構及驗證查詢。無論您是 GAQL 新手還是經驗豐富的使用者，查詢產生器都能簡化從 Google Ads API 擷取所需確切資料的程序。

優點

  • 易於使用：簡化編寫 GAQL 查詢的程序，不必熟悉特定語法和可用欄位。
  • 探索性：協助探索及尋找 Google Ads API 資料模型中的可用資源、欄位、區隔和指標。
  • 減少錯誤：提供結構化介面和有效選項的下拉式選單，有助於避免語法錯誤和錯別字，確保產生的查詢有效。
  • 加快查詢建構速度：自動產生查詢字串，加快開發程序。
  • 驗證：這項工具會連結至 API Explorer 和查詢驗證器，在執行查詢前，先根據 API 規則檢查查詢。

運作方式

Google Ads 查詢產生器提供簡單易用的介面，可讓您以視覺化方式組裝 GAQL 查詢。基本工作流程如下：

  1. 選取資源：首先，請從要查詢版本的「Reference」(參考) 分頁中選擇主要資源。這項資源將列於 FROM 條款中。資源代表 Google Ads 中的實體，例如 campaign、ad_group 或 keyword_view。建構工具會列出所有可用資源。
  2. 選擇欄位：選取資源後，工具會顯示所有可選取的欄位，包括與該資源及其歸因 (可隱含聯結) 資源相關的屬性、區隔和指標。您可以勾選方塊，在 SELECT 子句中加入欄位。選取項目時，工具會動態產生對應的 GAQL 查詢字串、顯示任何錯誤，並篩除不相容的欄位組合。
  3. 套用篩選器：您可以新增 WHERE 子句條件來篩選結果。製作工具可協助您選擇欄位、運算子和值，確保語法正確。
  4. 排序結果：使用 ORDER BY 子句指定排序順序。
  5. 設定限制：新增 LIMIT 子句，控制傳回的結果數量。
  6. 驗證：這項工具會引導您使用有效的欄位組合，並提供 API Explorer 的連結，方便您根據帳戶資料測試查詢。此外，您也可以使用獨立的 [查詢驗證工具](連結至頁面)，手動貼上並檢查撰寫的 GAQL 查詢。
  7. 匯出：確認查詢無誤後，請將經過測試且語法正確的 GAQL 字串複製並貼到 GoogleAdsService.Search 或 SearchStream 用戶端要求中。

建構工具會確保所選欄位、區隔和指標相容，且可一起用於單一查詢，並參照 Google Ads API 的基礎中繼資料。

開始使用

有兩種方式可以開啟查詢產生器。您可以前往報表參考文件中的特定頁面，也可以從查詢建立工具總覽頁面探索。

來自報表參考文件

  1. 請先參閱報表參考文件，然後從所有資源清單中選擇要使用的特定資源。或者，也可以直接從左側導覽窗格前往資源。
  2. 按一下「幫我建立查詢」，系統會將您帶往該特定資源的查詢產生器。

從查詢建立工具總覽頁面

前往報表參考文件的「查詢產生器」部分，然後選取要探索的資源。

與其他工具整合

查詢建構工具已整合至 Google Ads API 開發人員工具包的其他工具。您可以使用查詢建構工具建立查詢，然後在 API 探索工具中測試，或使用查詢驗證工具驗證。

API Explorer

建構查詢後，按一下「在 API Explorer 中試用」，即可在 API Explorer 中開啟查詢。查詢會自動填入要求主體，然後您可以對帳戶資料執行查詢，測試查詢。如要進一步瞭解這項工具，請參閱 API Explorer。

查詢驗證工具

按一下「輸入或編輯查詢」，系統會開啟查詢驗證工具。使用查詢驗證工具驗證查詢語法。完全透過查詢產生器建立的查詢，語法一律正確無誤。不過，如果您熟悉要查詢的資源，查詢驗證器可讓您快速輸入查詢並檢查其有效性。如要進一步瞭解該工具，請參閱「查詢驗證器」。