Google 広告クエリビルダーは、Google 広告クエリ言語（GAQL）を使用してクエリをインタラクティブに作成し、検証するのに役立つように設計されたインタラクティブ ツールです。GAQL の初心者でも経験豊富なユーザーでも、クエリビルダーを使用すると、Google Ads API から必要なデータを正確に取得するプロセスを簡素化できます。
利点
- 使いやすさ: 特定の構文や使用可能なフィールドを熟知していなくても、GAQL クエリの作成プロセスを簡素化します。
- 検出可能性: Google Ads API データモデル内の使用可能なリソース、フィールド、セグメント、指標を探索して見つけるのに役立ちます。
- エラーの削減: 構造化されたインターフェースと有効なオプションのプルダウン メニューを提供することで、構文エラーやタイプミスを防ぎ、生成されたクエリが有効であることを保証します。
- クエリの作成を高速化: クエリ文字列の生成を自動化することで、開発プロセスを高速化します。
- 検証: このツールは API Explorer と Query Validator にリンクされており、実行前に API ルールに対してクエリをチェックします。
仕組み
Google 広告クエリビルダーは、GAQL クエリを視覚的に組み立てるための使いやすいインターフェースを提供します。基本的なワークフローは次のとおりです。
- リソースを選択する: クエリを実行するバージョンの [リファレンス] タブで、メインリソースを選択します。このリソースは
FROM句にあります。リソースは、campaign、ad_group、keyword_viewなどの Google 広告内のエンティティを表します。ビルダーには、使用可能なすべてのリソースが一覧表示されます。 - フィールドを選択する: リソースを選択すると、そのリソースと、そのリソースに関連付けられた（暗黙的に結合可能な）リソースに関連する属性、セグメント、指標など、選択可能なすべてのフィールドが表示されます。チェックボックスをオンにして、
SELECT句にフィールドを含めることができます。選択を行うと、ツールは対応する GAQL クエリ文字列を動的に生成し、エラーを表示して、互換性のないフィールドの組み合わせを除外します。 - フィルタを適用する:
WHERE句の条件を追加して、結果をフィルタできます。ビルダーを使用すると、フィールド、演算子、値を簡単に選択でき、構文が正しいことを確認できます。 - 結果の順序:
ORDER BY句を使用して並べ替え順序を指定します。 - 上限を設定する:
LIMIT句を追加して、返される結果の数を制御します。 - 検証: このツールは、有効なフィールドの組み合わせを自動的に選択するだけでなく、API Explorer へのリンクも提供します。これにより、アカウント データに対してクエリをテストできます。[クエリ バリデータ]（ページへのリンク）では、手動で作成した GAQL クエリを貼り付けて確認することもできます。
- エクスポート: クエリに問題がなければ、テスト済みの構文的に正しい GAQL 文字列をコピーして、
GoogleAdsService.SearchまたはSearchStreamクライアント リクエストに貼り付けます。
ビルダーは、選択したフィールド、セグメント、指標が互換性があり、Google Ads API の基盤となるメタデータを参照して、1 つのクエリで一緒に使用できることを確認します。
始める
クエリビルダーにアクセスするには、次の 2 つの方法があります。レポート リファレンス ドキュメントの特定のページから確認する方法と、クエリビルダーの概要ページから確認する方法があります。
レポート作成のリファレンス ドキュメントから
- レポートの参照ドキュメントから始め、すべてのリソースのリストで開始する特定のリソースを選択します。または、左側のナビゲーション ペインからリソースに直接移動します。
- [クエリの作成をサポート] をクリックします。これにより、その特定のリソースのクエリビルダーが表示されます。
[クエリビルダー] の概要ページから
レポート作成のリファレンス ドキュメントの [クエリビルダー] セクションに移動し、調べるリソースを選択します。
他のツールとの統合
クエリビルダーは、Google Ads API デベロッパー ツールキットの他のツールと統合されています。クエリビルダーで作成したクエリを取得して、API Explorer でテストしたり、クエリ バリデータで検証したりできます。
API Explorer
クエリを作成したら、[API Explorer で試す] をクリックして、API Explorer でクエリを開きます。クエリはリクエスト本文に自動的に入力されます。その後、アカウントデータに対してクエリを実行して、クエリをテストできます。このツールの詳細については、API Explorer をご覧ください。
クエリ検証ツール
[クエリを入力または編集] をクリックすると、クエリ バリデータが開きます。クエリ バリデータを使用して、クエリの構文を検証します。クエリビルダーで完全に作成されたクエリは、すでに正しい構文になっていますが、クエリを実行するリソースに精通している場合は、クエリ バリデーターを使用すると、クエリをすばやく入力して有効性を確認できます。このツールの詳細については、クエリ バリデータをご覧ください。