Résoudre les problèmes liés au service Assistant Google
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Problèmes d'identifiants
Lorsque vous essayez de générer des identifiants avec l'outil d'autorisation, il vous invite à accéder à une URL et à vous connecter à votre compte Google. La page affiche ensuite un message d'erreur (par exemple, "Un problème est survenu").
Problèmes d'autorisation
L'Assistant Google répond En fait, certains paramètres de base nécessitent d'abord votre autorisation…
Problèmes de reconnaissance vocale
L'Assistant répond Je ne sais pas comment vous aider sur ce point ou Je ne comprends pas.
- Vérifiez que votre voix a été correctement reconnue. Consultez la sortie de l'exemple de code pour obtenir une transcription de la demande de l'utilisateur. Vous pouvez également consulter Mon activité. Vous pouvez lire le contenu audio reçu par l'Assistant pour vérifier s'il y a des problèmes de qualité audio. Si vous entendez trop de bruit ou si le son est déformé, vérifiez que votre micro est correctement configuré ou essayez-en un autre.
Problèmes liés aux traits
L'Assistant ne reconnaît pas un trait que vous avez ajouté à un modèle.
Problèmes liés aux actions sur l'appareil
L'Assistant Google répond que votre application n'est pas compatible avec votre appareil.
- Dans la console Actions, vous pouvez définir les capacités de surface de votre application Assistant. Si vous définissez l'affichage sur écran comme obligatoire, vos actions personnalisées ne fonctionneront pas. Le SDK de l'Assistant Google n'est pas compatible avec les fonctionnalités d'écran pour le moment.
Voir aussi
- Section Dépannage du fichier README de l'exemple de service de l'Assistant Google
Assistance
Vous rencontrez toujours des problèmes ? Consultez notre page Assistance.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003eEnsure the Google Assistant API is enabled and the OAuth consent screen is properly configured to resolve credential issues.\u003c/p\u003e\n"],["\u003cp\u003eVerify activity controls are set for the account used during authorization setup to address permission problems.\u003c/p\u003e\n"],["\u003cp\u003eTroubleshoot voice recognition issues by reviewing the voice transcript, checking audio quality, and microphone configuration.\u003c/p\u003e\n"],["\u003cp\u003eFor trait-related problems, confirm trait addition to the model and re-register the device instance after model updates.\u003c/p\u003e\n"],["\u003cp\u003eIf encountering device action issues, review surface capabilities settings in the Actions Console, ensuring screen output is not required.\u003c/p\u003e\n"]]],[],null,["# Troubleshooting the Google Assistant Service\n\nCredentials issues\n------------------\n\nWhen trying to generate credentials with the authorization tool, the tool prompts\nyou to visit a URL and sign in to your Google account. The page then displays an\nerror message (for example, \"Something went wrong\").\n\n- Make sure you enabled the Google Assistant API and configured the OAuth consent screen in [Configure a Developer Project and Account Settings](/assistant/sdk/guides/service/python/embed/config-dev-project-and-account#config-dev-project).\n\nPermissions issues\n------------------\n\nThe Google Assistant responds *Actually, there are some basic settings that need\nyour permission first...*\n\n- [Set activity controls](/assistant/sdk/guides/activity-controls) for the account that you used when setting the authorization code.\n\nVoice recognition issues\n------------------------\n\nAssistant responds *I don't know how to help with that* or *I don't\nunderstand.*\n\n- Verify that your voice was recognized properly. Check the sample code output for a transcript of the user request. You can also look at [my activity](https://myactivity.google.com/myactivity?restrict=vaa). You can play the audio received by the Assistant to check for audio quality issues. If you hear excessive noise or if the audio is distorted, check that your microphone is configured properly or try a different microphone.\n\nTrait issues\n------------\n\nAssistant does not recognize a trait that you added to a model.\n\n- Make sure the trait was added to the model\n (see [Register Traits for the\n Device](/assistant/sdk/guides/service/python/extend/register-device-traits)).\n\n- If you generated a device instance for a model, the device instance will **not**\n automatically update when its model is changed by other users. You need to\n manually re-register the device instance using the [registration command line tool](/assistant/sdk/reference/device-registration/device-tool#register-device)\n or the [REST API](/assistant/sdk/reference/device-registration/register-device-manual#register-instance).\n You can find the\n [device instance ID](/assistant/sdk/guides/service/python/embed/run-sample#get-device-id)\n in the output of the sample.\n\nDevice Actions issues\n---------------------\n\nThe Google Assistant responds saying that your app is not supported on your\ndevice.\n\n- In the [Actions Console](https://console.actions.google.com/), you can set the surface capabilities of your Assistant app. If you set screen output to be required, your custom actions will not function. The Google Assistant SDK does not support screen capabilities at this time.\n\nSee also\n--------\n\n- [Troubleshooting](https://github.com/googlesamples/assistant-sdk-python/tree/master/google-assistant-sdk/googlesamples/assistant/grpc#troubleshooting) section of the Google Assistant Service sample README\n\nSupport\n-------\n\nStill having trouble? See our [Support](/assistant/sdk/support) page."]]
