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 概念和驗證，也可以參閱 GAQL 影片說明，或使用查詢建立工具和 APIs Explorer。