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

トラブルシューティング

動画: 2019 年ワークショップのエラー処理の講演を見る

エラーの原因には、不適切な環境設定やソフトウェアのバグ、ユーザーからの無効な入力があります。いずれにしても、そのエラーの原因を突き止めて、コードを修正したり、ユーザーによるエラーを処理するロジックを追加したりする必要があります。このガイドでは Google Ads API のエラーをトラブルシューティングするためのヒントについて説明します。

接続性を確保する

Google Ads API にアクセスできるようにし、正しい設定を行ってください。レスポンスから HTTP エラーが返された場合は、それらに慎重に対処し、使用する予定のサービスにご自身のコードからアクセスしていることを確認してください。
サービスで認証を受けるために、認証情報がリクエストに埋め込まれています。特にクライアントライブラリを使用せずに呼び出しを処理する場合は、Google Ads API のリクエストとレスポンスの構造をよく理解してください。各クライアントライブラリには、設定ファイルに認証情報を含める方法に関する指示が準備されています（クライアントライブラリの README を参照してください）。

正しい認証情報を使用してください。クイックスタートに沿って、必要な正しい認証情報を取得しましょう。たとえば、次のレスポンスエラーは、ユーザーが無効な認証資格情報を送信したことが原因です。

{
  "error": {
    "code": 401,
    "message": "Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential. Visit https://developers.google.com/identity/sign-in/web/devconsole-project.",
    "status": "UNAUTHENTICATED",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.DebugInfo",
        "detail": "Authentication error: 2"
      }
    ]
  }
}

上記の手順を行っても問題が解決しない場合は、Google Ads API のエラーのトラブルシューティングを行います。

問題を判別する

Google Ads API は通常、レスポンス内のエラーのリストを含む JSON エラーオブジェクトとしてエラーを報告します。これらのオブジェクトには、エラーコードと、それが発生した理由を詳しく説明するメッセージが含まれています。これは問題を特定するための最初のヒントになります。

{
  "errors": [
    {
      "errorCode": { "fieldMaskError": "FIELD_NOT_FOUND" },
      "message": "The field mask contained an invalid field: 'keyword/matchtype'.",
      "location": { "operationIndex": "1" }
    }
  ]
}

すべてのクライアントライブラリは例外をスローします。レスポンス内のエラーをカプセル化しますこれらの例外をキャプチャして、ログまたはトラブルシューティング画面にメッセージを出力することから始めましょう。この情報を、Cloud Monitoring、Cloud Logging、何が問題の原因なのかを大まかに把握することができます。ログでエラーを特定したら、説明します。

エラーの調査

一般的なエラーをご覧ください。ドキュメントをご覧ください。これは、エラーメッセージ、関連する API リファレンス、回避策やエラーを処理します。
よくあるエラーに関するドキュメントにエラーが具体的に記載されていない場合は、リファレンスドキュメントをお調べのうえ、エラー文字列を見つけてください。
サポートチャンネルで、API での経験を共有している他のデベロッパーを検索してください。同じ問題に遭遇し、それを解決した可能性があります。
記載されていないエラーが発生した場合は、関心が高まっています。
検証やアカウント制限の問題のトラブルシューティングについては、Google 広告のヘルプセンターをご覧ください。Google Ads API は、Google 広告サービスの主なルールと制限を継承しています。
ブログ投稿がアプリケーションのトラブルシューティングの参考になる場合もあります。

エラーを調査したら、根本的な原因を特定します。

原因を特定する

例外メッセージを調べて、エラーの原因を調べます。レスポンスを確認してから、リクエストを調べて、考えられる原因を探します。Google Ads API: 一部のエラーメッセージに fieldPathElements が含まれる location GoogleAdsError は、発生したエラーが表示されます。例:

{
  "errors": [
    {
      "errorCode": {"criterionError": "CANNOT_ADD_CRITERIA_TYPE"},
      "message": "Criteria type can not be targeted.",
      "trigger": { "stringValue": "" },
      "location": {
        "operationIndex": "0",
        "fieldPathElements": [ { "fieldName": "keyword" } ]
      }
    }
  ]
}

問題のトラブルシューティングを行う際、アプリケーションが誤った情報を API に渡してしまう可能性があります。Google では、インタラクティブな Classroom API を使用して、 Eclipse（無料）などの開発環境（IDE）オープンソース IDE です。主に Java の開発に使用されますが、デバッグに役立ちます。IDE では、ブレークポイントを設定したり、コードを 1 行ごとにステップ実行したりすることができます。

リクエストがアプリケーションの入力と一致していることを確認します（たとえば、キャンペーンの名前がリクエストと一致するようにしてください）。確認事項メッセージを送信してフィールドマスク Google Ads API ではスパースアップデートがサポートされています。変更リクエストでフィールドマスクからフィールドを省略すると、そのままにしておく必要がありますアプリがオブジェクトを取得して変更を行う場合、そうでないフィールドに書き込む場合、サポートの更新が必要です。リファレンスでフィールドの説明を確認します。ドキュメントを参照し、いつ、またはいつ利用できるかに関する制限事項があるかどうかを確認してください。フィールドを更新できます

サポートの利用方法

問題を自分で特定して解決できるとは限りません。フォーラムで質問すると、数千人の開発者が同じような問題にあります。

質問にはできるだけ多くの情報を含めるようにしてください。たとえば、次のような項目を含めることをお勧めします。

不要な情報を削除した JSON リクエストとレスポンス - 開発者トークンや AuthToken などの機密情報は忘れずに削除してください。
コードスニペット - 言語固有の問題や API の操作についてのサポートを求めている場合は、コードのスニペットを提供すると、行おうとしていることの説明に役立ちます。
RequestId - 本番環境でのリクエストであれば、この情報は、Google Developer Relations チームのメンバーがリクエストを探し出すのに役立ちます。ログにプロパティとして requestId を登録することをおすすめします。ログはレスポンスエラーの不要な情報を削除した例外が含まれているだけでなく、requestId 単独の場合よりも多くの情報を得られるからです。
ランタイムやインタープリターのバージョンやプラットフォームなどの補足情報もトラブルシューティングの役に立ちます。

問題の解決方法

問題を特定でき、解決方法が判明したら、実際に修正を加えて修正箇所をテストします。このとき、できればテストアカウントを使用することをおすすめします。ただし、特定の本番用アカウントのデータにのみ起こるバグの場合には、本番環境でテストする必要があります。

共有する

これまでにフォーラムに投稿したエラーに関して、ソリューションが見つかったら使用します。開発者は次回同じ問題に直面したときに解決できるすぐに使えます

次のステップ

問題の解決の過程で、コードを改良して問題の発生を未然に防ぐ方法がみつかる場合があります。

適切な一連の単体テストを作成することで、コードの品質と信頼性を大幅に向上させることができます。また、新しい変更をもすぐにテストできるため、以前の機能を壊すことがありません。優れたエラー処理戦略は、トラブルシューティングに必要なすべてのデータを表示する際に重要です。

システム制限

テスト