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