Si vous rencontrez des problèmes pour configurer votre tutoriel, cette page liste les problèmes que vous pouvez rencontrer et fournit des suggestions pour les résoudre.
Le dossier cloudshell_open est manquant
Si vous ne voyez pas le dossier cloudshell_open dans votre répertoire d'accueil en exécutant ls ~, cela signifie que le dossier et ses fichiers sont perdus.
Ce problème se produit lorsque vous utilisez Cloud Shell en mode éphémère et que vous perdez votre connexion Internet ou actualisez la page.
Pour résoudre ce problème, réexécutez le tutoriel depuis le début. Pour éviter de perdre vos fichiers à l'avenir, envisagez de passer en mode par défaut.
Impossible de détecter un ID de projet dans l'environnement actuel
L'erreur suivante se produit lorsque vous tentez d'exécuter un exemple de code :
ERROR Unable to detect a Project Id in the current environment.
Ce problème se produit lorsque votre projet Google Cloud n'est pas défini. Pour résoudre ce problème, définissez le projet en exécutant la commande suivante :
gcloud config set project <YOUR-PROJECT-ID>
Erreurs key.json lors de l'exécution d'exemples de code
L'une des erreurs suivantes se produit lorsque vous exécutez des exemples de code :
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
Ce problème se produit lorsque le fichier key.json, utilisé pour authentifier un compte de service, est vide ou manquant. Pour vérifier que c'est bien le cas, exécutez la commande suivante :
cat ~/key.json
Le contenu du fichier ou le message No such file or directory s'affichent. Un fichier vide signifie que l'erreur s'est produite lors de la création de la clé. Si un fichier est manquant, cela signifie que l'erreur s'est produite avant.
Pour résoudre ce problème, suivez l'étape du tutoriel "Préparer votre environnement de travail".
Vertex AI Search pour le commerce n'a jamais été utilisé dans le projet ou a été désactivé
L'erreur suivante se produit lorsque vous essayez d'exécuter un tutoriel :
PERMISSION_DENIED: Vertex AI Search for commerce API has not been used in project <YOUR-PROJECT-ID> before or it is disabled
Pour résoudre ce problème, activez Vertex AI Search pour le commerce sur la page Détails de l'API/des services de la console Google Cloud ou exécutez la commande suivante :
gcloud services enable \
retail.googleapis.com \
--project=<YOUR-PROJECT-ID>
Le compte de service n'est pas autorisé à accéder à l'instance de projet
L'erreur suivante se produit lorsque vous attribuez des rôles au compte de service :
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.
Pour résoudre ce problème, vérifiez que le bon compte est actif en exécutant la commande gcloud auth list dans le terminal. Assurez-vous que le compte actif est le compte de service. Accédez à la page IAM de la console Google Cloud pour vérifier que le compte de service est bien le propriétaire de votre projet Google Cloud.
Authentification non valide à l'aide des identifiants de l'utilisateur final
L'erreur suivante se produit lorsque vous exécutez des exemples de code :
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.
Ce problème se produit lorsque des identifiants d'utilisateur final sont utilisés au lieu d'un compte de service. Ce problème peut également se produire lorsqu'un compte de service n'est pas actif ou que les variables d'environnement requises ne sont pas définies. Ce message d'erreur peut s'afficher après le redémarrage de Cloud Shell ou l'ouverture d'une nouvelle fenêtre de terminal.
Pour remédier à ce problème :
- Suivez les étapes du tutoriel "Préparer votre environnement de travail" et assurez-vous qu'un compte de service est actif en exécutant
gcloud auth list. Définissez les variables d'environnement :
- Pour toutes les langues, exécutez la commande suivante :
export GOOGLE_APPLICATION_CREDENTIALS=~/key.json- Pour .NET, exécutez également la commande suivante :
export GOOGLE_PROJECT_ID=<YOUR-PROJECT-ID>
Erreur d'autorisation lorsque le compte de service ne dispose pas des rôles requis
L'erreur suivante se produit lorsque vous exécutez des exemples de code :
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"
Ce problème se produit lorsque votre compte de service ne dispose pas des rôles requis : retail.admin et editor. Pour résoudre ce problème, configurez votre environnement de travail en suivant les étapes du tutoriel "Préparer votre environnement de travail".
L'opération de recherche n'a renvoyé aucun résultat correspondant.
Ce problème se produit lorsqu'aucun produit du catalogue ne correspond à votre requête de recherche ou lorsque le catalogue de produits est vide. Pour résoudre ce problème, vérifiez si vous avez des produits dans votre catalogue sur la page Catalogue de la console Google Cloud. Si ce n'est pas le cas, importez les données de catalogue en suivant l'étape du tutoriel "Importer des données de catalogue".
Des problèmes persistent
Essayez de réinitialiser Cloud Shell et d'exécuter les tutoriels depuis le début.