Se você tiver problemas ao configurar seu tutorial, esta página lista problemas que podem ser encontrados e fornece sugestões de como corrigir cada problema.
A pasta cloudshell_open está ausente
Se não for possível ver a pasta cloudshell_open no diretório inicial executando 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 com a Internet ou atualiza a página.
Para resolver esse problema, execute o tutorial novamente desde o início. Para evitar a perda dos 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 seu projeto do Google Cloud não está definido. Para resolver esse problema, execute o seguinte comando para definir o projeto:
gcloud config set project <YOUR-PROJECT-ID>
erros key.json ao executar exemplos de código
Um dos erros a seguir ocorre quando você executa amostras 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, 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 do tutorial "Preparar seu ambiente de trabalho".
A API Retail não foi usada no projeto antes ou está desativada
Este erro ocorre quando você tenta executar um tutorial:
PERMISSION_DENIED: Retail API has not been used in project <YOUR-PROJECT-ID> before or it is disabled
Para resolver esse problema, ative a API Retail na página API/Services Details 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 seguinte erro ocorre quando você atribui papéis à conta de serviço:
User [USER@YOUR-PROJECT-ID.iam.gserviceaccount.com] 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, execute o comando gcloud auth list no terminal para verificar se a conta certa está ativa. 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 de usuário final
O seguinte erro ocorre quando você executa amostras 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 credenciais de 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 quando as variáveis de ambiente necessárias não estão definidas. Talvez você veja esse erro depois de reiniciar o Cloud Shell ou abrir uma nova janela de terminal.
Para resolver o problema:
- Siga as etapas do tutorial "Preparar seu 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 quando você executa amostras 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 sua conta de serviço não tem os papéis necessários: "Retail.admin" e "Editor". Para resolver esse problema, configure o ambiente de trabalho seguindo as etapas do tutorial "Preparar seu ambiente de trabalho".
A operação de pesquisa não retornou resultados correspondentes
Esse problema ocorre quando nenhum produto no catálogo corresponde à sua consulta de pesquisa ou o catálogo de produtos está vazio. Para resolver esse problema, verifique se há produtos no seu catálogo na página Catálogo do Console do Google Cloud. Se não tiver, importe os dados do catálogo seguindo a etapa do tutorial "Importar dados do catálogo".
Ainda há problemas
Redefina o Cloud Shell e execute os tutoriais desde o início.