Wenn Sie Probleme bei der Konfiguration Ihrer Anleitung haben, finden Sie auf dieser Seite eine Liste der möglichen Probleme und Vorschläge zur Behebung.
Der Ordner „cloudshell_open“ fehlt
Wenn Sie den Ordner „cloudshell_open“ in Ihrem Basisverzeichnis nicht sehen können, indem Sie ls ~ ausführen, sind der Ordner und seine Dateien verloren.
Dieses Problem tritt auf, wenn Sie die Cloud Shell im flüchtigen Modus verwenden und die Internetverbindung verlieren oder die Seite aktualisieren.
Um dieses Problem zu beheben, führen Sie die Anleitung noch einmal von Anfang an aus. Wenn Sie den Verlust Ihrer Dateien in Zukunft vermeiden möchten, sollten Sie zum Standardmodus wechseln.
Projekt-ID in der aktuellen Umgebung kann nicht erkannt werden
Der folgende Fehler tritt auf, wenn Sie versuchen, ein Codebeispiel auszuführen:
ERROR Unable to detect a Project Id in the current environment.
Dieses Problem tritt auf, wenn Ihr Google Cloud-Projekt nicht festgelegt ist. Um dieses Problem zu beheben, legen Sie das Projekt fest, indem Sie den folgenden Befehl ausführen:
gcloud config set project <YOUR-PROJECT-ID>
Fehler in „key.json“ beim Ausführen von Codebeispielen
Einer der folgenden Fehler tritt auf, wenn Sie Codebeispiele ausführen:
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
Dieses Problem tritt auf, wenn die Datei „key.json“, die zur Authentifizierung eines Dienstkontos verwendet wird, leer ist oder fehlt. Sie können prüfen, ob dies der Fall ist, indem Sie den folgenden Befehl ausführen:
cat ~/key.json
Dadurch wird entweder der Inhalt der Datei oder die Meldung No such file or directory ausgegeben. Eine leere Datei bedeutet, dass der Fehler bei der Schlüsselerstellung aufgetreten ist. Eine fehlende Datei bedeutet, dass der Fehler vorher aufgetreten ist.
Um dieses Problem zu beheben, folgen Sie der Anleitung „Arbeitsumgebung vorbereiten“.
AI Commerce Search wurde im Projekt noch nicht verwendet oder ist deaktiviert
Der folgende Fehler tritt auf, wenn Sie versuchen, eine Anleitung auszuführen:
PERMISSION_DENIED: AI Commerce Search API has not been used in project <YOUR-PROJECT-ID> before or it is disabled
Um dieses Problem zu beheben, aktivieren Sie die AI Commerce Search auf der Seite „API-/Dienstdetails“ der Google Cloud Console oder führen Sie den folgenden Befehl aus:
gcloud services enable \
retail.googleapis.com \
--project=<YOUR-PROJECT-ID>
Dienstkonto hat keine Berechtigung für den Zugriff auf die Projektinstanz
Der folgende Fehler tritt auf, wenn Sie dem Dienstkonto Rollen zuweisen:
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.
Um dieses Problem zu beheben, prüfen Sie, ob das richtige Konto aktiv ist, indem Sie den Befehl gcloud auth list im Terminal ausführen. Achten Sie darauf, dass das aktive Konto das Dienstkonto ist. Prüfen Sie auf der Seite „IAM“ in der Google Cloud Console, ob das Dienstkonto Inhaber Ihres Google Cloud-Projekts ist.
Ungültige Authentifizierung mit Endnutzeranmeldedaten
Der folgende Fehler tritt auf, wenn Sie Codebeispiele ausführen:
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.
Dieses Problem tritt auf, wenn anstelle eines Dienstkontos Endnutzeranmeldedaten verwendet werden. Dieses Problem kann auch auftreten, wenn ein Dienstkonto nicht aktiv ist oder die erforderlichen Umgebungsvariablen nicht festgelegt sind. Dieser Fehler kann nach dem Neustart der Cloud Shell oder dem Öffnen eines neuen Terminalfensters auftreten.
So beheben Sie dieses Problem:
- Folgen Sie der Anleitung „Arbeitsumgebung vorbereiten“ und prüfen Sie mit
gcloud auth list, ob ein Dienstkonto aktiv ist. Legen Sie die Umgebungsvariablen fest:
- Führen Sie für alle Sprachen den folgenden Befehl aus:
export GOOGLE_APPLICATION_CREDENTIALS=~/key.json- Führen Sie zusätzlich für .NET den folgenden Befehl aus:
export GOOGLE_PROJECT_ID=<YOUR-PROJECT-ID>
Berechtigungsfehler, wenn das Dienstkonto nicht die erforderlichen Rollen hat
Der folgende Fehler tritt auf, wenn Sie Codebeispiele ausführen:
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"
Dieses Problem tritt auf, wenn Ihr Dienstkonto nicht die erforderlichen Rollen „retail.admin“ und „Bearbeiter“ hat. Um dieses Problem zu beheben, richten Sie Ihre Arbeitsumgebung ein, indem Sie der Anleitung „Arbeitsumgebung vorbereiten“ folgen.
Die Suchanfrage hat keine übereinstimmenden Ergebnisse zurückgegeben
Dieses Problem tritt auf, wenn keine Produkte im Katalog mit Ihrer Suchanfrage übereinstimmen oder der Produktkatalog leer ist. Prüfen Sie auf der Seite „Katalog“ in der Google Cloud Console, ob Produkte in Ihrem Katalog vorhanden sind. Wenn nicht, importieren Sie Katalogdaten, indem Sie der Anleitung „Katalogdaten importieren“ folgen.
Es gibt immer noch Probleme
Setzen Sie die Cloud Shell zurück und führen Sie die Anleitungen noch einmal von Anfang an aus.