Google Ads 查詢驗證工具是一項互動式工具，可協助開發人員建構及驗證 Google Ads 查詢語言 (GAQL) 查詢，再整合至應用程式。您只要輸入 GAQL 查詢字串，就能立即收到有效性意見回饋，在開發初期找出語法錯誤、欄位不相容和其他問題。
優點
- 預防錯誤：在無效查詢整合至應用程式前，及早找出問題，減少執行階段錯誤和 API 呼叫失敗。
- 加快開發速度：快速測試及偵錯 GAQL 陳述式，不必耗費完整 API 要求和回應週期的資源。
- 瞭解 GAQL 限制：協助開發人員瞭解複雜的規則，包括哪些欄位相容，以及資源之間的關聯。
- 偵錯查詢：查詢無效時，提供特定錯誤訊息，通常比一般 API 錯誤更詳細，有時還會建議有效的替代方案。
- 資源效率：避免因查詢失敗而產生不必要的 API 呼叫。
運作方式
查詢驗證工具會根據 Google Ads API 的結構定義，以及 Google Ads 查詢語言中定義的規則，剖析 GAQL 查詢。它會使用中繼資料 (大部分可從 GoogleAdsFieldService 存取) 執行檢查，包括：
- 語法和結構：確保查詢遵循正確的 GAQL 文法，包括正確使用和排序
SELECT、FROM、WHERE、ORDER BY、LIMIT和PARAMETERS等子句。 - 欄位有效性：檢查所有指定欄位 (資源、區隔、指標) 是否存在，且拼寫正確。
- 資源相容性：驗證
SELECT子句中選取的欄位是否與FROM子句中指定的主要資源相容。 - 區隔和指標相容性：確保在同一查詢中搭配使用的區隔和指標彼此相容，且與
FROM子句中的資源相容。 - 子句規定：驗證規則，例如
ORDER BY子句中使用的欄位，以及WHERE子句中使用的特定欄位 (例如區隔)，也必須出現在SELECT子句中。 - 運算子使用方式：檢查
WHERE子句條件中的運算子是否正確使用。
如果查詢有效，工具會確認。如果發現問題，系統會提供錯誤訊息，協助您找出問題所在，有時也會提供修正建議，例如特定指標的相容資源。
開始使用
如何使用 Google Ads 查詢驗證工具：
- 前往查詢驗證工具。
- 輸入 GAQL 查詢。
- 按一下「驗證查詢」按鈕。
- 查看查詢驗證工具小工具下方顯示的驗證訊息。系統會顯示成功訊息，指出查詢有效。否則，系統會顯示錯誤訊息，說明問題。錯誤訊息會引導您修正查詢。舉例來說，欄位不相容錯誤可能會列出與您嘗試查詢的指標或區隔相容的額外資源。
如要進一步瞭解 GAQL 概念和語法，請參閱 Google Ads 查詢語言指南。如要以互動方式建立及測試 GAQL 查詢，您也可以使用查詢建立工具和 API Explorer。