エラーと警告

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

API エラー

API に対して完了できないリクエストを送信すると、エラーメッセージが返されます。エラーを返すリクエストはユーザーの割り当てにカウントされ、割り当ての追加リクエストの審査時に考慮されます。今後のエラーを回避するために、エラーレスポンスを処理して処理する必要があります。

エラーレスポンスの形式は次のとおりです。HTTP レスポンスコード、エラーメッセージ、Google RPC コードステータスが含まれます。

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

一般的な API エラーと、エラーが返された場合に推奨される対応方法を以下に示します。

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

SDF エラー

Display & 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 件）を超えていないことを確認します。

それでもエラーが解消されない場合は、サポートにお問い合わせのうえ、問題をお知らせください。

非ブロッキング警告

非ブロック型の警告は、広告申込情報の配信に影響する可能性のある問題を示すために広告申込情報に割り当てられます。同様の警告は、UI の通知バナーで通知されます。これらの警告は受動的で、広告申込情報の warningMessages フィールドに表示されます。

これらの警告の原因となる問題は、パッシブですが、広告申込情報の配信に影響し、配信が完全に停止することもあります。

予防

非ブロッキング警告の原因となる多くの問題は、広告申込情報の設定を適切に構成することで回避できます。次に例を示します。

掲載期間: 広告申込情報の掲載期間が無効である場合、または親の広告掲載オーダーの掲載期間が終了している場合、広告申込情報は警告を生成し、配信されません。後者の問題を回避するには、広告申込情報の掲載期間が親の広告掲載オーダーの掲載期間より遅くならないようにしてください。
割り当てられたクリエイティブ: 広告申込情報に有効なクリエイティブが割り当てられていない場合、広告申込情報は警告を生成し、配信されません。
ターゲティング: 広告申込情報のターゲティングが正しく割り当てられていない場合、広告申込情報に警告が表示され、配信に影響が及ぶか、配信が完全に妨げられる可能性があります。

既存の広告申込情報から設定を複製する場合は、既存の広告申込情報で予期しない警告が生成されていないことを確認してください。

モニタリング

広告申込情報の配信中に、非ブロッキング警告の原因となる問題が発生することがあります。広告申込情報が正しく配信されるように、有効な広告申込情報で新たに生成された警告をモニタリングします。項目は、advertisers.lineItems.list 関数を使用して一括取得できます。広告申込情報で予期しない警告が発生した場合は、配信への影響を軽減するために、すぐに問題に対処する必要があります。

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