Google 広告クエリ検証ツールは、デベロッパーが Google 広告クエリ言語（GAQL）クエリを作成して検証し、アプリケーションに統合できるように設計されたインタラクティブなツールです。GAQL クエリ文字列を入力すると、その有効性に関するフィードバックがすぐに返されるため、開発プロセスの早い段階で構文エラー、フィールドの非互換性、その他の問題を検出できます。
利点
- エラーの防止: 無効なクエリをアプリケーションに統合する前に早期にキャッチし、ランタイム エラーと API 呼び出しの失敗を減らします。
- 開発の迅速化: API リクエストとレスポンスのサイクル全体を繰り返すことなく、GAQL ステートメントのテストとデバッグを迅速に行うことができます。
- GAQL の制約を理解する: どのフィールドに互換性があるか、リソースがどのように関連しているかなど、複雑なルールを理解するのに役立ちます。
- クエリのデバッグ: クエリが無効な場合に、特定のエラー メッセージを提供します。多くの場合、一般的な API エラーよりも詳細なメッセージが表示され、有効な代替案が提示されることもあります。
- リソースの効率性: 失敗する運命にあるクエリによる不要な API 呼び出しを回避します。
仕組み
クエリ検証ツールは、Google Ads API のスキーマと Google 広告クエリ言語で定義されたルールに照らして GAQL クエリを解析します。メタデータ（その多くは GoogleAdsFieldService からアクセス可能）を使用して、次のようなチェックを行います。
- 構文と構造: クエリが正しい GAQL 文法に従っていることを確認します。これには、
SELECT、FROM、WHERE、ORDER BY、LIMIT、PARAMETERSなどの句の適切な使用と順序が含まれます。 - フィールドの有効性: 指定されたすべてのフィールド（リソース、セグメント、指標）が存在し、スペルが正しいかどうかを確認します。
- リソースの互換性:
SELECT句で選択されたフィールドが、FROM句で指定されたプライマリ リソースと互換性があることを確認します。 - セグメントと指標の互換性: 同じクエリで一緒に使用されるセグメントと指標が、互いに互換性があり、
FROM句のリソースとも互換性があることを確認します。 - 句の要件:
ORDER BY句で使用されるフィールドと、WHERE句で使用される特定のフィールド（セグメントなど）がSELECT句にも存在する必要があるという要件などのルールを検証します。 - 演算子の使用:
WHERE句の条件内で演算子が正しく使用されているかどうかを確認します。
クエリが有効な場合、ツールはそれを確認します。問題が見つかった場合は、問題を特定するのに役立つエラー メッセージが表示されます。また、特定の指標に対応するリソースなど、修正の提案が表示されることもあります。
始める
Google 広告クエリ検証ツールを使用するには:
- クエリ検証ツールに移動します。
- GAQL クエリを入力します。
- [クエリを検証] ボタンをクリックします。
- [クエリ検証ツール] ウィジェットの下に表示される検証メッセージを確認します。クエリが有効であることを示す成功メッセージが表示されます。それ以外の場合は、問題を説明するエラー メッセージが表示されます。エラー メッセージは、クエリを修正するためのガイドとなります。たとえば、フィールドの互換性エラーでは、クエリしようとしている指標またはセグメントと互換性のある代替リソースが一覧表示されることがあります。
GAQL のコンセプトと構文の詳細については、Google 広告クエリ言語ガイドをご覧ください。GAQL クエリをインタラクティブに作成してテストするには、クエリビルダーと API Explorer を使用することもできます。