よくある間違い

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

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

EntityChildrenLimitReachedError

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

割り当てエラー

QuotaError.EXCEEDED_QUOTA

概要
1 秒あたりのリクエスト数が多すぎて、許容上限を超えています。
推奨される対処方法
  • updateLineItems などのバッチメソッドを使用します。変更をローカルで収集し、1 つのリクエストを送信して、それらの変更を一度にすべて適用します。
  • 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

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

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 を使用していることを確認します。クライアント ライブラリも最新バージョンにアップグレードすることをおすすめします。
対策のヒント
Ad Manager API の最新ニュースについては、アド マネージャー ヘルプ コミュニティとブログをご覧ください。

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

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