Google Ads API エクスプローラは、ブラウザから直接ライブ API リクエストを作成して送信できるインタラクティブな実行環境です。リファレンス ドキュメントに埋め込まれており、OAuth 2.0 認証と JSON ペイロード形式の複雑さを処理するため、1 行のコードも記述せずに特定のサービスとメソッドをテストできます。
利点
- ノーコード テスト: ローカル開発環境をセットアップせずに、ドキュメントから直接ライブ API 呼び出し（読み取りと書き込みの両方）を実行します。
- プロトコル検出: HTTP リクエストとレスポンスの正確な構造を確認して、API の動作を把握します。
- 低摩擦プロトタイピング: アプリケーションにロジックを実装する直前に、エンドポイントの動作を確認し、未加工の API レスポンスを検査します。
- 認証の簡素化: ツールが OAuth 2.0 フローを自動的に管理するため、認証情報の管理ではなく API リクエストに集中できます。
始める
- ドキュメントに移動する: リファレンス ドキュメントに移動し、テストするサービスとメソッド（
GoogleAdsService/Searchなど）を選択します。 - エクスプローラを開く: ページの右側にある [Try this method] パネルを探します。
- リクエストを構成します。
- 必要なリクエスト パラメータ（
customerIdなど）を入力し、ヘッダーを開いて、login-customer-idなどの省略可能な HTTP ヘッダーを指定します（クライアント センター（MCC）アカウント経由でアカウントにアクセスする場合にのみ必要）。デベロッパー トークン（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 ネストを正確に検査します。