אם נתקלתם בבעיות בהגדרת המדריך, בדף הזה מפורטות בעיות אפשריות ומוצעים פתרונות לכל בעיה.
התיקייה cloudshell_open חסרה
אם אתם לא רואים את התיקייה cloudshell_open בספריית הבית אחרי הפעלת הפקודה ls ~, התיקייה והקבצים שלה אבדו.
הבעיה הזו מתרחשת כשמשתמשים ב-Cloud Shell במצב זמני והחיבור לאינטרנט מתנתק או כשמרעננים את הדף.
כדי לפתור את הבעיה, צריך להפעיל מחדש את ההדרכה מההתחלה. כדי למנוע אובדן של קבצים בעתיד, כדאי לעבור למצב ברירת מחדל.
לא ניתן לזהות מזהה פרויקט בסביבה הנוכחית
השגיאה הבאה מתרחשת כשמנסים להריץ דוגמת קוד:
ERROR Unable to detect a Project Id in the current environment.
הבעיה הזו מתרחשת כשהפרויקט שלכם ב-Google Cloud לא מוגדר. כדי לפתור את הבעיה, מגדירים את הפרויקט באמצעות הפקודה הבאה:
gcloud config set project <YOUR-PROJECT-ID>
שגיאות בקובץ key.json כשמריצים דוגמאות קוד
אחת מהשגיאות הבאות מתרחשת כשמריצים דוגמאות קוד:
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
הבעיה הזו מתרחשת כשקובץ key.json, שמשמש לאימות חשבון שירות, ריק או חסר. כדי לבדוק אם זה המצב, מריצים את הפקודה הבאה:
cat ~/key.json
הפעולה הזו תדפיס את תוכן הקובץ או את ההודעה של No such file or directory. קובץ ריק מצביע על כך שהשגיאה התרחשה במהלך יצירת המפתח. אם קובץ מסוים חסר, סימן שהשגיאה התרחשה לפני כן.
כדי לפתור את הבעיה, צריך לפעול לפי השלב 'הכנת סביבת העבודה' במדריך.
התכונה 'חיפוש מסחרי מבוסס-AI' לא שימשה בפרויקט בעבר או שהיא מושבתת
השגיאה הבאה מתרחשת כשמנסים להפעיל הדרכה:
PERMISSION_DENIED: AI Commerce Search API has not been used in project <YOUR-PROJECT-ID> before or it is disabled
כדי לפתור את הבעיה הזו, צריך להפעיל את AI Commerce Search בדף API/Services Details במסוף Google Cloud, או להריץ את הפקודה הבאה:
gcloud services enable \
retail.googleapis.com \
--project=<YOUR-PROJECT-ID>
לחשבון השירות אין הרשאה לגשת למופע הפרויקט
השגיאה הבאה מתרחשת כשמקצים תפקידים לחשבון השירות:
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.
כדי לפתור את הבעיה, מריצים את הפקודה gcloud auth list בטרמינל כדי לוודא שהחשבון הנכון פעיל. מוודאים שהחשבון הפעיל הוא חשבון השירות. עוברים לדף IAM במסוף Google Cloud כדי לוודא שחשבון השירות הוא בעלים של פרויקט Google Cloud.
אימות לא תקין באמצעות פרטי כניסה של משתמש קצה
השגיאה הבאה מתרחשת כשמריצים דוגמאות קוד:
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.
הבעיה הזו מתרחשת כשמשתמשים בפרטי כניסה של משתמש קצה במקום בחשבון שירות. הבעיה הזו יכולה לקרות גם אם חשבון השירות לא פעיל או אם משתני הסביבה הנדרשים לא מוגדרים. יכול להיות שהשגיאה הזו תופיע אחרי הפעלה מחדש של Cloud Shell או אחרי פתיחה של חלון טרמינל חדש.
כדי לפתור את הבעיה:
- פועלים לפי השלבים במדריך בנושא "הכנת סביבת העבודה" ומוודאים שחשבון השירות פעיל על ידי הפעלת הפקודה
gcloud auth list. מגדירים את משתני הסביבה:
- לכל השפות, מריצים את הפקודה:
export GOOGLE_APPLICATION_CREDENTIALS=~/key.json- בנוסף, ב- .NET, מריצים את הפקודה:
export GOOGLE_PROJECT_ID=<YOUR-PROJECT-ID>
שגיאת הרשאות כשאין לחשבון השירות את התפקידים הנדרשים
השגיאה הבאה מתרחשת כשמריצים דוגמאות קוד:
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"
הבעיה הזו מתרחשת כשאין לחשבון השירות שלכם את התפקידים הנדרשים: retail.admin ועריכה. כדי לפתור את הבעיה, צריך להגדיר את סביבת העבודה לפי השלבים במדריך בנושא הכנת סביבת העבודה.
The search operation returned no matching results
הבעיה הזו מתרחשת כשאין מוצרים בקטלוג שתואמים לשאילתת החיפוש או שהקטלוג ריק. כדי לפתור את הבעיה, צריך לבדוק אם יש מוצרים בקטלוג בדף Catalog במסוף Google Cloud. אם אין לכם קטלוג, אתם צריכים לייבא נתוני קטלוג לפי השלב במדריך בנושא ייבוא נתוני קטלוג.
הבעיות נמשכות
אפשר לנסות לאפס את Cloud Shell ולהפעיל את המדריכים מההתחלה.