Skip to main content

エラーコード一覧


エラー詳細説明

ERROR_CODE_INVALID_UNIT (4000)

原因:存在しないまたは無効化された広告ユニットIDでリクエストしました。 解決方法
  • コンソールで広告ユニットIDが正確か確認
  • 広告ユニットが有効な状態か確認
  • コピー/ペースト時に空白や特殊文字が含まれていないか確認

ERROR_CODE_AD_INACTIVE (4001)

原因:該当広告ユニットに有効な広告キャンペーンがありません。 解決方法
  • コンソールでキャンペーンが実行中か確認
  • キャンペーンスケジュール(開始日/終了日)を確認
  • キャンペーン予算が消費されていないか確認

ERROR_CODE_AD_NO_FILL (4002)

原因:ターゲティング条件に合う広告が見つかりません。 解決方法
  • ターゲティング設定が過度に制限的でないか確認
  • リトライロジックを実装(指数バックオフ推奨)
  • 代替コンテンツ(フォールバック)を準備
リトライ実装例

ERROR_CODE_INVALID_PARAMS (4003)

原因:リクエストパラメータが正しくありません。 解決方法
  • 必須パラメータ(unit)が含まれているか確認
  • パラメータ値の形式が正しいか確認
  • パラメータ名に誤りがないか確認
パラメータチェックリスト

エラー処理のベストプラクティス

1. エラーコードに基づく分岐処理

2. フォールバックコンテンツの準備

3. モニタリングとロギング


HTTPステータスコード

REST APIは標準HTTPステータスコードも返します。
HTTP 200でもレスポンスボディのcode値を必ず確認してください。ビジネスロジックエラーはレスポンスボディに含まれます。

関連ドキュメント

REST API概要

API基本使用法

ターゲティング設定

ターゲティングパラメータ設定