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