Google広告APIの公式アシスタントがv4.0.0に。Claude CodeとAntigravityのプラグインとして動く形へ

何が発表されたのか

Googleは2026年8月25日、Google Ads API Developer Assistant の v4.0.0 を公開しました。Google Ads Developer Blog での発表です。

最大の変更は、配布の形式が変わった点にあります。従来のスタンドアロンのプロジェクトから、AIコーディングエージェントに組み込むプラグインへと移行しました。

対応環境は Antigravity と Claude Code の2つです。Claude Code をすでに使っている方であれば、既存の環境にそのまま追加できます。

Developer Assistant とは何か

Google Ads API Developer Assistant は、Google広告のAPIを自然言語で扱うためのアシスタントです。Googleの googleads リポジトリで公開されている、公式のツールにあたります。

初版のv1.0が公開されたのは2025年12月でした。その後v2.0が2026年2月に出ており、今回のv4.0.0はおよそ8か月で4世代目という速さです。

このツールが解決しようとしているのは、APIの仕様とAIエージェントの知識のズレです。Google Ads API はバージョンの更新が早い部類に入ります。エージェントが学習時点の古い書き方を提案してくる場面もありました。

Developer Assistant は公式のAPI定義を参照して回答を組み立てます。そのため、生成されるコードやクエリが実際の仕様に沿いやすくなります。

v4.0.0の中身

統一プラグインアーキテクチャ

v4.0.0では、ルール・スキル・診断コマンドが自己完結型のプラグインバンドルにまとめられました。複数の環境で同じ内容を一元管理できる構成です。

仕組みとしては、AGENTS.md と CLAUDE.md を設定の起点に置いています。そのうえでスラッシュコマンドとカスタムSkillsが動く形です。

Claude Code のプラグインシステムに統合されたため、独自のスラッシュコマンドがそのまま使えます。Antigravity についてはネイティブサポートとされています。

対応言語

コード生成が対応するのは、Python、Java、PHP、.NET、Ruby の5言語です。Googleはこれを「イディオマティックなコード生成」と表現しています。

各言語のクライアントライブラリの流儀に沿ったコードが出てくる、という意味です。

パフォーマンスの改善

キャッシュ機構が実装され、トークン消費が削減されたと説明されています。あわせて応答時間の短縮、CPUとメモリの使用量低下も挙げられています。

エージェントを日常的に回す立場からすると、トークン消費の削減は利用料に直結する部分です。

使える機能

Google公式ブログとGitHubのREADMEで挙げられている主な機能は、次のとおりです。

このほか /get-cids、/pmax-filter、/explain、/step-by-step、/assistant-tutorial、/sync-client-libs、/ext-version といったコマンドが用意されています。生成されたコードは saved/code/、クエリ結果のCSVは saved/csv/ に保存されます。

GAQLの検証は、実務で地味に効く機能だと感じています。フィールドの組み合わせが不正でエラーになる場面は、APIを触っていると珍しくありません。

変更系の操作は実行しない

このツールを理解するうえで、いちばん重要な線引きがここです。READMEには次のように明記されています。

The Assistant is designed to generate code for mutate operations (e.g., creating campaigns, adding users) but will not execute them.

キャンペーンの作成やユーザーの追加といった変更系の操作について、コードは生成するが実行はしない、という設計です。あわせて、レビューを経ていない変更系の操作を直接実行することを厳格に禁止する、とも書かれています。

実際に実行されるのは読み取り系の処理です。レポートの取得やスキーマの確認は動きますが、入稿や更新は生成されたコードを人が確認してから走らせる形になります。

本番アカウントを守る設計として、この割り切りは妥当だと考えています。読み取りだけなら失敗しても取り返しがつきますが、変更系はそうはいきません。

導入手順

前提として、Python 3.10以上がPATH上にある必要があります。Claude Code を使う場合は Node.js 18以上も必要です。

Claude Code 自体は npm install -g @anthropic-ai/claude-code でインストールできます。macOSであれば brew install claude-code でも構いません。

リポジトリを取得したあとは、インストールスクリプトを実行します。

# Antigravity 向け
./install.sh agy

# Claude Code 向け
./install.sh claude

# PHP・Ruby・.NET のライブラリもあわせて入れる場合
./install.sh claude --php --ruby --dotnet

Windowsの場合はPowerShellのスクリプトを使います。

.\install.ps1 -Type claude
.\install.ps1 -Type claude -Php -Ruby -Dotnet

ライセンスは Apache License 2.0 です。無料で利用でき、バグ報告や要望はGitHub Issuesで受け付けられています。

運用メモ v4.0.0はv3以前と互換性がありません。すでにv2やv3を導入している場合、既存の設定をそのまま引き継ぐことはできない点に注意してください。移行の前に、手元で加えたカスタマイズがどこに書かれているかを確認しておくと安全です。

広告運用者にとっての意味

このアップデートは、管理画面の設定や配信の成果に直接影響するものではありません。影響を受けるのは、APIを使って自動化に取り組んでいる層に限られます。

そのうえで、意味があると考える点を2つ挙げます。

ひとつは、レポート取得のハードルが下がることです。GAQLは慣れるまで書きづらい言語で、フィールド名の確認にドキュメントを往復する場面が多くあります。自然言語で指示してCSVまで出せるのであれば、その場かぎりの数値確認は速くなります。

もうひとつは、公式のツールが Claude Code を正式な対応先に含めた点です。Googleは2026年4月にAgent Skills の公式リポジトリも公開しています。広告APIをエージェントから扱う流れは、個人の工夫の段階から公式に整備される段階へ移りつつあると見ています。

既存の自動化と競合するのか

SIGNALZでは以前、Claude CodeからGoogle広告をAPI入稿する実践ガイドで、Pythonのクライアントライブラリを使った入稿の手順を紹介しました。今回のv4.0.0は、この方法を置き換えるものではありません。

理由は先に触れたとおりで、Developer Assistant は変更系の操作を実行しないためです。入稿そのものは、引き続き自分でコードを書いて走らせる形になります。

また、v4.0.0はプラグインであってMCPサーバーではありません。Google広告にMeta広告のような公式MCPが提供された、という話ではない点は押さえておいてください。

役割としては補完の関係にあります。GAQLの検証やスキーマの確認、エラーの診断といった調べ物はアシスタントに任せます。入稿の実行は、自前のスクリプトとガードレールで管理します。この組み合わせが現実的だと考えています。

導入前に押さえておく点

APIを使うには、Google広告の開発者トークンが必要です。この前提はDeveloper Assistantを入れても変わりません。まだ取得していない場合は、広告API入門ガイドから確認してください。

読み取り系とはいえ、実行されるのは本番アカウントに対するクエリです。テスト用のアカウントで挙動を確かめてから、本番のアカウントIDを渡す進め方をおすすめします。

生成されたコードをレビューせずに実行しない、という点も改めて確認しておきたいところです。ツール側で禁止されている操作を、人が手元で回避してしまっては意味がありません。

関連記事

• Claude CodeからGoogle広告をAPI入稿する実践ガイド - APIでの入稿手順とガードレールの設計
• 広告API入門ガイド - Google・Meta・Yahoo!のAPI概要と始め方
• GoogleがAIエージェント向けスキルを公式公開 - google/skills リポジトリの概要
• マーケター向けClaude Code入門ガイド - Claude Codeの基本と業務での使いどころ