Se riscontri problemi di configurazione del tutorial, in questa pagina sono elencati i problemi che potresti riscontrare e vengono forniti suggerimenti su come risolverli.
La cartella cloudshell_open non è presente
Se non riesci a vedere la cartella cloudshell_open nella tua home directory eseguendo ls ~, la cartella e i relativi file sono andati 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 di nuovo 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 attuale
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 il seguente 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. Per verificare, esegui il seguente comando:
cat ~/key.json
Verranno stampati i contenuti del file o il messaggio No such file or directory. Un file vuoto indica che si è verificato un errore durante la creazione della chiave. Se manca un file, significa che l'errore si è verificato prima.
Per risolvere il problema, segui il passaggio del tutorial "Prepara l'ambiente di lavoro".
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, attiva Vertex AI Search for Retail nella pagina Dettagli API/servizi della console Google Cloud o esegui il seguente 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
Quando assegni i ruoli all'account di servizio, si verifica il seguente errore:
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. Vai alla pagina IAM nella console Google Cloud per verificare che l'account di servizio sia un proprietario del tuo progetto Google Cloud.
Autenticazione non valida con le credenziali dell'utente finale
Quando esegui gli 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 i passaggi del tutorial "Prepara l'ambiente di lavoro" 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 tua query di ricerca o quando il catalogo dei prodotti è vuoto. Per risolvere il problema, controlla se hai prodotti nel tuo catalogo nella pagina Catalogo della console Google Cloud. In caso contrario, importa i dati del catalogo seguendo il passaggio del tutorial "Importa i dati del catalogo".
I problemi persistono
Prova a reimpostare Cloud Shell ed esegui i tutorial dall'inizio.