Display & Video 360 API は、さまざまなエラーと警告を返します。健全な API ソリューションは、これらのエラーを処理する必要があります。
API エラー
目的のアクションを実行できなかった API へのリクエストは、エラーを返します。エラー レスポンスはキャッチして処理する必要があります。
API エラー レスポンスには、HTTP レスポンス コード、エラー メッセージ、Google RPC コード ステータスが含まれます。次の形式となります。
{
"error": {
"code": integer,
"message": string,
"status": enum (google.rpc.Code)
}
}
一般的な API エラーと推奨される対応は次のとおりです。
| エラーコード | |
|---|---|
400 |
INVALID_ARGUMENTリクエストに問題があります。エラー レスポンスのメッセージ フィールドを確認し、リクエストを適宜更新します。 |
401 |
UNAUTHENTICATEDリクエストを正しく認証できませんでした。リクエストに有効な OAuth 認証情報が含まれていることを確認します。詳しくは、クイックスタート ガイドをご覧ください。 |
403 |
PERMISSION_DENIEDリクエストを完了するために必要な権限がありません。関連するパートナーまたは広告主に対して、ユーザー アカウントに適切な権限があることを確認します。 |
404 |
NOT_FOUND取得しようとしているリソースが見つかりません。使用している ID が正しく、取得するリソースタイプのものであることを確認します。 |
409 |
ABORTED変更しようとしているリソースが別の場所で変更されています。数秒待ってから、リクエストを再試行します。 |
429 |
RESOURCE_EXHAUSTEDレート制限または 1 日あたりのリクエスト割り当てを超えています。Google Cloud コンソールを使用して、API の使用状況を確認します。既存の割り当て上限内で実行するようにワークフローを更新します。詳細については、使用量の最適化に関するガイドをご覧ください。 |
500 |
INTERNALAPI で内部エラーが発生しました。数秒待ってから、リクエストを再試行します。エラーが解消されない場合は、サポートまでお問い合わせください。 |
504 |
DEADLINE_EXCEEDEDAPI がリクエストの完了に時間がかかりすぎました。数秒待ってから、リクエストを再試行します。エラーが解消されない場合は、サポートまでお問い合わせください。 |
SDF エラー
ディスプレイ＆ビデオ 360 API は、長時間実行タスクを使用して構造化データファイル（SDF）を生成します。SDF の作成中に発生したエラーは、完了した operation で返されます。error フィールドに詳細が含まれます。次の例をご覧ください。
{
...
"done": true,
"error": {
"code": 3,
"message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
}
}
エラー メッセージが明確でない場合は、次のことをおすすめします。
- ユーザーに、親のパートナーまたは広告主に対する標準ユーザーの役割が少なくとも割り当てられていることを確認します。
- フィルタで指定された ID が正確であることを確認します。ID は、目的のリソースタイプに対応し、ルート ID の子リソースである必要があります。
- ユーザーの同時 SDF ダウンロード タスクが 20 個未満であることを確認します。
その後もエラーが表示される場合は、サポートにお問い合わせください。
移行の妨げにならない警告
非ブロック警告は、広告配信に影響する可能性のある問題が広告申込情報に発生していることを示します。同様の警告が UI に表示されます。これらの警告は受動的で、広告申込情報に表示されます。
警告の根本原因は、広告申込情報の配信に影響する可能性があります。場合によっては、広告の配信が完全に停止する可能性があります。
予防
ブロックされない警告の一部は、広告申込情報の構成ミスが原因で発生します。
- 掲載期間: 広告申込情報の掲載期間が無効な場合、または広告掲載オーダーの掲載期間が終了している場合、広告申込情報は広告を配信しません。広告申込情報の掲載期間が、広告掲載オーダーの掲載期間内であることを確認します。
- 割り当てられたクリエイティブ: 有効なクリエイティブが割り当てられていない場合、広告申込情報は配信されません。
- ターゲティング: 広告申込情報のターゲティングが正しく割り当てられていない場合、広告申込情報の広告配信に影響が出たり、配信が完全に停止したりする可能性があります。
新しい広告申込情報で既存の広告申込情報の構成を使用する前に、既存の広告申込情報で警告が生成されていないことを確認します。
モニタリング
広告申込情報の配信中に、ブロックされない警告が表示されることがあります。有効な広告申込情報をモニタリングして、新しい警告がないか確認し、広告申込情報が正しく配信されていることを確認します。list リクエストを使用して広告申込情報を一括で取得します。広告申込情報で予期しない警告が返された場合は、配信への影響を軽減するため、できるだけ早く問題に対処してください。
設定やターゲティングが変更されていない場合でも、警告が追加されることがあります。たとえば、次のような場合です。
- 広告掲載オーダーが一時停止または期限切れになっている。
- ユーザーリストまたはターゲティング オプションのサポートが終了しています。