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을 확인합니다. 리소스에 액세스하기 전에 리소스가 있는지 확인합니다. 문제 해결에 관한 자세한 내용은 Conversational Analytics API에 관한 자주 묻는 질문(FAQ)을 참조하세요. |
ServiceUnavailableException
|
UNAVAILABLE
|
503 Service Unavailable
|
14 | 일시적인 서버 문제가 있습니다. 기다렸다가 시도 사이에 지수 백오프로 다시 시도합니다. 오류가 계속되면 버그 신고를 제출하세요. |
Connection reset by peer (스트리밍 중)
|
UNAVAILABLE
|
503 Service Unavailable
|
14 |
표준 HTTP 또는 REST 클라이언트를 사용하여 스트리밍 스트리밍 엔드포인트를 호출하려면 Python SDK와 같은 공식 Google Cloud gRPC 클라이언트 라이브러리를 사용하는 것이 좋습니다. 이러한 라이브러리는 이러한 후행 헤더를 파싱하고 실제 오류 원인을 표시합니다. |
Internal error encountered (스트리밍 중)
|
INTERNAL
|
500 Internal Server Error
|
13 |
표준 HTTP 또는 REST 클라이언트를 사용하여 스트리밍 스트리밍 엔드포인트를 호출하려면 Python SDK와 같은 공식 Google Cloud gRPC 클라이언트 라이브러리를 사용하는 것이 좋습니다. 이러한 라이브러리는 이러한 후행 헤더를 파싱하고 실제 오류 원인을 표시합니다. |
UnauthenticatedException
|
UNAUTHENTICATED
|
401 Unauthorized
|
16 | 인증이 필요하거나 인증에 실패했습니다. 올바른 로그인 사용자 인증 정보, API 키 또는 토큰을 사용하고 있는지 확인합니다. |
UnimplementedException
|
UNIMPLEMENTED
|
501 Not Implemented
|
12 | 요청한 기능을 사용할 수 없거나 요청한 기능이 지원되지 않습니다. 이 API를 호출하지 않거나 구현을 기다리세요. |
추가 리소스
추가 문제 해결 도움말과 자주 묻는 질문(FAQ)에 대한 답변은 Conversational Analytics API에 관한 자주 묻는 질문(FAQ) 페이지를 참조하세요.
Conversational Analytics API에 효과적으로 질문하는 방법에 관한 안내는 효과적으로 질문하기 문서 페이지를 참조하세요.