Google 広告クエリビルダーは、Google 広告クエリ言語（GAQL）を使用してクエリを作成し、検証するのに役立つインタラクティブなツールです。GAQL の初心者でも経験豊富なユーザーでも、クエリビルダーを使用すると、Google Ads API から必要なデータを正確に取得するプロセスを簡素化できます。
利点
- 使いやすさ: 特定の構文や使用可能なフィールドを熟知していなくても、GAQL クエリの作成プロセスを簡素化できます。
- 検出可能性: Google Ads API データモデル内の利用可能なリソース、フィールド、セグメント、指標を探索して見つけるのに役立ちます。
- エラーの削減: 構造化されたインターフェースと有効なオプションのプルダウン メニューを提供することで、構文エラーや入力ミスを防ぎ、生成されたクエリが有効であることを確認できます。
- クエリ作成の高速化: クエリ文字列の生成を自動化することで、開発プロセスを高速化します。
- 検証: このツールは API Explorer とクエリ検証ツールにリンクされており、実行前に 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 をご覧ください。
クエリ検証ツール
[クエリを入力または編集] をクリックすると、クエリ バリデータが開きます。クエリ検証ツールを使用して、クエリの構文を検証します。クエリビルダーで完全に構築されたクエリは、すでに正しい構文になっていますが、クエリ対象のリソースに精通している場合は、クエリ検証ツールを使用すると、クエリを入力してその有効性をすばやく確認できます。このツールの詳細については、クエリ検証ツールをご覧ください。