Conversational Analytics API エラーのトラブルシューティング

会話型分析 API の使用中に問題が発生した場合は、次の表で解決策を確認してください。

エラー エラーの原因 HTTP ステータス コード gRPC ステータス コード 解決策
AlreadyExistsException ALREADY_EXISTS 409 Conflict 6 リソースがすでに存在しています(重複するエントリを作成しているなど)。別の識別子を使用するか、リソースを作成する前に、リソースがまだ存在していないことを確認してください。
BadRequestException INVALID_ARGUMENT 400 Bad Request 3 入力が無効であるか、形式が正しくありません。リクエストを送信する前に、入力またはペイロードを検証してください。
ForbiddenException PERMISSION_DENIED 403 Forbidden 7 認証はされていますが、リソースへのアクセスは許可されていません。ユーザーロールと権限を確認します。必要に応じて管理者にお問い合わせください。
FailedPreconditionException FAILED_PRECONDITION 400 Bad Request 9 リクエストがシステム状態に違反しています(空でないフォルダを削除しようとしているなど)。前提条件を確認し、ロジックを修正してください。
NotFoundException NOT_FOUND 404 Not Found 5

リソースが見つかりません。リソース ID または URL を確認します。リソースにアクセスする前に、リソースが存在していることを確認してください。

トラブルシューティングの詳細については、会話分析 API に関するよくある質問をご覧ください。

ServiceUnavailableException UNAVAILABLE 503 Service Unavailable 14 一時的なサーバーの問題が発生しています。指数バックオフを利用して、待機と再試行を繰り返してください。エラーが解決しない場合は、バグレポートを提出してください。
Connection reset by peer(ストリーミング中) UNAVAILABLE 503 Service Unavailable 14

標準の HTTP または REST クライアントを使用してストリーミング :chat エンドポイントを呼び出すと、ストリーム中にサーバーで致命的なエラー(タイムアウトや権限拒否など)が発生した可能性があります。HTTP ヘッダーはすでに送信されているため、実際のエラーコードは HTTP/2 トレーラーに配置されます。標準の REST クライアントはこれを解析できないため、ソケット クラッシュが発生します。

ストリーミング エンドポイントを呼び出すには、Python SDK などの公式の Google Cloud gRPC クライアント ライブラリを使用することをおすすめします。これらのライブラリは、これらのトレーリング ヘッダーを解析し、実際のエラーの原因を特定します。

Internal error encountered(ストリーミング中) INTERNAL 500 Internal Server Error 13

標準の HTTP または REST クライアントを使用してストリーミング :chat エンドポイントを呼び出すと、ストリーム中にサーバーで致命的なエラーが発生する可能性があります。HTTP ヘッダーはすでに送信されているため、実際のエラーコードは HTTP/2 トレーラーに配置されます。標準の REST クライアントはこれを解析できないため、ソケット クラッシュが発生します。

ストリーミング エンドポイントを呼び出すには、Python SDK などの公式の Google Cloud gRPC クライアント ライブラリを使用することをおすすめします。これらのライブラリは、これらのトレーリング ヘッダーを解析し、実際のエラーの原因を特定します。

UnauthenticatedException UNAUTHENTICATED 401 Unauthorized 16 認証が必要であるか、認証に失敗しました。正しいログイン認証情報、API キー、トークンを使用していることを確認してください。
UnimplementedException UNIMPLEMENTED 501 Not Implemented 12 リクエストされた機能は利用できないか、サポートされていません。この API の呼び出しを避けるか、実装を待機してください。

参考情報

トラブルシューティングのヒントやよくある質問への回答については、会話分析 API に関するよくある質問ページをご覧ください。

会話分析 API への効果的な質問については、効果的な質問をするドキュメント ページをご覧ください。