API の使用に関するトラブルシューティング

このページでは、アプリケーション開発者向けに、Google API と Google Cloud API の使用のトラブルシューティング方法の概要を説明します。

背景

Google API は、Google サービスが提供するネットワーク API です。アプリケーションは、さまざまな環境で JSON HTTP と gRPC を介して Google API にアクセスできます。デベロッパーの方は、アプリケーションで Google が提供するクライアント ライブラリを使用することをおすすめします。これらのライブラリは、ページ分けなどの一般的なボイラープレート ロジックを実装しているため、開発のオーバーヘッドやよくある間違いを大幅に削減します。

詳しくはクライアント ライブラリの説明をご覧ください。

ご利用方法

Google API を初めて使用する場合は、スタートガイドページに従って、アプリケーションの準備手順を完了する必要があります。まず curl -v コマンドを使用して、使用する Google API にテスト リクエストを送信します。コードを記述しなくても Google API を試すことができます。多くの場合、実際のアプリケーション開発を開始する前に多くの問題を解決できます。

詳しくは、スタートガイドをご覧ください。

指標を使用したトラブルシューティング

Google API では、リクエスト数、エラー、レイテンシ、リクエストとレスポンスのサイズなど、API の使用に関する一般的な側面を対象とする無料の API 指標を提供しています。アプリケーションとロケーションに関するきめ細かいディメンションが提供されます。デベロッパーは、異常な API 使用を発見し、潜在的な根本原因を特定できます。たとえば、エラーコードが 400 を超えると、最近更新されたアプリケーションに論理的なバグがあるか、リクエストとレスポンスのサイズが大きくなり、システム負荷が増加する可能性があることを意味します。

詳細については、API 使用状況のモニタリングをご覧ください。

ログを使用したトラブルシューティング

セキュリティとプライバシーを保護するため、Google API は通常、アプリケーション デベロッパーに API ログを提供しません。アプリケーション デベロッパーがクライアント側で API エラーを記録することを強くおすすめします。エラーはローカル ストレージまたは Cloud Logging API に記録できます。

ログには通常、エラー メッセージやエラーの詳細など、指標よりも詳細なエラーに関する情報が含まれます。これは非常に有益で、API エラーのトラブルシューティングに必要になることがよくあります。デベロッパーが API の使用に関する問題に気付いた場合、ログをクエリしてエラー メッセージとエラーの詳細を確認し、その情報を使用してエラーを解決したり、サポートに問い合わせたりできます。

Cloud Audit Logs

セキュリティ上重要なアクティビティの場合、Google Cloud プロダクトはアクティビティに関する詳細情報を含む監査ログを生成することがあります。Google Cloud API の使用状況のトラブルシューティングに役立つ情報が提供されます。たとえば、VPC Service Control のドライラン機能では、管理者向けに今後のポリシー変更を評価する監査ログが生成されます。

詳しくは、Cloud Audit Logs をご覧ください。

エラーの解決

Google API の使用状況に問題があり、対応する指標とログが見つかった場合は、API 設計ガイドのエラーページに従ってエラーを解決できます。

一般に、各 API エラーには、エラーコード、エラー メッセージ、エラーの詳細の 3 つの部分があります。

  • エラーコードを使用すると、アプリケーションでより高いレベルでエラーを処理できます(401403 など)。
  • このエラー メッセージによって、アプリケーション デベロッパーはエラーを理解し、アプリケーション ロジックを手動で修正できます。警告: エラー メッセージに対してコーディングしないでください。エラーは予告なく変更される場合があります。
  • エラーの詳細には、アプリケーションでエラーをプログラムによって処理するために使用できる追加情報が含まれます。

詳細については、エラーページをご覧ください。