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