Google 広告 API（Google Ads API）

Claude Codeに、どこまで権限を渡せるか

読み取り専用で渡せるか あり

公式MCPサーバーは「Read-only (current release)」「This implementation is strictly read-only」（入札変更・キャンペーン一時停止・アセット作成はできない）と公式ページに記載。ツールは list_accessible_customers・search・get_resource_metadata の3つ。GitHubのREADME自体には読み取り専用の記載はなく、公式ドキュメントページの記載を採用。https://developers.google.com/google-ads/api/docs/developer-toolkit/mcp-server

権限（スコープ）を選べるか 未確認

公式MCPページに出るOAuthスコープは https://www.googleapis.com/auth/adwords のみ（Cloud Runの同意画面に追加する手順）。読み取り専用スコープの記載は読んだページになし。API側の権限は Google Cloud プロジェクトのアクセスレベル（Test・Explorer・Basic・Standard。クォータページに Explorer は本番2,880操作/日）で変わる。2026年9月9日にdeveloper tokenは廃止（sunset）され、アクセスレベルはOAuth認証情報を作ったGoogle Cloudプロジェクトに紐づくと公式のdeveloper tokenページに記載（OAuth概要ページには「developer token is also required」と古い記載が残る）。

危険な操作の既定

公式MCPは書き込みツールがない（strictly read-only）。公式Developer Assistant（Claude Code用プラグイン。「not an official Google product」と記載）は、作成・更新・削除は saved/code/ にスクリプトとして出力するだけでアシスタント自身は実行しない（公式ページ）。API本体は制御の記載なし。第三者製 promobase/google-ads-mcp は書き込み可能とREADMEにある。Cloud Runで公式MCPを --allow-unauthenticated にして OAuthクライアントID/シークレットを設定しないと、コンテナのサービスアカウント資格情報が認証なしの呼び出し元に露出すると公式が警告。

削除ができるか できる

【API】開始ページのガイド項目に予算の削除（removing budgets）。キャンペーン等の削除や復元可否は読んだページに記載なし。【公式MCP】削除なし。

取り消し方（キー・接続）

Googleアカウントのアクセス権ページ https://myaccount.google.com/permissions で、アカウントに接続されたサードパーティアプリのアクセスを確認・取り消せる（Google Ads API OAuth概要ページ、更新日 2026-09-30）。

根拠のページ

つなぎ方（公式の資料にある範囲）

できる操作

読み取りでできる操作

• 【MCP】アクセス可能なカスタマーIDの一覧、GAQLクエリによるメトリクス・予算・ステータスの取得、リソースのフィールド情報
• 【API】GAQLによるレポート取得（Search / SearchStream）

書き込みでできる操作

• 【API】キャンペーン・予算・アセットの作成と更新、コンバージョンのアップロード、アカウントの作成とリンク、ユーザーアクセスの自動化
• 【MCP】公式MCPは書き込みなし（strictly read-only）
• 【Developer Assistant（Claude Code用プラグイン）】作成・更新・削除は saved/code/ にスクリプトとして出力するだけで、アシスタント自身は実行しない（読み取りスクリプトは実行可。公式ページ。「not an official Google product」と記載）

管理者操作（削除・課金・設定変更など）

• 【API】予算の作成・共有・割り当て・削除（ガイドの項目）、課金設定・アカウント予算・請求書（変更は月次請求のアカウントのみで1オペレーションずつ、12時間以上の間隔）
• 【MCP】公式MCPは管理操作なし

制限

• アクセスレベル別の1日の操作数: Test は 15,000（テストのみ）、Explorer は本番2,880・テスト15,000、Basic は 15,000、Standard は上限なし
• 1回のmutateは最大10,000オペレーション。Search/SearchStream は1回1オペレーション。失敗でも消費
• 応答サイズは最大64 MB
• キーワードプランニングは多くのメソッドで顧客IDあたり1回/秒。オーディエンスインサイトは顧客IDあたり1日約200回の制限あり
• 2026年6月15日以降 UploadClickConversions は新規利用者は制限され Data Manager API を使う。2026年4月1日以降 UserDataService・OfflineUserDataJobService も新規は制限（公式記載）
• 課金・予算のmutateは月次請求アカウントのみ、アカウント予算の変更は12時間以上あける
• 公式MCPのホスト型エンドポイントは許可リスト登録の参加者のみのパイロット。OAuth同意画面が Testing の間は接続アカウントをテストユーザーに追加する必要

認証・料金・日本語・実機検証

認証方式

OAuth 2.0（スコープ https://www.googleapis.com/auth/adwords）。公式MCPはGoogle CloudプロジェクトID と OAuth クライアント資格情報かアプリケーションデフォルト認証（ADC）。公式のdeveloper tokenページに「Developer tokens were sunset on September 9, 2026」と書かれている。トークンを送っても「optional and ignored by the API servers」で、将来の主要バージョンで拒否する予定とある（公式MCPページも、サンセット済みで最新版では不要と記載）。アクセスレベル（Test・Basic・Standard）はOAuth認証情報を作ったGoogle Cloudプロジェクトに紐づく。v25以降、Test のプロジェクトが本番アカウントを呼ぶと AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION になる。新規の Basic・Standard 申請にはブランド確認が必要で、保留中の Basic 申請は閉じられて再申請になる。申請はGoogle Cloudコンソールの Google Ads API の概要ページから行う。一方、OAuth概要ページ（Last updated 2026-09-30）は「developer token is also required」のままで、GitHubのREADME（GOOGLE_ADS_DEVELOPER_TOKEN に「at least Explorer access」）と第三者製MCP（promobase）も developer token を必須としており、古い記述が残っている。developer tokenページ自体も、冒頭の要約が旧説明で、本文のサンセットの記述と内部で食い違っている。

公表されている料金（2026年10月17日確認）

APIの利用料は無料。公式の「Access levels and RMF」ページに、Explorer・Basic・Standard の各アクセスレベルで「Google Ads API is free to use」とある。ただし Required Minimum Functionality の審査で非準拠と判断されると、非準拠手数料を払う場合がある、とも書かれている（2026年10月確認）。 料金ページ

日本語対応

あり。公式ドキュメント「Google 広告 MCP サーバー: デベロッパー向け統合ガイド」の日本語版（hl=ja）を確認。管理画面（Google 広告）の日本語は未確認。

Claude Code実機検証

未検証（この台帳は、動かして確かめた記録ではありません。Akiraが試したときは、検証日つきで書き換えます）