Se tiver problemas ao configurar o tutorial, esta página apresenta uma lista de problemas que pode encontrar e sugestões sobre como corrigir cada problema.
A pasta cloudshell_open está em falta
Se não conseguir ver a pasta cloudshell_open no seu diretório inicial executando ls ~, a pasta e os respetivos ficheiros foram perdidos.
Este problema ocorre quando usa o Cloud Shell no modo efémero e perde a ligação à Internet ou atualiza a página.
Para resolver este problema, execute novamente o tutorial desde o início. Para evitar a perda dos seus ficheiros no futuro, considere mudar para o modo Predefinição.
Não é possível detetar um ID do projeto no ambiente atual
O seguinte erro ocorre quando tenta executar um exemplo de código:
ERROR Unable to detect a Project Id in the current environment.
Este problema ocorre quando o seu projeto do Google Cloud não está definido. Para resolver este problema, defina o projeto executando o seguinte comando:
gcloud config set project <YOUR-PROJECT-ID>
Erros de key.json ao executar exemplos de código
Ocorre um dos seguintes erros quando executa exemplos 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 ocorre quando o ficheiro key.json, que é usado para autenticar uma conta de serviço, está vazio ou em falta. Pode verificar se é esse o caso executando o seguinte comando:
cat ~/key.json
Isto imprime o conteúdo do ficheiro ou a mensagem No such file or directory. Um ficheiro vazio significa que o erro ocorreu durante a criação da chave. Um ficheiro em falta significa que o erro ocorreu antes.
Para resolver este problema, siga o passo do tutorial "Prepare o seu ambiente de trabalho".
O Vertex AI Search for commerce não foi usado no projeto antes ou está desativado
O seguinte erro ocorre quando tenta executar um tutorial:
PERMISSION_DENIED: Vertex AI Search for commerce API has not been used in project <YOUR-PROJECT-ID> before or it is disabled
Para resolver este problema, ative a Vertex AI Search for commerce na página Detalhes da API/serviços da Google Cloud Console ou execute o seguinte comando:
gcloud services enable \
retail.googleapis.com \
--project=<YOUR-PROJECT-ID>
A conta de serviço não tem autorização para aceder à instância do projeto
O seguinte erro ocorre quando atribui funções à conta de serviço:
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 resolver este problema, verifique se tem a conta correta ativa executando o comando gcloud auth list no terminal. Certifique-se de que a conta ativa é a conta de serviço. Aceda à página IAM na Google Cloud Console para verificar se a conta de serviço é proprietária do seu projeto do Google Cloud.
Autenticação inválida com credenciais de utilizador final
Ocorre o seguinte erro quando executa exemplos 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 ocorre quando são usadas credenciais de utilizador final em vez de uma conta de serviço. Este problema também pode ocorrer quando uma conta de serviço não está ativa ou as variáveis de ambiente necessárias não estão definidas. Pode ver este erro depois de reiniciar o Cloud Shell ou abrir uma nova janela do terminal.
Para resolver este problema:
- Siga os passos do tutorial "Prepare o seu ambiente de trabalho" e certifique-se de que tem uma conta de serviço ativa executando
gcloud auth list. Defina as variáveis de ambiente:
- Para todos os idiomas, execute o comando:
export GOOGLE_APPLICATION_CREDENTIALS=~/key.json- Além disso, para .NET, execute o comando:
export GOOGLE_PROJECT_ID=<YOUR-PROJECT-ID>
Erro de autorizações quando a conta de serviço não tem as funções necessárias
Ocorre o seguinte erro quando executa exemplos 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 ocorre quando a sua conta de serviço não tem as funções necessárias: retail.admin e editor. Para resolver este problema, configure o seu ambiente de trabalho seguindo os passos do tutorial "Prepare o seu ambiente de trabalho".
A operação de pesquisa não devolveu resultados correspondentes
Este problema ocorre quando nenhum produto no catálogo corresponde à sua consulta de pesquisa ou o catálogo de produtos está vazio. Para resolver este problema, verifique se tem produtos no catálogo na página Catálogo da consola do Google Cloud. Caso contrário, importe os dados do catálogo seguindo o passo do tutorial "Importe dados do catálogo".
Ainda existem problemas
Experimente repor o Cloud Shell e executar os tutoriais desde o início.