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 的基礎中繼資料，確保所選欄位、區隔和指標相容，且可在單一查詢中一併使用。
開始使用
前往查詢建立工具的方法有兩種：透過報表參考文件的特定頁面，或從查詢建立工具總覽頁面探索。
報表參考文件
- 請先參閱報表參考文件，然後在所有資源清單中選擇要開始使用的特定資源。或者，您也可以直接從左側導覽窗格前往資源。
- 按一下「Help me build a query」(協助我建立查詢)，系統會將您導向該特定資源的查詢建立工具。
從查詢建立工具總覽頁面
前往報表參考文件的「查詢建立工具」部分，選取要探索的資源。
與其他工具整合
查詢建立工具已與 Google Ads API 開發人員工具包中的其他工具整合。您可以在查詢建立工具中建立查詢，並在 API Explorer 中測試，或使用查詢驗證工具驗證。
API Explorer
建立查詢後，按一下「Try in API Explorer」(在 API Explorer 中試用)，即可在 API Explorer 中開啟查詢。查詢會自動填入要求主體，接著您就能對帳戶資料執行查詢，測試查詢結果。如要進一步瞭解這項工具，請參閱「APIs Explorer」。
查詢驗證工具
點選「輸入或編輯查詢」，查詢驗證工具就會開啟。使用查詢驗證工具驗證查詢語法。凡是完全透過查詢建立工具建立的查詢，語法都正確無誤，但如果您熟悉要查詢的資源，查詢驗證工具可讓您快速輸入查詢並檢查其有效性。如要進一步瞭解這項工具，請參閱「查詢驗證工具」。