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。
查詢驗證工具
按一下「輸入或編輯查詢」，系統會開啟查詢驗證工具。使用查詢驗證工具驗證查詢語法。透過查詢建立工具完全建構的任何查詢，都會有正確的語法，但如果您熟悉要查詢的資源，查詢驗證工具可讓您快速輸入查詢並檢查其有效性。如要進一步瞭解該工具，請參閱「查詢驗證器」。