Google Ads 查詢建立工具是互動式工具，可協助您使用 Google Ads 查詢語言 (GAQL) 建構及驗證查詢。無論您是 GAQL 新手還是經驗豐富的使用者，查詢建立工具都能簡化從 Google Ads API 擷取所需確切資料的程序。
優點
- 簡單易用：簡化編寫 GAQL 查詢的程序，不必熟悉特定語法和可用欄位。
- 可探索性：協助探索及尋找 Google Ads API 資料模型中的可用資源、欄位、區隔和指標。
- 減少錯誤：提供結構化介面和有效選項的下拉式選單，有助於避免語法錯誤和錯別字，確保產生的查詢有效。
- 加快查詢建構速度：自動生成查詢字串，加快開發程序。
- 驗證：這項工具會連結至 API Explorer 和查詢驗證工具，在執行查詢前，先根據 API 規則檢查查詢。
運作方式
Google Ads 查詢建立工具提供容易使用的介面，可透過視覺化方式組合 GAQL 查詢。基本工作流程如下：
- 選取資源：首先，從要查詢版本的「Reference」分頁中選擇主要資源。這項資源會放在
FROM子句中。資源代表 Google Ads 中的實體，例如campaign、ad_group或keyword_view。建構工具會列出所有可用資源。 - 選擇欄位：選取資源後，工具會顯示所有可選取的欄位，包括與該資源及其歸因 (可隱含聯結) 資源相關的屬性、區隔和指標。您可以勾選方塊，在
SELECT子句中加入欄位。選取項目時，工具會動態產生對應的 GAQL 查詢字串、顯示任何錯誤，並篩除不相容的欄位組合。 - 套用篩選條件：新增
WHERE子句條件，篩選結果。建構工具可協助您選擇欄位、運算子和值，確保語法正確無誤。 - 排序結果：使用
ORDER BY子句指定排序順序。 - 設定限制：加入
LIMIT子句，控制傳回的結果數量。 - 驗證：這項工具會引導您使用有效的欄位組合，並連結至 API Explorer，方便您根據帳戶資料測試查詢。您也可以使用獨立的查詢驗證器，貼上並檢查手動編寫的 GAQL 查詢。
- 匯出：確認查詢無誤後，請將測試過且語法正確的 GAQL 字串複製並貼到
GoogleAdsService.Search或SearchStream用戶端要求中。
這個建構工具會參照 Google Ads API 的基礎中繼資料，確保所選欄位、區隔和指標相容，且可一起用於單一查詢。
開始使用
有兩種方式可以前往查詢建立工具：透過報表參考文件中的特定頁面，或從查詢建立工具總覽頁面探索。
從報表參考文件
從查詢建立工具總覽頁面
前往報表參考文件的「查詢建立工具」部分，然後選取要探索的資源。
與其他工具整合
查詢建立工具已整合至 Google Ads API 開發人員工具包的其他工具。您可以在 API 探索工具中測試查詢建立工具建構的查詢，或使用查詢驗證工具驗證查詢。
API Explorer
建構查詢後，按一下「在 API Explorer 中試用」，即可在 API Explorer 中開啟查詢。系統會自動在要求主體中填入查詢，然後您就可以針對帳戶資料執行查詢，藉此測試查詢。如要進一步瞭解這項工具，請參閱「API Explorer」。
查詢驗證工具
點選「輸入或編輯查詢」後，系統會開啟查詢驗證工具。使用查詢驗證工具驗證查詢語法。完全透過查詢建立工具建立的查詢語法正確無誤，但如果您熟悉要查詢的資源，查詢驗證工具可讓您快速輸入查詢並檢查其有效性。如要進一步瞭解該工具，請參閱「查詢驗證器」。