Google広告APIをPythonで動かす手順と初回の壁

Meta広告のレポート自動化に続いて、Google広告もPythonでデータを引きたい運用者は多い。だが公式ドキュメントどおりにコードを書いても、最初のAPIコールでほぼ全員が同じ場所でつまずく。原因は認証コードでも書き方でもなく、発行されたばかりの開発者トークンの「アクセスレベル」にある。この記事では、Google広告APIをPythonで動かすまでの実装手順と、初回に必ず当たる壁の回避法を、そのまま試せる形でまとめる。

初回の壁はアクセスレベルにある

Google広告APIの利用登録を済ませると、開発者トークン（developer token）が発行される。これは22文字の英数字で、アプリをAPIサーバーに識別させる鍵だ。ここで見落としやすいのが、発行直後のトークンは「テストアカウントアクセス」という最も制限された段階から始まる点である。

この段階のトークンで本番の広告アカウントにクエリを投げると、認証は通るのにデータが返らず、次のエラーが出る。「The developer token is only approved for use with test accounts. To access non-test accounts, apply for Basic or Standard access.」つまり本番アカウントを触るには、API Centerから「Basicアクセス」を申請して承認を得る必要がある。Basicは本番・テスト両方に使え、1日15,000オペレーションまで実行できる。アクセスレベルの区分は公式のAccess Levelsに明記されている。

実運用で詰まったのはまさにここだった。ローカルで認証まで成功し、コードは正しいのにデータがゼロで返る。半日ほど認証周りを疑った末、原因がトークンのアクセスレベルだと判明した。申請フォームには利用目的の記述が必要で、承認までは数営業日かかる。先に申請を出しておくのが最短ルートだ。

認証に必要な4つの情報

Pythonクライアントライブラリは公式ページとPyPIで配布され、Python 3.8以上で動く。認証には、次の4つの情報を1つの設定ファイルにまとめる。

  • developer_token（22文字。ads.google.com/aw/apicenterで確認）
  • client_id と client_secret（Google Cloudで作るOAuthクライアント）
  • refresh_token（OAuth同意フローで一度だけ取得する更新トークン）
  • login_customer_id（MCC＝上位の管理アカウントID。ハイフンなし）

これらをGitHubのサンプルにある google-ads.yaml にコピーし、自分の値で置き換える。login_customer_id の入れ忘れは、複数アカウントを管理している場合に権限エラーの元になりやすい。ここまで正しく埋まれば、client = GoogleAdsClient.load_from_storage("google-ads.yaml") の1行でクライアントが立ち上がる。

GAQLでレポートを取得する骨格

データ取得はGAQL（Google Ads Query Language）というSQLに似た言語で書く。SELECTで欲しい指標、FROMでリソース、WHEREで期間を指定する考え方だ。取得の仕組みはReporting概要にまとまっている。

ここで再利用できる最小の取得骨格を置いておく。ブックマークして、自分のアカウントIDと指標名に書き換えて使ってほしい。手順はこうだ。（1）service = client.get_service("GoogleAdsService") でサービスを取得する。（2）query = "SELECT campaign.name, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date DURING LAST_7_DAYS" とクエリ文字列を組む。（3）response = service.search_stream(customer_id="1234567890", query=query) でストリーム取得する。（4）for batch in response: for row in batch.results: と二重ループで1行ずつ読む。

注意点が1つある。費用は cost_micros という単位で返り、実際の金額はこれを100万で割る。1,000,000なら1通貨単位だ。この変換を忘れると、レポート上の金額が実額の100万倍になる。日予算やpacingの計算に流す前に、必ず割り算を挟む。

3媒体横断への発展と運用の注意

Google広告のデータが取れるようになると、次に効いてくるのが媒体横断だ。取得フローの設計思想はMeta・Yahooとほぼ同じで、認証情報の管理とレスポンスの整形さえ揃えれば、3媒体を1つのレポートに統合できる。Metaの実装はMeta広告レポートをPythonで自動化する実装手順に、Yahooでつまずいた罠はYahoo広告APIをPythonで自動化して詰まった5つの罠にまとめた。3媒体で共通化する際は、各APIの単位差（Googleはmicros、媒体ごとに指標名が違う）を吸収する変換層を1枚かませるのが安全だ。

運用でもう1つ気をつけたいのが、1日15,000オペレーションの上限である。全キャンペーンを高頻度でポーリングすると、意外と早く枠を使い切る。取得は1日数回のバッチにまとめ、期間はDURINGで絞る。この統合レポートの完全版はnoteの実践ガイドにコード付きでまとめている。

ここで紹介した手順を土台に、資料化やクライアント共有まで一気に進めたいなら、AIツールを併用すると速い:

AIスライド作成ツール「イルシル」を試してみる

まとめ

Google広告APIをPythonで動かす最短ルートは、コードより先に開発者トークンのBasicアクセスを申請することだ。承認を待つ間に認証情報4点を揃え、GAQLの取得骨格を組んでおけば、承認後すぐに本番データが引ける。micros単位の変換とオペレーション上限だけ押さえれば、Meta・Yahooと並べて3媒体の統合レポートへ発展できる。まずはテストアカウントで骨格を通し、申請を出すところから始めたい。

実務でそのまま使いたい人へ

本記事の手法の完全版（実際のコード・テンプレート・つまずき対処つき）は、運営者のnote（note.com/ryo_ai_hack）で公開している。実データに基づく実践ガイドをまとめて読める。

DMM 生成AI CAMP

コメント

コメントを投稿

このブログの人気の投稿

Claude Skills販売で月5万稼ぐ3ステップ実践

イメージ
2026年、Anthropicが公開した「Claude Skills」が新たな副業の入口として注目を集めている。SKILL.mdというMarkdown形式の手順書を1枚書くだけで、誰でも自分の業務ノウハウをAIワークフローとして販売できる仕組みだ。海外では非エンジニアが50日で5,000ドルを売り上げた事例も登場し、日本でも参入の動きが加速している。今回は「Claude Skills 販売 副業」を軸に、月5万円を狙うための3ステップを具体的に解説する。コードは一切不要、初期費用もほぼゼロで始められる。 Claude Skillsとは何か:販売できる理由 Claude Skillsは、Claude Codeが特定タスクを実行する際に読み込む「再利用可能な指示書」である。実体はSKILL.mdというテキストファイル1枚で、業務手順を自然言語で記述するだけで動く。プログラミング言語は必要なく、日本語で「請求書を読み取り仕訳を生成する」「議事録から議題別サマリを作る」といった手順を構造化して書けば成立する。 販売できる理由は3つある。第一に、Anthropicの審査やマーケットプレイス登録が不要で、自分のサイトやGumroad経由で即販売できる。第二に、業務知識そのものが資産になるため、士業・人事・経理など専門職の暗黙知が高値で売れる。第三に、購入者はファイルをClaude Codeに置くだけで使えるため、サポート負荷が極めて低い。海外メディアagent37の報告では、税務処理を自動化するSkillが1本79ドルで継続的に売れている。 月5万円のリアルな単価設計 1本2,980円のSkillを月17本売れば達成できる。1本9,800円なら月5本で到達する。高単価帯は専門業務向け、低単価帯は汎用ツール系という棲み分けが定石となっている。 ステップ1:売れるSkillテーマを30分で決める 最初の関門はテーマ選定である。売れるSkillには共通点が3つある。「毎週繰り返す業務」「結果物がテキストかコード」「担当者の判断が定型化できる」の3点だ。この条件を満たす自分の業務を15個書き出し、上位3つに絞り込む作業を30分で行う。 具体例を挙げる。広告運用者なら「日次レポートのSlack要約Skill」、人事なら「面接フィードバック整形Skill」、ライターなら「SEO見出し構成生...
続きを読む

Difyの使い方｜初心者でも10分で作れるAIアプリ入門

イメージ
「AIを使ったアプリを作りたい。でもプログラミングの知識がない」——そんな悩みを持つ人が急増している。2026年現在、ノーコードでAIアプリを開発できるツールは複数ある。中でも注目度が高いのがDify（ディフィ）だ。オープンソースで公開されており、無料プランでもチャットボットや文章生成ツールを作成できる。 Difyをまったく触ったことがない初心者でも大丈夫。この記事では、アカウント登録からAIアプリ完成までの全手順を解説する。最短10分で、自分だけのAIチャットボットが動き出す。 Difyとは？ノーコードで使えるAI開発プラットフォーム Difyは、大規模言語モデル（LLM）を活用したAIアプリをノーコードで開発できるプラットフォームだ。オープンソースとして公開されている。2026年4月時点でダウンロード数は500万を超えた（ Dify公式サイト ）。 主な特徴は以下の3つ。 マルチモデル対応 ：OpenAIのGPT、AnthropicのClaude、GoogleのGeminiなど数百種類のAIモデルを切り替えて使える ノーコードUI ：処理ブロックをつなげるだけで、チャットボットやワークフローを構築できる RAG（検索拡張生成） ：自社ドキュメントやFAQをアップロードし、その情報をもとに回答するAIを作れる プログラミング経験がゼロでも、ブラウザ上で直感的に操作できる。これがDify最大の強みだ。 Difyの始め方｜アカウント登録から初期設定まで3ステップ Difyを使い始めるまでの手順はシンプルだ。3ステップで完了する。 ステップ1：アカウントを作成する Difyクラウド版（ cloud.dify.ai ）にアクセスする。「始める」ボタンをクリックしよう。Googleアカウント、GitHubアカウント、メールアドレスのいずれかで登録できる。所要時間は1分程度だ。 ステップ2：AIモデルのAPIキーを設定する ログイン後、画面右上のアカウントアイコンから「設定」に進む。「モデルプロバイダー」を開き、使いたいAIサービスを選ぼう。事前に取得したAPIキーを入力して保存すれば完了だ。 まだAPIキーがない場合はOpenAI公式サイト（ platform.openai.com ）で取得できる。無料クレジットが付くため、初期費用はか...
続きを読む

Claude CodeでExcel自動化副業を月5万にする手順

イメージ
Claude Codeを副業に使いたいが、何から手をつければ収入につながるのか見えにくい。本記事は、需要が安定しているExcel自動化案件に的を絞り、3週間で初案件を獲得し月5万円までスケールさせる具体的な手順をまとめる。コーディング未経験でも、手順どおりに進めれば動くものを納品できる構成にした。 なぜExcel自動化が初心者の最短ルートなのか クラウドソーシングで需要が枯れない領域がExcel関連だ。ランサーズやクラウドワークスでは「VBAでの集計自動化」「データ整形」「請求書生成」が常時数百件単位で募集されている。単価は1案件3,000〜30,000円で、納期も短い案件が多い。 従来は VBAの知識 が壁だった。だがClaude Codeは自然言語の指示からVBAコードを生成し、ターミナル上で実行・修正まで完結する。リベシティの解説によれば、Excel自動化はClaude Code副業16ジャンルの中で初心者が最も入りやすい分野とされている。 参考: リベシティのClaude Code活用例まとめ 準備するもの（初期費用は月3,000円のみ） Claude Pro契約: 月額20ドル（約3,000円） Node.js: 公式サイトから無料でインストール Microsoft Excel: すでに持っているはず クラウドソーシングのアカウント: ランサーズかクラウドワークス 初期投資はClaude Proの月3,000円のみ。1案件取れれば即回収できる水準だ。インストール手順は Uravationの2026年最新ガイド に図解で載っている。 3週間ロードマップ：初案件獲得まで 1週目：Claude Codeで動くものを3つ作る 最初の壁は「指示の出し方」だ。いきなり案件に応募せず、まず手元のExcelで3つの小さな自動化を作る。例として「フォルダ内のCSVを1つに統合」「請求書テンプレへの差し込み」「重複行の検出」が定番だ。各15〜30分で完成する。 この段階で重要なのは、生成されたVBAを 必ず自分で1行ずつ読む こと。読めなくても動作の意図は把握する。後工程のエラー対応で効いてくる。 2週目：ポートフォリオを2本作る 応募時に提示する成果物を準備する。「営業日報の月次集計を5秒で完了するマクロ」「100枚の請求書PDFを一括生成するツール」のように、効果を秒数や...
続きを読む