Resolver erros da API Conversational Analytics

Visualizar

Esse produto ou recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos gerais de serviço" dos Termos específicos de serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Se você encontrar problemas ao usar a API Análises de conversação, consulte a tabela a seguir para encontrar possíveis soluções.

**Observação**: para enviar feedback ou solicitar suporte para esse recurso, envie um e-mail para [e-mail].

Erro	Causa do erro	Código de status HTTP	Código de status gRPC	Resolução
AlreadyExistsException	ALREADY_EXISTS	409 Conflict	6	O recurso já existe (por exemplo, você está criando uma entrada duplicada). Use um identificador diferente ou confirme se o recurso ainda não existe antes de criá-lo.
BadRequestException	INVALID_ARGUMENT	400 Bad Request	3	A entrada é inválida ou está incorreta. Valide as entradas ou os payloads antes de enviar a solicitação.
ForbiddenException	PERMISSION_DENIED	403 Forbidden	7	Você tem autenticação, mas não tem permissão para acessar o recurso. Verifique seu papel e suas permissões de usuário. Entre em contato com um administrador, se necessário.
FailedPreconditionException	FAILED_PRECONDITION	400 Bad Request	9	A solicitação viola o estado do sistema (por exemplo, tentar excluir uma pasta que não está vazia). Confira as condições prévias e corrija a lógica.
NotFoundException	NOT_FOUND	404 Not Found	5	O recurso não foi encontrado. Verifique os IDs ou URLs dos recursos. Confirme se o recurso existe antes de tentar acessá-lo. Consulte as Perguntas frequentes sobre a API Conversational Analytics para mais informações sobre solução de problemas.
ServiceUnavailableException	UNAVAILABLE	503 Service Unavailable	14	Há um problema temporário no servidor. Aguarde e tente de novo com uma espera exponencial entre as tentativas. Se o erro persistir, envie um relatório de bug.
Connection reset by peer (durante o streaming)	UNAVAILABLE	503 Service Unavailable	14	Se você usar um cliente HTTP ou REST padrão para chamar o endpoint :chat de streaming, o servidor poderá ter encontrado um erro fatal (como um tempo limite ou negação de permissão) durante o stream. Como os cabeçalhos HTTP já foram enviados, o código de erro verdadeiro é colocado em trailers HTTP/2, que os clientes REST padrão não podem analisar, resultando em uma falha de soquete. Recomendamos o uso dasbibliotecas de cliente gRPC oficiais Google Cloud , como o SDK do Python, para chamar endpoints de streaming. Essas bibliotecas analisam esses cabeçalhos finais e revelam a causa real do erro.
Internal error encountered (durante o streaming)	INTERNAL	500 Internal Server Error	13	Se você usar um cliente HTTP ou REST padrão para chamar o endpoint :chat de streaming, o servidor poderá ter encontrado um erro fatal durante o stream. Como os cabeçalhos HTTP já foram enviados, o código de erro verdadeiro é colocado em trailers HTTP/2, que os clientes REST padrão não podem analisar, resultando em uma falha de soquete. Recomendamos o uso dasbibliotecas de cliente gRPC oficiais Google Cloud , como o SDK do Python, para chamar endpoints de streaming. Essas bibliotecas analisam esses cabeçalhos finais e revelam a causa real do erro.
UnauthenticatedException	UNAUTHENTICATED	401 Unauthorized	16	A autenticação é necessária ou falhou. Verifique se você está usando as credenciais de login, a chave de API ou o token corretos.
UnimplementedException	UNIMPLEMENTED	501 Not Implemented	12	O recurso solicitado não está disponível ou não é compatível. Evite chamar essa API ou aguarde a implementação.

Outros recursos

Para mais dicas de solução de problemas e respostas a perguntas frequentes, consulte a página Perguntas frequentes sobre a API Análises de conversação.

Para orientações sobre como fazer perguntas eficazes à API Análises de conversação, consulte a página de documentação Fazer perguntas eficazes.