一般的なエラー

このページでは、Google アド マネージャー API から返されるエラーのうち、最も頻繁に発生するエラーについて説明します。エラーは Error.REASON 形式で返されます。

エンティティの上限エラー

EntityChildrenLimitReachedError

概要
エンティティで許可される子要素の最大数に達したため、そのエンティティに子要素を追加できません。
推奨される対処方法
子要素の最大許容数に達したエンティティの新しいタイプを作成し、作成しようとしている子エンティティを新しいタイプに追加します。たとえば、LINE_ITEM_LIMIT_FOR_ORDER_REACHED が返された場合は、新しいオーダーを作成し、作成しようとしている広告申込情報をその新しいオーダーに追加する必要があります。

割り当てエラー

QuotaError.EXCEEDED_QUOTA

概要
1 秒あたりのリクエスト数が多すぎて、許容上限を超えています。
推奨される対処方法
  • 変更をローカルで収集し、それらの変更を一度に実行する単一のリクエストを行うことで、updateLineItems などのバッチメソッドを使用します。
  • 約 5 秒待ってから、リクエストを再試行します。このリクエストが成功するとは限りません。再度失敗した場合は、待機時間を増やしてみてください。これは、リアルタイムで使用されるアド マネージャーと統合されたインタラクティブ アプリケーションにおすすめです。
  • アド マネージャー ネットワークの場合は 1 秒あたり 2 件、アド マネージャー 360 ネットワークの場合は 1 秒あたり 8 件にリクエストを制限します。この方法でも、すべてのリクエストが成功するとは限りませんが、このエラーの発生回数を減らすことはできます。これは、夜間レポートの実行など、リアルタイムのインタラクションがないアド マネージャーと統合するアプリケーションにおすすめします。

認証エラー

AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK

概要
ユーザーが、すでにネットワークに関連付けられているアカウントを使用してテスト ネットワークを作成しようとしました。
一般的な原因
ユーザーが NetworkService.makeTestNetwork() を呼び出す前に新しい Google アカウントを作成していません。
推奨される対処方法
NetworkService.makeTestNetwork() を呼び出す前に、新しいアカウントを作成します。詳細については、テスト ネットワークの作成方法をご覧ください。

AuthenticationError.NETWORK_CODE_REQUIRED

概要
お客様から networkCode が提供されなかった。リクエストを行うには、ネットワーク コードが必要です。
一般的な原因
NetworkService.getAllNetworks() と NetworkService.makeTestNetwork() を除くすべてのリクエストで
ネットワーク コードが必要です。
推奨される対処方法
リクエスト ヘッダーで、対象となるネットワークのネットワーク コードを含めます。アカウント ログインで使用できるネットワーク コードのみを使用してください。コードは、アカウントのアド マネージャーのウェブサイトで、[管理者] > [ネットワーク設定] ページの [ネットワーク コード] の横に表示されます。ネットワーク コードの設定について詳しくは、SOAP XML リクエストとレスポンスのヘッダーのページをご覧ください。

AuthenticationError.NETWORK_NOT_FOUND

概要
構成で指定されたネットワーク コードがサーバーで見つからなかったため、リクエストを送信できませんでした。
一般的な原因
構成で間違ったネットワーク コードを指定しました。
推奨される対処方法
エラーログの「トリガー」フィールドには、ユーザーにとって適切なネットワークが示されていることがよくあります。

AuthenticationError.NO_NETWORKS_TO_ACCESS

概要
ユーザーがネットワークに関連付けられていない。
一般的な原因
本番環境アカウントで API アクセスが有効になっていません。
推奨される対処方法
本番環境への API アクセスを有効にします。詳細については、API アクセスの有効化をご覧ください。

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

概要
お客様は API アクセスのホワイトリストに登録されていません。
一般的な原因
ネットワークが本番環境のホワイトリストに登録されていないにもかかわらず、SOAP ヘッダーでネットワーク コードを指定しました。
推奨される対処方法
API アクセスを有効にします。

権限に関するエラー

PermissionError.PERMISSION_DENIED

概要
リクエストに必要な権限がユーザーにありません。
一般的な原因
  • 別のネットワークに存在するオブジェクトにアクセスしようとしました。
  • ネットワークに存在するオブジェクトにアクセスしようとしましたが、読み取りまたは更新の権限がありません。
  • アカウントで追加機能を有効にする必要があるタスクを実行しようとしました。
推奨される対処方法
  • UI を作成している場合は、この操作を実行する権限がないことと、管理者に問い合わせるようユーザーに伝えます。
  • ネットワークに権限がないプレミアム限定機能など、タスクの実行を試みた場合は、アカウント マネージャーにこの機能を有効にするようお問い合わせください。
  • テスト ネットワークはデフォルトではアド マネージャー 360 ネットワークではないため、アド マネージャー 360 ネットワークにあるプレミアム機能は利用できません。テスト ネットワークで機能を有効にするには、アカウント マネージャーにお問い合わせください。

バージョンのエラー

ApiVersionError.UPDATE_TO_NEWER_VERSION

概要
アプリケーションが、成功に新しいバージョンを必要とするリクエストを開始したか、非推奨のバージョンに対するリクエストを開始しました。
一般的な原因
  • API 呼び出しのバージョンは非推奨になりました。非推奨のお知らせについては、ブログにご登録ください。
  • リクエストを成功させるには、新しいバージョンの API が必要です。これは、UI で機能が導入され、API がオブジェクトを正しく送信するために新しいバージョンの API が必要な場合に多く発生します。
推奨される対処方法
  • API バージョンを常に最新の状態に保ち、定期的なアップグレードを計画します。
  • 非推奨に関する通知を受け取るには、ブログを購読してください。

404 エラー

概要
リクエストがサーバーに届きませんでした。
一般的な原因
インターネット接続またはプロキシの設定が間違っている可能性があります。呼び出している API のバージョンもサポート終了になる可能性があります。
推奨される対処方法
インターネットまたはプロキシの構成を確認し、最新バージョンの API を使用していることを確認します。クライアント ライブラリも最新バージョンにアップグレードすることをおすすめします。
対策のヒント
アド マネージャーのヘルプ コミュニティとブログで、アド マネージャー API の最新ニュースをご確認ください。

アンマーシャリング エラー

概要
リクエストの SOAP XML が WSDL 仕様に準拠していません。
一般的な原因
リクエストに、WSDL 仕様に含まれていないフィールドまたはエンティティが含まれているか、間違った名前空間に含まれています。
リクエストで型の不一致があります（整数フィールドに文字列値があるなど）。
推奨される対処方法
リクエストが WSDL 仕様に準拠していることを確認します。
クライアント ライブラリを使用して有効な SOAP を生成し、比較に使用します。すべてのクライアント ライブラリで、SOAP リクエストとレスポンスのロギングがサポートされています。