Wenn bei der Konfiguration Ihrer Anleitung Probleme auftreten, finden Sie auf dieser Seite eine Liste der möglichen Probleme sowie Vorschläge zur Behebung der einzelnen Probleme.
Der Ordner „cloudshell_open“ fehlt
Wenn Sie den Ordner „cloudshell_open“ in Ihrem Basisverzeichnis nicht sehen, nachdem Sie ls ~ ausgeführt haben, sind der Ordner und seine Dateien verloren.
Dieses Problem tritt auf, wenn Sie Cloud Shell im flüchtigen Modus verwenden und die Internetverbindung verlieren oder die Seite aktualisieren.
Führen Sie die Anleitung noch einmal von Anfang an aus, um dieses Problem zu beheben. Um zu verhindern, dass Ihre Dateien in Zukunft verloren gehen, sollten Sie in den Standardmodus wechseln.
In der aktuellen Umgebung konnte keine Projekt-ID 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 eingerichtet ist. Führen Sie den folgenden Befehl aus, um das Projekt festzulegen und das Problem zu beheben:
gcloud config set project <YOUR-PROJECT-ID>
key.json-Fehler 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 oder fehlt. Sie können dies prüfen, indem Sie den folgenden Befehl ausführen:
cat ~/key.json
Dadurch wird entweder der Inhalt der Datei oder die Nachricht No such file or directory ausgegeben. Eine leere Datei bedeutet, dass der Fehler bei der Schlüsselerstellung aufgetreten ist. Wenn eine Datei fehlt, ist der Fehler davor aufgetreten.
Folgen Sie der Anleitung unter „Arbeitsumgebung vorbereiten“, um dieses Problem zu beheben. Anleitungsschritts erstellt haben.
Vertex AI Search for Retail wurde im Projekt noch nicht verwendet oder ist deaktiviert
Der folgende Fehler tritt auf, wenn Sie versuchen, ein Tutorial auszuführen:
PERMISSION_DENIED: Vertex AI Search for retail API has not been used in project <YOUR-PROJECT-ID> before or it is disabled
Aktivieren Sie Vertex AI Search for Retail auf der Seite API-/Dienstdetails in der Google Cloud Console oder führen Sie den folgenden Befehl aus, um dieses Problem zu beheben:
gcloud services enable \
retail.googleapis.com \
--project=<YOUR-PROJECT-ID>
Das Dienstkonto ist nicht berechtigt, auf die Projektinstanz zuzugreifen
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. Führen Sie dazu den Befehl gcloud auth list im Terminal aus. Achten Sie darauf, dass das aktive Konto das Dienstkonto ist. Rufen Sie in der Google Cloud Console die Seite IAM auf und prüfen Sie, ob das Dienstkonto Inhaber Ihres Google Cloud-Projekts ist.
Ungültige Authentifizierung mit Anmeldedaten von Endnutzern
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 Anmeldedaten von Endnutzern anstelle eines Dienstkontos verwendet werden. Dieses Problem kann auch auftreten, wenn ein Dienstkonto nicht aktiv oder die erforderlichen Umgebungsvariablen nicht festgelegt sind. Dieser Fehler kann auftreten, wenn Sie Cloud Shell neu starten oder ein neues Terminalfenster öffnen.
So lösen Sie dieses Problem:
- Folgen Sie der Anleitung unter „Arbeitsumgebung vorbereiten“. der Anleitung und prüfen Sie, ob ein Dienstkonto aktiv ist. Führen Sie dazu
gcloud auth listaus. Legen Sie die Umgebungsvariablen fest:
- Führen Sie für alle Sprachen folgenden Befehl aus:
export GOOGLE_APPLICATION_CREDENTIALS=~/key.json- Führen Sie für .NET zusätzlich den Befehl aus:
export GOOGLE_PROJECT_ID=<YOUR-PROJECT-ID>
Berechtigungsfehler, wenn das Dienstkonto keine 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 hat: „retail.admin“ und „editor“. Um dieses Problem zu beheben, richten Sie Ihre Arbeitsumgebung ein. Folgen Sie dazu der Anleitung unter „Arbeitsumgebung vorbereiten“. Anleitung.
Der Suchvorgang hat keine passenden Ergebnisse zurückgegeben
Dieses Problem tritt auf, wenn keine Produkte im Katalog mit Ihrer Suchanfrage übereinstimmen oder der Produktkatalog leer ist. Prüfen Sie zum Beheben dieses Problems auf der Seite Katalog der Google Cloud Console, ob Ihr Katalog Produkte enthält. Falls nicht, importieren Sie Katalogdaten, indem Sie der Anleitung unter „Katalogdaten importieren“ folgen. Anleitungsschritts erstellt haben.
Es gibt immer noch Probleme
Versuchen Sie, Cloud Shell zurückzusetzen und die Anleitungen von vorn auszuführen.