排解 Conversational Analytics API 錯誤

如果使用對話式數據分析 API 時遇到問題，請參閱下表瞭解可能的解決方案。

錯誤 錯誤原因 HTTP 狀態碼 gRPC 狀態碼 解決方法
AlreadyExistsException ALREADY_EXISTS 409 Conflict 6 資源已存在 (例如，您要建立重複項目)。請使用其他 ID，或確認資源不存在，再建立資源。
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 或網址。請先確認資源存在，再嘗試存取。

如需更多疑難排解資訊，請參閱「對話式數據分析 API 常見問題」。
ServiceUnavailableException UNAVAILABLE 503 Service Unavailable 14 伺服器發生暫時性問題，請稍後再以指數輪詢方式重試。如果錯誤仍未解決，請提交錯誤報告。
Connection reset by peer (串流期間) UNAVAILABLE 503 Service Unavailable 14

如果您使用標準 HTTP 或 REST 用戶端呼叫串流 :chat 端點，伺服器可能在串流期間發生嚴重錯誤 (例如逾時或拒絕存取)。由於系統已傳送 HTTP 標頭，因此真正的錯誤代碼會放在 HTTP/2 尾部，標準 REST 用戶端無法剖析，導致插座損壞。

建議使用官方 Google Cloud gRPC 用戶端程式庫 (例如 Python SDK) 呼叫串流端點。這些程式庫會剖析這些尾隨標頭，並顯示真正的錯誤原因。
Internal error encountered (串流期間) INTERNAL 500 Internal Server Error 13

如果您使用標準 HTTP 或 REST 用戶端呼叫串流 :chat 端點，伺服器可能在串流期間發生嚴重錯誤。由於系統已傳送 HTTP 標頭，因此真正的錯誤代碼會放在 HTTP/2 尾部，標準 REST 用戶端無法剖析，導致插座損壞。

建議使用官方 Google Cloud gRPC 用戶端程式庫 (例如 Python SDK) 呼叫串流端點。這些程式庫會剖析這些尾隨標頭，並顯示真正的錯誤原因。
UnauthenticatedException UNAUTHENTICATED 401 Unauthorized 16 需要驗證身分，或驗證失敗。請確認您使用的登入憑證、API 金鑰或權杖是否正確。
UnimplementedException UNIMPLEMENTED 501 Not Implemented 12 要求的服務無法使用或不支援。請避免呼叫這個 API，或等待實作完成。

其他資源

如需其他疑難排解提示和常見問題解答，請參閱「對話式數據分析 API 常見問題」頁面。

如需如何向 對話式數據分析 API 提出有效問題的指引，請參閱「提出有效問題」說明文件頁面。