ディスプレイとVideo 360 API v2 は 2024 年 9 月 3 日に廃止されます。サービスの中断を避けるため、期日までに v3 に移行してください。

このページは Cloud Translation API によって翻訳されました。

エラーと警告

このページでは、発生する可能性のあるさまざまなエラーと警告について説明します。ディスプレイ &ビデオ 360 の使用とVideo 360 API。

API エラー

API に対するリクエストを完了できないと、エラーメッセージが返されます。エラーを返すリクエストはユーザー割り当てにカウントされ、追加の割り当てのリクエストを確認する際に考慮すべき点です。エラーレスポンス将来のエラーを防ぐために処理する必要があります

エラーレスポンスは次の形式を取り、HTTP レスポンスコード、エラーメッセージ、Google RPC コードステータスが返されます。

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

以下に、一般的な API エラーと推奨される対応の一覧を示します。返される場合は次のようになります。

コード	RPC	推奨される対応
`400`	`INVALID_ARGUMENT`	リクエストになんらかの問題があります。詳しくは、メッセージフィールドを確認し、必要に応じてそれに応じてリクエストに応じて変更する必要があります
`401`	`UNAUTHENTICATED`	リクエストを正しく認証できませんでした。有効な OAuth が含まれていることを確認する認証情報を指定できます。詳細情報ご参照ください。スタートガイド
`403`	`PERMISSION_DENIED`	完了に必要な権限がありません表示されます。ユーザーアカウントの関連するパートナーや広告主
`404`	`NOT_FOUND`	取得しようとしているリソースは、見つけることができます。使用している ID が取得するリソースタイプを定義します。
`409`	`ABORTED`	変更しようとしているリソースは、他の場所で変更されます数秒待ってから、リクエストを再試行します。
`429`	`RESOURCE_EXHAUSTED`	上限を超えましたレート制限または 1 日あたりのリクエスト割り当て。次を使用して API の使用状況を調べる Google API Console に移動し、ワークフローが既存の割り当て内で動作するようにできます。詳細については、当社のページをご覧ください。割り当ての最適化をご覧ください。オペレーションを完了できない場合割り当てられている場合は、追加の割り当てをリクエストしてください。
`500`	`INTERNAL`	API で内部エラーが発生しました。少々お待ちくださいリクエストを再試行します。エラーが問題が解決しない場合は、サポートにお問い合わせください。
`504`	`DEADLINE_EXCEEDED`	API でリクエストの完了に時間がかかりすぎた。数秒待ってから、リクエストを再試行します。条件エラーが解決しないサポートにお問い合わせください。

SDF エラー

ディスプレイとVideo 360 API は以下の処理に非同期メソッドを使用します。構造化データファイル（SDF）の生成とダウンロード今回 SDF ファイルの生成中にスローされたエラーが、完成した SDF で返されます。ダウンロードタスクを実行します。errorで終了する SDF のダウンロードタスクは次のようになります。完了とマークされているが、メディアリソース名の代わりにエラーフィールドが入力されている次の省略例をご覧ください。response

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

SDF を生成しようとしたときに対処可能なエラーメッセージが表示された場合は、それに応じて従う必要がありますエラーメッセージに明らかに対応できない場合は、次の対応を行うことをおすすめします。

ユーザーが保護者の権限に対して適切な権限を持っていることを確認してくださいパートナーまたは広告主のリソースをご覧ください。
フィルタで指定された ID が正しいことを確認します。対応していて、かつ、スコープ内のリソースブロックの指定されたルート ID。
SDF の同時ダウンロードの上限（20 個）を超えていないことを確認してくださいできます。

それでもエラーが解消されない場合は、サポートにお問い合わせください。特定します

ブロックしない警告

ブロックしない警告は、広告申込情報に問題が発生したとします同様の警告が通知される通知バナーで表示できます。これらの警告は受動的なものであり、広告申込情報の warningMessages フィールド。

このような警告の原因となる問題は受動的ではあるものの、広告の配信に影響する配信を完全に防ぐことも可能です

予防

ブロックされない警告の原因となる問題の多くは、適切な対策を講じることで回避できます。次のような項目の設定を行います。

掲載期間: 広告申込情報の掲載期間が無効、または親広告掲載オーダーの掲載期間が期限切れになると、広告申込情報では警告は表示されません後者の問題を回避するには、アイテムの掲載期間が親挿入の掲載期間より後に終了していないできます。
割り当てられたクリエイティブ: 有効なクリエイティブがない場合割り当てられている場合、その広告申込情報では警告が生成され、提供します。
ターゲティング: 広告申込情報のターゲティングが適切に割り当てられていない場合、広告申込情報に対して警告が生成され、影響するか完全に防ぐかです

既存の広告申込情報から設定を複製する場合は、既存の広告申込情報で予期しない警告が発生していない。

モニタリング

広告申込情報の配信中に、妨げになる警告の原因となる問題が発生する場合がありますあります。広告申込情報が正しく配信されていることを確認するには、新しく生成された警告がないか、有効な広告申込情報を確認してください。広告申込情報は advertisers.lineItems.list 関数を使用して一括で作成できます。条件広告申込情報で予期しない警告が生成されている場合は、この問題を修正する必要があります。配信への影響を軽減できます

広告申込情報の設定やターゲティングが変更されていなくても、問題が発生することがあります。たとえば、親広告掲載オーダーの一時停止や期限切れ、ユーザーリストやその他のターゲティングのサポート終了。