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

Conversational Analytics 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 一時的なサーバーの問題が発生しています。指数バックオフを利用して、待機と再試行を繰り返してください。エラーが解決しない場合は、バグレポートを提出してください。
UnauthenticatedException UNAUTHENTICATED 401 Unauthorized 16 認証が必要であるか、認証に失敗しました。正しいログイン認証情報、API キー、トークンを使用していることを確認してください。
UnimplementedException UNIMPLEMENTED 501 Not Implemented 12 リクエストされた機能は利用できないか、サポートされていません。この API の呼び出しを避けるか、実装を待機してください。

参考情報

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

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