トラブルシューティング

Display & Video 360 API の使用時にエラーが発生するシナリオは多数あります。原因としては、コードのバグ、無効なユーザー入力、API 自体の問題が考えられます。理由が何であれ、エラーのトラブルシューティング方法を理解することは、開発プロセスの重要な部分です。このガイドでは、作業を開始する際に役立つおすすめの方法をいくつか紹介します。

基本の確認

  1. 前提条件ガイドを確認してください。ディスプレイ &ビデオ 360 にアクセスできることと、適切に設定された API プロジェクトにアクセスできることを確認してください。
  2. レスポンスに HTTP エラーが含まれている場合は、そのエラーを慎重に確認し、正しい API およびサービスにリクエストが行われるようにしてください。
  3. 承認ガイドを確認してください。必要な OAuth 2.0 認証情報がリクエストに含まれていることを確認してください。

  4. 正しい認証情報を使用していることを確認してください。認証情報の生成について詳しくは、アプリケーションの設定ガイドをご覧ください。また、アクセス トークンを Google OAuth2 API の tokeninfo エンドポイントに渡して、正しい API プロジェクトに対して発行され、正しいスコープに対して承認されていることを確認することもできます。

    POST https://www.googleapis.com/oauth2/v2/tokeninfo?access_token={YOUR_ACCESS_TOKEN}

200 OK

{
 "issued_to": "{API_PROJECT_CLIENT_ID}",
 "audience": "...",
 "scope": "{API_SCOPES}",
 "expires_in": ...
}

エラーについて

API でエラーが発生すると、通常は error オブジェクトを含む JSON レスポンスが返されます。このオブジェクトは、発生した特定のエラーに関する追加のコンテキストを提供します。

{
 "error": {
  "code": 404,
  "message": "Resource type LINE_ITEM does not exist: advertisers/1/lineItems/1",
  "status": "NOT_FOUND"
 }
}

通常、error オブジェクトのコンテンツには、問題の原因を特定するのに十分な情報が含まれています。そうでない場合は、エラーの意味を理解するために追加調査が必要になることがあります。

エラーの調査

  1. 一般的なエラーのセクションを参照してください。最も頻繁に発生するエラーの詳細が記載されています。

  2. 一般的なエラーのセクションにエラーが記載されていない場合は、リファレンス ドキュメントを参照してエラーコード、ステータス、メッセージを検索してください。

  3. 記載されていないエラーを見つけた場合は、Google までご連絡ください。

根本原因の特定

ここまでで、エラーを特定し、その意味を理解できました。確認できない場合は、エラーについてに戻ってください。また、自分で修正できないエラーが API にあると思われる場合は、サポートに進んでください。

エラーを修正する前に、その原因を特定する必要があります。多くの場合、コードのバグや無効な入力値が原因です。

問題がコードのバグに関連しているかどうかを判断するには、まずコードが意図したとおりに機能していることを確認する必要があります。最初のステップとして、失敗したリクエストを行うコードのセクションを確認して、明らかな問題がないかどうかを確認してください。場合によっては、デバッグツールを使用してコードを 1 行ずつ実行し、正しく機能していることを確認する必要があります。

HTTP リクエストを調べると、潜在的なバグや無効な入力の可能性を特定できます。公式のクライアント ライブラリの多くは、HTTP のリクエストとレスポンスをログに記録するように構成できます。詳細については、選択したライブラリのドキュメントをご覧ください。Charles、Squid、Fiddler などの HTTP プロキシを使用して、リクエストとレスポンスのログをキャプチャすることもできます。ログを取得したら、アプリケーションからリクエスト パラメータ値が正しく、想定どおりであることを確認します。

エラーの原因となっているバグや無効な入力を特定すれば、修正は明白でしょう。ただし、行き詰まった場合や、問題を解決する最適な方法がわからない場合は、これまでに収集した情報を参考にできます。

参考情報

ご自身でエラーを解決できない場合は、ディスプレイ&ビデオ 360 ヘルプセンターのフォームからサポートチームにお問い合わせください。

このフォームにご記入いただく際は、発生している問題と、すでに試したトラブルシューティングの手順について、できるだけ多くの情報を入力してください。次の情報を含めることをおすすめします。

  • HTTP リクエストとレスポンスのログ。OAuth 2.0 アクセス トークンやメールアドレスなどの機密情報は必ず削除してください。
  • コード スニペット問題をコードの特定のセクションに特定できる場合や、問題が言語固有のものであると思われる場合は、作業内容を示す小さなスニペットを含めてください。
  • ランタイム/インタープリタのバージョンやプラットフォームなどの追加情報。問題を再現しようとするユーザーに役立つ可能性があります。

問題の解決

問題の原因を特定し、解決策を見出したら、修正を行います。可能であれば、本番環境にデプロイする前に、制御された環境（テスト用に構成されたパートナーや広告主など）でさまざまな良好な入力と不良な入力の両方に対して修正をテストします。