Yahoo広告APIをPythonで自動化して詰まった5つの罠

Yahoo!広告のデータをPythonで自動取得しようとして、公式リファレンスの前で手が止まった経験はないだろうか。検索で出てくるのはPHPやGoogle Apps Scriptの記事ばかりで、Pythonの実装例は驚くほど少ない。実際に動かすと、Google広告APIとは作法がまるで違う。とくにレポート取得は「すぐ取れない」独特な仕様で、初見だと必ずつまずく。ここでは、月数千万円規模の運用でレポート自動化を組んだとき実際に踏み抜いた5つの罠と、その回避策を実装目線でまとめる。読み終えれば、非同期レポートの待ち受け処理まで自力で書けるようになる。

Yahoo広告APIをPythonで叩く全体像

まず処理の流れをつかむ。Yahoo!広告APIでレポートを取るまでは、大きく3ステップだ。1つ目がOAuth 2.0でのアクセストークン取得、2つ目がレポート定義の登録、3つ目が生成完了を待ってのダウンロードである。Google広告APIのように「クエリを投げたら即データが返る」設計ではない点が最大の違いだ。

通信はすべてHTTPSのPOSTで、リクエストもレスポンスもJSONで扱える。だからPythonならrequestsライブラリ1つで完結する。公式SDKに頼る必要はない。認証まわりの仕様はLINEヤフー広告 API v19のリファレンスが一次情報になる。現行はv19で、URLのバージョン部分を間違えると404で弾かれる。

罠1・罠2：レポートは即取得できない「非同期ジョブ」

最初の関門がこれだ。Yahoo!広告は、事前にReportDefinitionServiceへレポート定義を登録しないとデータが一切出力できない。アカウントID・レポート種別・期間・欲しいフィールドを指定して登録すると、レポートIDが返る。ここでCSVが返ると思い込むのが罠1である。

返ってくるのはIDだけで、サーバー側は裏でCSVを生成し始める。生成には数十秒から、行数が多いと数分かかる。登録直後にダウンロードを叩くと「生成中」ステータスが返り、空振りする。これが罠2だ。

対策はポーリングだ。getReportJobで状態を数秒おきに確認し、COMPLETEDになってから初めてダウンロードURLへアクセスする。Pythonなら「10秒sleep→状態確認→未完なら再試行、最大12回で打ち切り」といったループを噛ませる。この待ち受け処理を書けるかどうかが、PHP/GAS記事のコピペで止まる人との分岐点になる。定義の詳細はReportDefinitionServiceの公式ページで確認できる。

罠3・罠4：トークン期限とアカウント階層

罠3はアクセストークンの寿命だ。Yahoo!広告のアクセストークンは有効期限が短く、日次バッチを回すとすぐ失効する。だからスクリプト冒頭で毎回リフレッシュトークンから取り直すのが定石だ。「昨日は動いたのに今朝401」の9割はこれが原因である。トークンはハードコードせず、環境変数か認証情報ファイルに逃がす。

罠4はアカウントIDの取り違えだ。Yahoo!広告はMCC（管理アカウント）配下に複数の広告アカウントがぶら下がる。レポート定義に渡すのは個別の広告アカウントIDで、MCC側のIDを渡すと空か権限エラーになる。複数アカウントを回すときは、IDをリスト化してループで1件ずつ登録する設計にしておくと後が楽だ。この一括処理のコードはClaude Codeに書かせると速い。手順はClaude Codeの使い方ガイドにまとめている。

罠5：検索広告とディスプレイ広告でフィールド名が違う

最後の罠が地味に効く。Yahoo!広告APIは検索広告（YSA）とディスプレイ広告（YDA）でエンドポイントもフィールド仕様も別物だ。同じ「コスト」でもフィールド名や粒度が異なり、片方で動いたコードをそのまま流用すると欠損やエラーになる。

実運用では、媒体ごとにフィールド定義を辞書で分けて持つのが安全だ。検索広告用とディスプレイ広告用の設定を別々に持ち、共通の取得関数へ渡す形にする。この設計にしてから、媒体追加のたびにコードを書き直す手間が消えた。手作業で毎朝スプレッドシートへ転記していた15分が、cron実行でゼロになったのが一番の変化だ。

自動化を運用に乗せる

スクリプトが動いたら、macOSならlaunchd、Linuxならcronで早朝に実行し、結果をSlackへ通知する形まで組むと運用が回る。取得したCSVはそのままでは読みにくいので、集計後にクライアント提出用の資料へ整える工程が残る。

この最後の資料化を効率化するツールも押さえておくと便利だ。

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

自動取得したデータをそのまま提案スライドへ流し込めば、レポート業務全体が短縮できる。

まとめ

Yahoo!広告APIのPython実装でつまずくのは、ほぼ「非同期レポート」「トークン失効」「アカウント階層」「媒体差」の4系統に集約される。逆に言えば、この5つの罠さえ先回りすれば、公式リファレンスとrequestsだけで日次自動化は十分に組める。まずは1アカウント・1媒体のレポート取得から動かし、ポーリングとトークン再取得を確実にすることから始めたい。

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

本記事の手法の完全版（実際のポーリングコード・認証情報の管理方法・つまずき対処つき）は、運営者のnote（note.com/ryo_ai_hack）で公開している。実データに基づく実践ガイドをまとめて読める。

DMM 生成AI CAMP

コメント

コメントを投稿

このブログの人気の投稿

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 ）で取得できる。無料クレジットが付くため、初期費用はか...
続きを読む

無料AI議事録ツール5選を実際に試した結果【2026年版】

イメージ
会議のたびに議事録作成で1時間消える。そんな悩みを抱えるビジネスパーソンは多い。AI議事録ツールを使えば、文字起こしから要約まで自動化でき、作業時間を最大8割削減できる。本稿では2026年5月時点で無料利用できるAI議事録ツール5本を実際に検証した。文字起こし精度・話者識別・無料枠・日本語対応の4軸で比較し、用途別の最適解を整理する。読み終えた直後に、自分に合う1本を選んで今日から試せる構成にした。 なぜ無料AI議事録ツールが2026年の標準装備なのか 2026年に入り、国内外のAI議事録ツールは無料プランの実用性を大きく引き上げた。Nottaは月120分、tl;dvは月10会議分のAI要約を無料で開放している。背景にあるのはWhisper系音声認識モデルの精度向上だ。日本語の文字起こし精度は90%超に達し、社内会議なら手直しなしで使える水準になった。 導入コストは0円。それでも月10時間規模の作業時間が浮く。投資対効果は実質無限大であり、導入しない理由が見当たらない。比較ガイドは findAI の最新比較版 も参考になる。 無料AI議事録ツールを評価する4つの軸 1. 文字起こし精度（日本語特化か） 英語特化モデルは日本語の固有名詞や敬語表現で崩れやすい。社内会議メインなら、日本語学習データを多く持つ国産系を優先したい。 2. 話者識別の正確性 3名以上の会議では話者の切替が議事録の読みやすさを左右する。事前の声紋登録に対応しているかも要チェックだ。 3. 無料枠の実用性 「無料」と書かれていても、実態は5分・1回限定のお試し型がある。週1〜2回の定例会議をカバーできる時間枠か、必ず確認する。 4. 連携できる会議ツール Zoom・Google Meet・Microsoft Teamsとの自動連携があれば、録画忘れがなくなる。普段使う会議ツールとの相性が最重要だ。 無料で使えるAI議事録ツール5選【2026年検証版】 Notta — 日本語特化で月120分無料 国産系の代表格。日本語の精度と話者識別の両立度が高く、無料枠120分は週1の定例会議2回分に相当する。Zoom・Meet・Teams全対応で、初心者の最初の1本に最適だ。 tl;dv — 月10会議までAI要約付き ドイツ発のサービスで、Google Meet・Zoomの自動録画とAI要約を無料提供する。...
続きを読む

Claude Code副業で月5万円稼ぐ現実的な方法

イメージ
AIで副業を始めたいが、コードが書けず動けない。そんな20〜30代は多い。Claude Codeなら、日本語で指示するだけで自動化の仕組みを作れる。習得に数か月かかるWeb制作や動画編集と違い、実務レベルへ2〜4週間で届く。結論から言えば、非エンジニアでも3か月で月5万円はねらえる水準だ。以下で収益モデル・単価相場・始め方を、今日から動ける形で整理する。 Claude Codeが副業に向く理由 Claude CodeはAnthropicが提供するAIコーディング支援ツールだ。ターミナルから会話するように使い、指示を自然な日本語で書けばコードを生成してくれる。「このCSVを整理するスクリプトを作って」と伝えるだけでいい。専門知識がなくても操作できる点が、他の副業と決定的に違う。 料金は月20ドルのProプラン、より重い用途向けのMaxプランがある。有料サブスクには月次クレジットが標準で付く。まず月20ドルで試し、案件が増えたら上位プランへ移る流れが無理がない。公式情報はAnthropicのドキュメント(https://docs.anthropic.com)で確認できる。 月5万円を生む3つの収益モデル Claude Code副業の稼ぎ方は、大きく3つに整理できる。自分の適性と使える時間で選べばいい。 スポット型 ：クラウドソーシングの単発案件。月2〜8万円が目安で、実績づくりに向く。 継続型 ：中小企業の業務自動化を支援する。月5〜20万円と単価が高く、安定しやすい。 情報発信型 ：ブログ・note・YouTubeで知見を売る。月1〜10万円で、資産として積み上がる。 最短で結果を出すなら、スポット型で実績を作り、継続型へ移すのが定石だ。まず1つ手をつけ、他へ横展開する発想が効く。 単価相場と現実的な金額感 2026年の案件単価は3,000〜30,000円が中心だ。単純な作業ほど安く、業務全体の自動化ほど高い。たとえば「請求書データを読み込み、期限7日以内を抽出しSlackへ通知する」仕組みは、継続契約になりやすく単価も上がる。 非エンジニアが扱える理由は明快だ。議事録の要約、経費の整理、顧客リストの分析など、日本語の指示で完結する業務が多い。会議後5分で担当者別のTODOまで整う事例も報告されている。「難しそう」という先入観こそ、最大の障壁だと言っていい。 実際にあ...
続きを読む