Probleme mit der Anleitung beheben

Wenn bei der Konfiguration Ihrer Anleitung Probleme auftreten, finden Sie auf dieser Seite mögliche Probleme sowie Vorschläge zum Beheben der einzelnen Probleme.

Der Ordner cloudshell_open fehlt

Wenn Sie den Ordner „cloudshell_open“ nicht in Ihrem Basisverzeichnis sehen können, indem Sie ls ~ ausführen, gehen der Ordner und seine Dateien verloren. Dieses Problem tritt auf, wenn Sie Cloud Shell im flüchtigen Modus verwenden und Ihre Internetverbindung unterbrochen wird oder die Seite aktualisiert wird. Führen Sie die Anleitung noch einmal von vorn aus, um dieses Problem zu beheben. Damit Ihre Dateien in Zukunft nicht verloren gehen, können Sie in den Standardmodus wechseln.

In der aktuellen Umgebung kann 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 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>

key.json-Fehler beim Ausführen von Codebeispielen

Beim Ausführen von Codebeispielen tritt einer der folgenden Fehler auf:

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" zur Authentifizierung eines Dienstkontos leer ist oder fehlt. Mit dem folgenden Befehl können Sie prüfen, ob dies der Fall ist:

cat ~/key.json

Dadurch wird entweder der Dateiinhalt oder die No such file or directory-Nachricht ausgegeben. Eine leere Datei bedeutet, dass der Fehler beim Erstellen des Schlüssels aufgetreten ist. Wenn eine Datei fehlt, ist der Fehler bereits vorher aufgetreten. Um dieses Problem zu beheben, folgen Sie der Anleitung „Arbeitsumgebung vorbereiten“.

Vertex AI Search for Retail wurde noch nicht im Projekt verwendet oder ist deaktiviert

Der folgende Fehler tritt auf, wenn Sie versuchen, eine Anleitung 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 für den Einzelhandel auf der Seite API-/Dienstdetails 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>

Dienstkonto ist nicht berechtigt, auf die Projektinstanz zuzugreifen

Der folgende Fehler tritt auf, wenn Sie dem Dienstkonto Rollen zuweisen:

User [USER@YOUR-PROJECT-ID.iam.gserviceaccount.com] 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 Sie das richtige Konto aktiviert haben. Führen Sie dazu den Befehl gcloud auth list im Terminal aus. Prüfen Sie, ob das aktive Konto das Dienstkonto ist. Rufen Sie in der Google Cloud Console die Seite IAM auf und prüfen Sie, ob das Dienstkonto ein 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 Anmeldedaten von Endnutzern anstelle eines Dienstkontos 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 von Cloud Shell oder dem Öffnen eines neuen Terminalfensters auftreten.

So beheben Sie das Problem:

  1. Folgen Sie der Anleitung zum Vorbereiten der Arbeitsumgebung und führen Sie gcloud auth list aus, um zu prüfen, ob ein Dienstkonto aktiv ist.

  2. Legen Sie die Umgebungsvariablen fest:

    1. Führen Sie für alle Sprachen den folgenden Befehl aus:
    export GOOGLE_APPLICATION_CREDENTIALS=~/key.json
    1. Führen Sie für .NET außerdem den folgenden 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 „Retail.admin“ und „Editor“ hat. Um dieses Problem zu beheben, richten Sie Ihre Arbeitsumgebung gemäß der Anleitung „Arbeitsumgebung vorbereiten“ ein.

Beim Suchvorgang wurden keine passenden Ergebnisse zurückgegeben

Dieses Problem tritt auf, wenn keine Produkte im Katalog Ihrer Suchanfrage entsprechen oder der Produktkatalog leer ist. Um dieses Problem zu beheben, prüfen Sie auf der Seite Katalog der Google Cloud Console, ob Produkte in Ihrem Katalog enthalten sind. Falls nicht, importieren Sie Katalogdaten, wie im Anleitungsschritt „Katalogdaten importieren“ beschrieben.

Es gibt immer noch Probleme

Setzen Sie Cloud Shell zurück und führen Sie die Anleitungen von Anfang an aus.