Résoudre les problèmes liés à l'API Conversational Analytics

Si vous rencontrez des problèmes lors de l'utilisation de l'API Conversational Analytics, consultez le tableau suivant pour trouver des solutions potentielles.

Remarque : Pour envoyer des commentaires ou demander de l'aide concernant cette fonctionnalité, envoyez un e-mail à [e-mail].

Erreur	Cause de l'erreur	Code d'état HTTP	Code d'état gRPC	Solution
AlreadyExistsException	ALREADY_EXISTS	409 Conflict	6	La ressource existe déjà (par exemple, vous créez une entrée en double). Utilisez un autre identifiant ou vérifiez que la ressource n'existe pas déjà avant de la créer.
BadRequestException	INVALID_ARGUMENT	400 Bad Request	3	L'entrée n'est pas valide ou son format n'est pas correct. Vérifiez les entrées ou les charges utiles avant d'envoyer la requête.
ForbiddenException	PERMISSION_DENIED	403 Forbidden	7	Vous êtes authentifié, mais vous n'êtes pas autorisé à accéder à la ressource. Vérifiez votre rôle utilisateur et vos autorisations. Contactez un administrateur si nécessaire.
PermissionDenied (Règles d'administration)	PERMISSION_DENIED	403 Forbidden	7	La requête ne respecte pas une contrainte liée aux règles d'administration, comme une restriction d'emplacement ou une exigence CMEK. Consultez le message d'erreur dans le corps de la réponse pour identifier la contrainte qui n'a pas été respectée. Pour en savoir plus, consultez Résoudre les problèmes de non-respect des règles.
FailedPreconditionException	FAILED_PRECONDITION	400 Bad Request	9	La requête enfreint l'état du système (par exemple, en tentant de supprimer un dossier non vide). Vérifiez les conditions préalables et corrigez la logique.
NotFoundException	NOT_FOUND	404 Not Found	5	La ressource est introuvable. Vérifiez les ID ou les URL de la ressource. Assurez-vous que la ressource existe avant d'essayer d'y accéder. Pour en savoir plus sur le dépannage, consultez les Questions fréquentes sur l'API Conversational Analytics.
ServiceUnavailableException	UNAVAILABLE	503 Service Unavailable	14	Un problème temporaire est survenu sur le serveur. Attendez et réessayez avec un intervalle exponentiel entre les tentatives. Si l'erreur persiste, envoyez un rapport de bug.
Connection reset by peer (pendant le streaming)	UNAVAILABLE	503 Service Unavailable	14	Si vous utilisez un client HTTP ou REST standard pour appeler le point de terminaison :chat de streaming, il est possible que le serveur ait rencontré une erreur fatale (telle qu'un délai d'attente ou un refus d'autorisation) pendant le flux. Étant donné que les en-têtes HTTP sont déjà envoyés, le véritable code d'erreur est placé dans les trailers HTTP/2, que les clients REST standards ne peuvent pas analyser, ce qui entraîne un plantage du socket. Nous vous recommandons d'utiliser les bibliothèques clientes gRPC officielles, telles que le SDK Python, pour appeler les points de terminaison de streaming. Google Cloud Ces bibliothèques analysent ces en-têtes de fin et révèlent la véritable cause de l'erreur.
Internal error encountered (pendant le streaming)	INTERNAL	500 Internal Server Error	13	Si vous utilisez un client HTTP ou REST standard pour appeler le point de terminaison de streaming :chat, il est possible que le serveur ait rencontré une erreur fatale pendant le flux. Étant donné que les en-têtes HTTP sont déjà envoyés, le véritable code d'erreur est placé dans les trailers HTTP/2, que les clients REST standards ne peuvent pas analyser, ce qui entraîne un plantage du socket. Nous vous recommandons d'utiliser les bibliothèques clientes gRPC officielles, telles que le SDK Python, pour appeler les points de terminaison de streaming. Google Cloud Ces bibliothèques analysent ces en-têtes de fin et révèlent la véritable cause de l'erreur.
UnauthenticatedException	UNAUTHENTICATED	401 Unauthorized	16	L'authentification est requise ou a échoué. Assurez-vous d'utiliser les identifiants de connexion, la clé API ou le jeton appropriés.
UnimplementedException	UNIMPLEMENTED	501 Not Implemented	12	La fonctionnalité demandée n'est pas disponible ou compatible. Évitez d'appeler cette API ou attendez l'implémentation.

Autres ressources

Pour obtenir d'autres conseils de dépannage et des réponses aux questions fréquentes, consultez la page Questions fréquentes sur l'API Conversational Analytics.

Pour obtenir des conseils sur la façon de poser des questions efficaces à l'API Conversational Analytics, consultez la page de documentation Poser des questions efficaces.