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) 並依正確順序排列。 - 欄位有效性：檢查所有指定的欄位 (資源、區隔、指標) 是否存在，以及拼字是否正確。
- 資源相容性：驗證
SELECT子句中選取的欄位是否與FROM子句中指定的主要資源相容。 - 區隔和指標相容性：確保在相同查詢中一起使用的區隔和指標彼此相容，且與
FROM子句中的資源相容。 - 子句需求：驗證規則，例如
WHERE或ORDER BY子句中使用的特定欄位也必須出現在SELECT子句中。 - 運算子用法：檢查
WHERE子句條件中的運算子是否正確使用。
如果查詢有效，工具會確認。如果發現問題，系統會提供錯誤訊息，協助您找出問題所在，有時還會提供修正建議，例如特定指標的相容資源。
開始使用
如要使用 Google Ads 查詢驗證工具，請按照下列步驟操作：
- 前往「查詢驗證器」。
- 輸入 GAQL 查詢。
- 按一下「驗證查詢」按鈕。
- 查看查詢驗證器小工具下方顯示的驗證訊息。 成功訊息表示查詢有效。否則，系統會顯示說明問題的錯誤訊息。錯誤訊息會引導您修正查詢。舉例來說，如果查詢的指標或區隔與資源不相容，欄位不相容錯誤可能會列出相容的替代資源。
如要深入瞭解 GAQL 概念和驗證，請參閱 GAQL 影片指南。