一般的なエラー

このページでは、Google Ad Manager API でよく発生するエラーについて説明します。エラーは Error.REASON の形式で返されます。

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

EntityChildrenLimitReachedError

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

割り当てエラー

QuotaError.EXCEEDED_QUOTA

まとめ
1 秒あたりのリクエスト数が多すぎて、許容上限を超えました。
推奨される対処方法
  • ローカルで変更を 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 リクエスト ヘッダーと SOAP レスポンス ヘッダーのページをご覧ください。

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 呼び出しのバージョンは非推奨になりました。サポート終了については、Google のブログを定期的にご覧ください。
  • リクエストを正常に実行するには、新しいバージョンの API が必要です。 よくあるケースとして、UI に機能が導入されています。API でオブジェクトを正しく送信するには、新しいバージョンの API が必要です。
推奨される対処方法
  • API バージョンを最新の状態に保ち、定期的なアップグレードを計画します。
  • サポートの終了については、Google のブログを定期的にご確認ください。

404 エラー

まとめ
リクエストがサーバーに到達しませんでした。
一般的な原因
インターネット接続またはプロキシが正しく構成されていない可能性があります。また、呼び出している API のバージョンも廃止される可能性があります。
推奨される対処方法
インターネットまたはプロキシの構成を確認し、最新バージョンの API を使用していることを確認します。クライアント ライブラリも最新バージョンにアップグレードすることをおすすめします。
感染予防のヒント
Ad Manager API フォーラムを購読するとともに、ブログで Ad Manager API の最新情報をご確認ください。

マーシャリング解除エラー

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