Si tienes problemas para configurar el tutorial, en esta página se enumeran los problemas que puedes encontrar y se ofrecen sugerencias para solucionarlos.
Falta la carpeta cloudshell_open
Si no ves la carpeta cloudshell_open en tu directorio principal al ejecutar ls ~, significa que la carpeta y sus archivos se han perdido.
Este problema se produce cuando usas Cloud Shell en modo efímero y pierdes la conexión a Internet o actualizas la página.
Para solucionar este problema, vuelve a ejecutar el tutorial desde el principio. Para evitar que se pierdan tus archivos en el futuro, te recomendamos que cambies al modo Predeterminado.
No se ha podido detectar un ID de proyecto en el entorno actual
Se produce el siguiente error cuando intentas ejecutar un código de muestra:
ERROR Unable to detect a Project Id in the current environment.
Este problema se produce cuando no se ha definido tu proyecto de Google Cloud. Para solucionar este problema, define el proyecto ejecutando el siguiente comando:
gcloud config set project <YOUR-PROJECT-ID>
Errores de key.json al ejecutar ejemplos de código
Se produce uno de los siguientes errores al ejecutar ejemplos de código:
File /home/user/key.json is not a valid json file
no JSON input found
The file at /home/user/key.json does not exist, or it is not a file
Could not find file '/home/user/key.json'
Error reading credential file from location /home/user/key.json: Value cannot be null
Este problema se produce cuando el archivo key.json, que se usa para autenticar una cuenta de servicio, está vacío o no se encuentra. Para comprobar si es así, ejecuta el siguiente comando:
cat ~/key.json
Se imprimirá el contenido del archivo o el mensaje No such file or directory. Un archivo vacío significa que se ha producido un error durante la creación de la clave. Si falta un archivo, significa que el error se ha producido antes.
Para solucionar este problema, sigue el paso del tutorial "Prepara tu entorno de trabajo".
Vertex AI Search para el sector del comercio no se ha usado nunca en este proyecto o está inhabilitado
Este error se produce cuando intentas ejecutar un tutorial:
PERMISSION_DENIED: Vertex AI Search for commerce API has not been used in project <YOUR-PROJECT-ID> before or it is disabled
Para solucionar este problema, habilita Vertex AI Search para el comercio en la página Detalles de la API o del servicio de la consola de Google Cloud o ejecuta el siguiente comando:
gcloud services enable \
retail.googleapis.com \
--project=<YOUR-PROJECT-ID>
La cuenta de servicio no tiene permiso para acceder a la instancia del proyecto
Se produce el siguiente error al asignar roles a la cuenta de servicio:
User [USER@YOUR-PROJECT-ID.] does not have permission to access projects instance [YOUR-PROJECT-ID:setIamPolicy] (or it may not exist): Policy update access denied.
Para solucionar este problema, comprueba que tienes la cuenta correcta activa ejecutando el comando gcloud auth list en el Terminal. Asegúrate de que la cuenta activa sea la cuenta de servicio. Ve a la página Gestión de identidades y accesos de la consola de Google Cloud para comprobar que la cuenta de servicio es propietaria de tu proyecto de Google Cloud.
Autenticación no válida con credenciales de usuario final
Se produce el siguiente error al ejecutar ejemplos de código:
PERMISSION_DENIED: Your application has been authenticated using end user credentials from the Google Cloud SDK or Google Cloud Shell which are not supported by the retail.googleapis.com.
Este problema se produce cuando se usan las credenciales del usuario final en lugar de una cuenta de servicio. Este problema también puede producirse si una cuenta de servicio no está activa o si no se han definido las variables de entorno necesarias. Es posible que veas este error después de reiniciar Cloud Shell o de abrir una nueva ventana de terminal.
Para solucionar este problema, sigue estos pasos:
- Sigue los pasos del tutorial "Prepara tu entorno de trabajo" y asegúrate de que tienes una cuenta de servicio activa ejecutando
gcloud auth list. Define las variables de entorno:
- Para todos los idiomas, ejecuta el siguiente comando:
export GOOGLE_APPLICATION_CREDENTIALS=~/key.json- Además, en .NET, ejecuta el comando:
export GOOGLE_PROJECT_ID=<YOUR-PROJECT-ID>
Error de permisos cuando la cuenta de servicio no tiene los roles necesarios
Se produce el siguiente error al ejecutar ejemplos de código:
google.api_core.exceptions.PermissionDenied: 403 Permission 'retail.<YOUR-REQUEST>' denied on resource '//retail.googleapis.com/projects/<YOUR-PROJECT-ID>/locations/<YOUR-LOCATION>' (or it may not exist). [reason: "IAM_PERMISSION_DENIED"
Este problema se produce cuando tu cuenta de servicio no tiene los roles necesarios: retail.admin y editor. Para solucionar este problema, configura tu entorno de trabajo siguiendo los pasos del tutorial "Preparar el entorno de trabajo".
La operación de búsqueda no ha devuelto ningún resultado
Este problema se produce cuando ningún producto del catálogo coincide con su consulta de búsqueda o cuando el catálogo de productos está vacío. Para resolver este problema, comprueba si tienes productos en tu catálogo en la página Catálogo de la consola de Google Cloud. Si no lo ha hecho, importe los datos del catálogo siguiendo el paso del tutorial "Importar datos del catálogo".
Sigue habiendo problemas
Prueba a restablecer Cloud Shell y a ejecutar los tutoriales desde el principio.