validate_onlyで入稿ミスを実行前に弾く3手順

広告の入稿ミスは、気づいた時にはもう配信が始まっている。日予算の桁を1つ間違えれば、数時間で数十万円が溶ける。人力のダブルチェックは何度でもすり抜ける。API経由で入稿している運用者なら、実行前にサーバー側で検証させる手段がある。Google広告APIのvalidate_onlyだ。この記事では、validate_onlyで弾けるミスと弾けないミスを切り分け、実行前チェックを3手順のルーティンに落とす。

入稿ミスは「実行後」に気づくと戻せない

API入稿の事故が怖いのは、取り消しの難易度が操作ごとに違うからだ。日予算の変更は上書きで戻せる。だが入札戦略の変更は、戻しても学習がリセットされた事実は消えない。キャンペーンの有効化は、配信済みのインプレッションを取り消せない。

とくに事故りやすいのがGoogle広告APIの金額単位micros（100万分の1通貨単位）だ。日予算3,000円は3000000000ではなく3000000と書く。ゼロを3つ多く打っても、APIは文法上正しいリクエストとして受け取る。人間の目視では、桁の多い数字ほど見落とす。

そこで運用では、書き込みを「①検証だけ実行 → ②APIで実値を読み返して照合 → ③有効化」の3段に分けている。読み返しの際は必ず1,000,000で割って円に戻してから、意図した値と突き合わせる。microsのまま比較すると、桁ミスを桁ミスのまま見逃す。APIの基本的な叩き方はGoogle広告APIをPythonで動かす手順にまとめた。

validate_onlyの正体と、Pythonでの付け方

validate_onlyは、リクエストを実際には反映せず、バリデーションだけ走らせるフラグだ。trueを付けると、アカウントには何も作られない。にもかかわらず、入力に問題があれば通常どおり例外が返る。つまり「本番と同じ検証ロジックを、副作用なしで通せる」。

Pythonクライアントで最初につまずくのがここだ。validate_onlyは各サービスのメソッド引数として用意されていない。client.get_type("MutateCampaignsRequest") でリクエストオブジェクトを作り、request.validate_only = True と直接代入してから渡す必要がある。キーワード引数で渡そうとすると通らない。この挙動は公式のオプションリクエストヘッダー解説（developers.google.com/google-ads/api/docs/client-libs/python/optional-request-headers）に書かれている。

成功時のレスポンスにも注意がいる。検証だけなので、返ってくるリソース名は空だ。戻り値のIDを次の処理に渡す設計にしていると、検証モードのときだけ後続が壊れる。検証実行と本番実行でコードパスを共有するなら、validate_onlyがtrueの時は戻り値を使わないと決めておく。

広告テキストの検証サンプルは公式にもある（developers.google.com/google-ads/api/samples/validate-ad）。文字数超過や禁止表現を、作成せずに洗い出す用途だ。

実行前チェックの3手順

ここが実務の型だ。ブックマークして、自分の環境に合わせて書き換えて使ってほしい。

  • 手順1: 意図値テーブルを先に作る — 「どのリソースを、いくつに変えるのか」をCSVかdictで先に確定させる。コードの中で計算しながら書き込むと、照合の基準が残らない。
  • 手順2: validate_onlyで全件流す — 1件ずつではなく、その回の変更を全件まとめて検証する。1件でも落ちたらバッチ全体を止める。部分的に通す運用にすると、どこまで反映されたか分からなくなる。
  • 手順3: 反映後に読み返して照合する — 書き込み直後にGAQLで同じリソースを取得し、金額は1,000,000で割ってから意図値と全件比較する。件数も数える。「3件変えるはずが2件しか返らない」を検知するためだ。

手順3が最重要になる。理由は次の章にある。この3手順をスクリプト化した完全版はnoteの実践ガイドにまとめている。

validate_onlyでは弾けないミスがある

validate_onlyが検知するのは、あくまで形式と整合性だ。日予算に負の数を入れた、必須フィールドが欠けている、文字数が上限を超えた、といった類は止まる。

止まらないのは「形式として正しい、意味的に間違った値」だ。具体的には次の3つが代表格になる。

  • 桁を間違えた金額（3000000000 microsは形式として合法な日予算）
  • 対象リソースの取り違え（別キャンペーンのIDに正しい値を書く）
  • 変えるつもりのない項目への巻き添え更新（update_maskの指定漏れ）

3つとも、APIは正常終了する。だから検証を通したことを安全の根拠にしてはいけない。安全を担保するのは、手順3の読み返し照合のほうだ。validate_onlyは「壊れたリクエストを止める門」であって、「意図と合っているか判定する門」ではない。

もう1つの実務的な保険が、作成時は必ず一時停止（PAUSED）で作り、読み返しに通ってから有効化する二段書き込みだ。有効化を分離しておけば、意味的なミスに気づいた時点でまだ配信が始まっていない。日予算そのものの決め方は広告の日予算を自動計算するPython実装で扱っている。

チェックを自動で止める仕掛けに変える

ルールを決めても、急いでいる日に飛ばすのが人間だ。実行前チェックは、書いたコードの中ではなくその手前に置くと守られる。

具体的には、金額をコードへ直に書いたリクエストを検出したら実行前に確認を挟む、という前処理を1枚かませる。運用では、microsの直書きを含むコマンドを実行しようとすると確認が入る仕組みにしてある。導入してから、桁の直書きを無意識にやる回数そのものが減った。止められると面倒なので、意図値テーブルを先に作るほうへ手が動く。

［PR］ 検証フローや運用ルールを社内資料に落とし込むなら、AIスライド作成ツール「イルシル」を試してみるのも手だ。

まとめ

validate_onlyは無料で使える事前検証の門であり、形式エラーをアカウントに触れずに落とせる。ただし桁ミスとリソース取り違えは通過する。だから「validate_onlyで検証 → PAUSEDで作成 → 読み返して円換算で照合 → 有効化」の順序をセットで運用する。まずは次の入稿1件を、この順序で通してみてほしい。

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

本記事の手法の完全版（実際のコード・テンプレート・つまずき対処つき）は、運営者の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見出し構成生...
続きを読む

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を一括生成するツール」のように、効果を秒数や...
続きを読む

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回...
続きを読む