Se riscontri problemi durante la configurazione del tutorial, questa pagina elenca i problemi che potresti riscontrare e fornisce suggerimenti su come risolverli.
La cartella cloudshell_open non è presente
Se non riesci a vedere la cartella cloudshell_open nella home directory eseguendo ls ~, la cartella e i relativi file andranno persi.
Questo problema si verifica quando utilizzi Cloud Shell in modalità temporanea e perdi la connessione a internet o aggiorni la pagina.
Per risolvere il problema, esegui nuovamente il tutorial dall'inizio. Per evitare la perdita dei file in futuro, ti consigliamo di passare alla modalità predefinita.
Impossibile rilevare un ID progetto nell'ambiente corrente
Quando provi a eseguire un esempio di codice, si verifica il seguente errore:
ERROR Unable to detect a Project Id in the current environment.
Questo problema si verifica quando il progetto Google Cloud non è impostato. Per risolvere il problema, imposta il progetto eseguendo questo comando:
gcloud config set project <YOUR-PROJECT-ID>
Errori key.json durante l'esecuzione di esempi di codice
Quando esegui gli esempi di codice, si verifica uno dei seguenti errori:
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
Questo problema si verifica quando il file key.json, utilizzato per autenticare un account di servizio, è vuoto o mancante. Puoi verificarlo eseguendo questo comando:
cat ~/key.json
Vengono stampati i contenuti del file o il messaggio No such file or directory. La presenza di un file vuoto indica che l'errore si è verificato durante la creazione della chiave. Se manca un file, significa che l'errore si è verificato prima.
Per risolvere il problema, segui il consiglio "Preparare l'ambiente di lavoro" del tutorial.
Vertex AI Search for Retail non è mai stato utilizzato nel progetto in precedenza o è disabilitato
Quando provi a eseguire un tutorial, si verifica il seguente errore:
PERMISSION_DENIED: Vertex AI Search for retail API has not been used in project <YOUR-PROJECT-ID> before or it is disabled
Per risolvere il problema, abilita Vertex AI Search for Retail nella pagina Dettagli API/servizi della console Google Cloud oppure esegui questo comando:
gcloud services enable \
retail.googleapis.com \
--project=<YOUR-PROJECT-ID>
L'account di servizio non dispone dell'autorizzazione per accedere all'istanza del progetto
Il seguente errore si verifica quando assegni ruoli all'account di servizio:
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.
Per risolvere il problema, verifica di avere attivato l'account corretto eseguendo il comando gcloud auth list nel terminale. Assicurati che l'account attivo sia l'account di servizio. Nella console Google Cloud, vai alla pagina IAM per verificare che l'account di servizio sia un proprietario del progetto Google Cloud.
Autenticazione non valida con le credenziali dell'utente finale
Quando esegui esempi di codice, si verifica il seguente errore:
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.
Questo problema si verifica quando vengono utilizzate le credenziali dell'utente finale anziché un account di servizio. Questo problema può verificarsi anche quando un account di servizio non è attivo o le variabili di ambiente richieste non sono impostate. Potresti visualizzare questo errore dopo aver riavviato Cloud Shell o aperto una nuova finestra del terminale.
Per risolvere il problema:
- Segui il video "Preparare l'ambiente di lavoro" passaggi del tutorial e assicurati di avere un account di servizio attivo eseguendo
gcloud auth list. Imposta le variabili di ambiente:
- Per tutte le lingue, esegui il comando:
export GOOGLE_APPLICATION_CREDENTIALS=~/key.json- Inoltre, per .NET, esegui il comando:
export GOOGLE_PROJECT_ID=<YOUR-PROJECT-ID>
Errore di autorizzazione quando l'account di servizio non dispone dei ruoli necessari
Quando esegui gli esempi di codice, si verifica il seguente errore:
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"
Questo problema si verifica quando l'account di servizio non dispone dei ruoli richiesti: retail.admin ed editor. Per risolvere il problema, configura l'ambiente di lavoro seguendo i passaggi del tutorial "Prepara l'ambiente di lavoro".
L'operazione di ricerca non ha restituito risultati corrispondenti
Questo problema si verifica quando nessun prodotto nel catalogo corrisponde alla query di ricerca o quando il catalogo dei prodotti è vuoto. Per risolvere il problema, controlla se nel tuo catalogo sono presenti prodotti nella pagina Catalogo della console Google Cloud. Se non lo fai, importa i dati del catalogo seguendo le istruzioni della sezione "Importa dati di catalogo" del tutorial.
I problemi persistono
Prova a reimpostare Cloud Shell ed esegui i tutorial dall'inizio.