Google Ads API Explorer は、ブラウザから直接ライブ API リクエストを作成して送信できるインタラクティブな実行環境です。リファレンス ドキュメントに埋め込まれており、OAuth 2.0 認証と JSON ペイロードのフォーマットの複雑さを処理するため、1 行のコードを記述することなく特定のサービスとメソッドをテストできます。
利点
- コードなしのテスト: ローカル開発環境を設定せずに、ドキュメントから直接ライブ API 呼び出し（読み取りと書き込みの両方）を実行できます。
- プロトコルの検出: HTTP リクエストとレスポンスの正確な構造を確認して、API の動作を把握できます。
- プロトタイピングの簡素化: アプリケーションにロジックを実装する直前に、エンドポイントの動作を確認し、生の API レスポンスを検査できます。
- 認証の簡素化: このツールは OAuth 2.0 フローを自動的に管理するため、認証情報の管理ではなく API リクエストに集中できます。
始める
- ドキュメントに移動する: リファレンス
ドキュメントに移動し、テストするサービスとメソッド（
GoogleAdsService/Searchなど）を選択します。 - Explorer を開く: ページの右側にある [このメソッドを試す] パネルを探します。
- リクエストを構成する:
- 必要な [リクエスト パラメータ]（
customerIdなど）を入力し、 [ヘッダー] を展開して、省略可能な HTTP ヘッダー（login-customer-idなど。 マネージャー アカウント経由でアカウントにアクセスする場合にのみ必要）を指定します。デベロッパー トークン （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` リクエストを実行して、アカウント レベルの構成
またはメタデータをすばやく取得します。
GoogleAdsService/Searchcustomer - ミューテーションのテスト: コードを本番環境にデプロイする前に、キャンペーンの作成や予算の更新が成功したことを確認します。
- GAQL のデバッグ: Explorer を使用して Google 広告クエリ言語 （GAQL）文字列を実行し、返された JSON 構造がアプリケーションの想定と一致することを確認します。
- プロトコルの検証: 特定の API バージョンに必要な正確な HTTP ヘッダーと JSON ネストを検査します。