Se você tiver problemas para configurar o tutorial, esta página lista os problemas que podem ocorrer e oferece sugestões de como corrigir cada um deles.
A pasta cloudshell_open está ausente
Se você não encontrar a pasta cloudshell_open no seu diretório inicial ao executar ls ~, a pasta e os arquivos dela serão perdidos.
Esse problema ocorre quando você usa o Cloud Shell no modo temporário e perde a conexão de Internet ou atualiza a página.
Para resolver esse problema, execute o tutorial novamente desde o início. Para evitar a perda de arquivos no futuro, mude para o modo padrão.
Não foi possível detectar um ID do projeto no ambiente atual
O seguinte erro ocorre quando você tenta executar um exemplo de código:
ERROR Unable to detect a Project Id in the current environment.
Esse problema ocorre quando o projeto do Google Cloud não está definido. Para resolver esse 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
Um dos seguintes erros ocorre quando você 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
Esse problema ocorre quando o arquivo key.json, que é usado para autenticar uma conta de serviço, está vazio ou ausente. Para verificar se esse é o caso, execute o seguinte comando:
cat ~/key.json
Isso imprime o conteúdo do arquivo ou a mensagem No such file or directory. Um arquivo vazio significa que o erro ocorreu durante a criação da chave. Um arquivo ausente significa que o erro ocorreu antes disso.
Para resolver esse problema, siga a etapa "Prepare seu ambiente de trabalho" do tutorial.
A Vertex AI para Pesquisa para varejo não foi usada no projeto antes ou está desativada
O seguinte erro ocorre quando você tenta executar um tutorial:
PERMISSION_DENIED: Vertex AI Search for retail API has not been used in project <YOUR-PROJECT-ID> before or it is disabled
Para resolver esse problema, ative a Vertex AI para Pesquisa para varejo na página Detalhes da API/Serviços do console do Google Cloud ou execute o seguinte comando:
gcloud services enable \
retail.googleapis.com \
--project=<YOUR-PROJECT-ID>
A conta de serviço não tem permissão para acessar a instância do projeto
O erro a seguir ocorre quando você atribui papéis à 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 esse problema, verifique se a conta certa está ativa executando o comando gcloud auth list no terminal. Verifique se a conta ativa é a conta de serviço. Acesse a página IAM no console do Google Cloud para verificar se a conta de serviço é proprietária do seu projeto do Google Cloud.
Autenticação inválida usando credenciais do usuário final
O seguinte erro ocorre ao executar 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.
Esse problema ocorre quando as credenciais do usuário final são usadas em vez de uma conta de serviço. Esse 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. Esse erro pode aparecer depois de reiniciar o Cloud Shell ou abrir uma nova janela do Terminal.
Para resolver o problema:
- Siga as etapas do tutorial "Preparar o ambiente de trabalho" e verifique se você 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 permissões quando a conta de serviço não tem os papéis necessários
O seguinte erro ocorre ao executar 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"
Esse problema ocorre quando a conta de serviço não tem as funções necessárias: retail.admin e editor. Para resolver esse problema, configure o ambiente de trabalho seguindo as etapas do tutorial "Preparar o ambiente de trabalho".
A operação de pesquisa não retornou resultados correspondentes
Esse problema ocorre quando nenhum produto no catálogo corresponde à consulta de pesquisa ou quando o catálogo de produtos está vazio. Para resolver esse problema, verifique se você tem produtos no catálogo na página Catálogo do console do Google Cloud. Caso contrário, siga a etapa do tutorial "Importar dados do catálogo".
Ainda há problemas
Tente redefinir o Cloud Shell e executar os tutoriais desde o início.