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

エラーと警告

このページでは、Display & 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 日のリクエストの割り当てを超過した。Google API Console を使用して API の使用状況を確認し、既存の割り当て上限内で動作するようにワークフローを変更します。詳細については、割り当ての最適化のページをご覧ください。与えられた 1 日の割り当て内でオペレーションを完了できない場合は、追加の割り当てをリクエストできます。
`500`	`INTERNAL`	API で内部エラーが発生しました。数秒待ってから、リクエストを再試行します。エラーが解決しない場合は、サポートにお問い合わせください。
`504`	`DEADLINE_EXCEEDED`	API がリクエストを完了するのに時間がかかりすぎました。数秒待ってから、リクエストを再試行してください。エラーが解決しない場合は、サポートにお問い合わせください。

SDF のエラー

Display & Video 360 API は、非同期メソッドを使用して構造化データファイル（SDF）を生成、ダウンロードします。このため、SDF の生成中にスローされたエラーは、完了した SDF ダウンロードタスクで返されます。SDF ダウンロードタスクが error で終了した場合、完了とマークされますが、以下の簡略化した例に示すように、response フィールドにメディアリソース名の代わりにエラーフィールドが入力されます。

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

SDF を生成する際に、対処可能なエラーメッセージが表示された場合は、それに沿って対応してください。エラーメッセージの内容がすぐに実用的でない場合は、次の対応を行うことをおすすめします。

親パートナーまたは広告主のリソースに対して適切な権限がユーザーに付与されていることを確認してください。
フィルタで指定された ID が正確であること、目的のリソースタイプに対応しており、指定されたルート ID のコンテキスト内にあることを確認します。
1 ユーザーあたりの SDF 同時ダウンロードタスクの数が、上限（20 個）を超えていないことを確認します。

それでもエラーが解決しない場合は、サポートに連絡して問題を報告してください。

ブロックしない警告

妨げになる警告は、広告申込情報の配信に影響する可能性のある問題を示すために、広告申込情報に割り当てられています。同様の警告は、UI に通知バナーを介して通知されます。この警告は消極的であり、広告申込情報の warningMessages フィールドに表示されます。

これらの警告が発生する問題は受動的なものですが、広告申込情報の配信を完全に停止できるほど大きく影響する場合があります。

防止

表示を妨げる警告の原因となる問題の多くは、以下のように広告申込情報を適切に設定することで回避できます。

掲載期間: 広告申込情報の掲載期間が無効である場合や、親広告掲載オーダーの掲載期間が期限切れである場合、広告申込情報は警告となり配信されません。後者の問題を回避するには、広告申込情報の掲載期間の終了日が、親広告掲載オーダーの掲載期間の終了時刻より後になるようにしてください。
割り当て済みのクリエイティブ: 広告申込情報に有効なクリエイティブが割り当てられていない場合、警告が生成され、配信されません。
ターゲティング: 広告申込情報のターゲティングが正しく割り当てられていないと、広告申込情報に警告が表示され、配信が全面的に影響を受けたり、ブロックされたりすることがあります。

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

モニタリング

広告配信の途中に、ブロック以外の警告が発生する問題が発生することがあります。広告申込情報が正しく配信されていることを確認するには、有効な広告申込情報に新たに生成された警告がないか監視してください。広告申込情報は、advertisers.lineItems.list 関数を使用して一括で取得できます。広告申込情報で予期しない警告が生成されている場合は、配信への影響を抑えるため、問題にすぐに対処してください。

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