Google Ads API Explorer は、ブラウザから直接 API リクエストを作成して送信できるインタラクティブな実行環境です。リファレンス ドキュメントに組み込まれているこのツールは、OAuth 2.0 認証と JSON ペイロード形式の複雑な処理を自動的に行うため、コードを 1 行も記述することなく、特定のサービスとメソッドをテストできます。
利点
- ノーコード テスト実行: ローカル開発環境を設定せずに、ドキュメントから直接ライブ API 呼び出し（読み取りと書き込みの両方）を実行します。
- プロトコル検出: HTTP リクエストとレスポンスの正確な構造を確認して、API の動作を理解します。
- 低摩擦のプロトタイピング: アプリケーションにロジックを実装する直前に、エンドポイントの動作を確認し、未加工の API レスポンスを検査します。
- 簡素化された認証: このツールは OAuth 2.0 フローを自動的に管理するため、認証情報マネージャーではなく API リクエストに集中できます。
始める
- ドキュメントに移動する: リファレンス ドキュメントに移動し、テストするサービスとメソッド（
GoogleAdsService/Searchなど）を選択します。 - エクスプローラを開く: ページの右側にある [このメソッドを試す] パネルを探します。
- リクエストを構成します。
customerIdなどの必要なリクエスト パラメータを入力し、[Headers] を開いて、login-customer-idなどのオプションの HTTP ヘッダーを指定します（マネージャー アカウントを介してアカウントにアクセスする場合にのみ必要）。デベロッパー トークン（developer-token）は 2026 年 9 月 9 日にサポートが終了し、API サーバーでは無視されます。ただし、フォームで入力を求められた場合は、値を入力できます。- メソッドにペイロードが必要な場合（
searchオペレーションやmutateオペレーションなど）は、インタラクティブな JSON エディタを使用してリクエスト本文を定義します。
- 実行: [実行] をクリックしてリクエストを送信します。このツールには、完全な HTTP リクエストと API からのライブ JSON レスポンスが表示されます。
主な機能
- ライブ実行: 本番環境アカウントまたはテスト アカウントに対してリアルタイムの
searchオペレーションとmutateオペレーションを実行します。 - JSON ペイロードのフォーマット: リクエスト用の複雑な JSON オブジェクトをインタラクティブに作成します。このツールでは、必須フィールドと有効なスキーマ構造がハイライト表示されます。
- フィールド マスク:
update_maskロジックをテストして、部分的なリソース更新が実際にどのように動作するかを確認します。 - エラーの検査: 未加工のレスポンスで詳細なエラー メッセージとコード（
QUERY_ERRORやAUTHENTICATION_ERRORなど）を表示して、デバッグを迅速に行うことができます。 - コードのエクスポート: API Explorer の展開ビューから、
curlコマンド、未加工の HTTP リクエスト、JavaScript のサンプルコードをエクスポートします。
サンプル ユースケース
- アカウント設定を監査する:
customerリソースに対してGoogleAdsService/Searchリクエストを実行して、アカウント レベルの構成またはメタデータを迅速に取得します。 - ミューテーションをテストする: コードを本番環境にデプロイする前に、キャンペーンの作成または予算の更新が成功したことを確認します。
- GAQL のデバッグ: エクスプローラを使用して Google 広告クエリ言語（GAQL）文字列を実行し、返された JSON 構造がアプリケーションの想定と一致していることを確認します。
- プロトコルの検証: 特定の API バージョンに必要な正確な HTTP ヘッダーと JSON ネストを検査します。