Troubleshooting the Google Assistant Service
Stay organized with collections
Save and categorize content based on your preferences.
Credentials issues
When trying to generate credentials with the authorization tool, the tool prompts
you to visit a URL and sign in to your Google account. The page then displays an
error message (for example, "Something went wrong").
Permissions issues
The Google Assistant responds Actually, there are some basic settings that need
your permission first...
Voice recognition issues
Assistant responds I don't know how to help with that or I don't
understand.
- 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. 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.
Trait issues
Assistant does not recognize a trait that you added to a model.
Device Actions issues
The Google Assistant responds saying that your app is not supported on your
device.
- In the Actions Console, 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.
See also
Support
Still having trouble? See our Support page.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-18 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-18 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,["Credentials issues\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\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\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\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\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- [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\nStill having trouble? See our [Support](/assistant/sdk/support) page."]]