Jika Anda mengalami masalah saat mengonfigurasi tutorial, halaman ini mencantumkan masalah yang mungkin Anda alami dan memberikan saran tentang cara memperbaiki setiap masalah.
Folder cloudshell_open tidak ada
Jika Anda tidak dapat melihat folder cloudshell_open di direktori utama dengan menjalankan ls ~, folder dan filenya akan hilang.
Masalah ini terjadi saat Anda menggunakan Cloud Shell dalam mode Ephemeral dan kehilangan koneksi Internet atau memuat ulang halaman.
Untuk mengatasi masalah ini, jalankan ulang tutorial dari awal. Untuk menghindari hilangnya file Anda di masa mendatang, pertimbangkan untuk beralih ke mode Default.
Tidak dapat mendeteksi ID project di lingkungan saat ini
Error berikut terjadi saat Anda mencoba menjalankan contoh kode:
ERROR Unable to detect a Project Id in the current environment.
Masalah ini terjadi jika project Google Cloud Anda tidak ditetapkan. Untuk mengatasi masalah ini, tetapkan project dengan menjalankan perintah berikut:
gcloud config set project <YOUR-PROJECT-ID>
Error key.json saat menjalankan contoh kode
Salah satu error berikut terjadi saat Anda menjalankan contoh kode:
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
Masalah ini terjadi saat file key.json, yang digunakan untuk mengautentikasi akun layanan, kosong atau tidak ada. Anda dapat memeriksa apakah hal itu terjadi dengan menjalankan perintah berikut:
cat ~/key.json
Tindakan ini akan mencetak isi file atau pesan No such file or directory. File kosong berarti error terjadi selama pembuatan kunci. File yang tidak ada berarti error terjadi sebelum itu.
Untuk mengatasi masalah ini, ikuti langkah tutorial "Menyiapkan lingkungan kerja".
Vertex AI Search untuk retail belum pernah digunakan dalam project sebelumnya atau dinonaktifkan
Error berikut terjadi saat Anda mencoba menjalankan tutorial:
PERMISSION_DENIED: Vertex AI Search for retail API has not been used in project <YOUR-PROJECT-ID> before or it is disabled
Untuk mengatasi masalah ini, aktifkan Vertex AI Search for retail di halaman API/Services Details di Konsol Google Cloud, atau jalankan perintah berikut:
gcloud services enable \
retail.googleapis.com \
--project=<YOUR-PROJECT-ID>
Akun layanan tidak memiliki izin untuk mengakses instance project
Error berikut terjadi saat Anda menetapkan peran ke akun layanan:
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.
Untuk mengatasi masalah ini, pastikan Anda memiliki akun yang tepat yang aktif dengan menjalankan perintah gcloud auth list di Terminal. Pastikan akun yang aktif adalah akun layanan. Buka halaman IAM di Konsol Google Cloud untuk memeriksa apakah akun layanan adalah pemilik project Google Cloud Anda.
Autentikasi tidak valid menggunakan kredensial pengguna akhir
Error berikut terjadi saat Anda menjalankan contoh kode:
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.
Masalah ini terjadi saat kredensial pengguna akhir digunakan, bukan akun layanan. Masalah ini juga dapat terjadi jika akun layanan tidak aktif atau variabel lingkungan yang diperlukan tidak ditetapkan. Anda mungkin melihat error ini setelah memulai ulang Cloud Shell atau membuka jendela Terminal baru.
Untuk menyelesaikan masalah ini:
- Ikuti langkah-langkah tutorial "Menyiapkan lingkungan kerja" dan pastikan Anda memiliki akun layanan yang aktif dengan menjalankan
gcloud auth list. Tetapkan variabel lingkungan:
- Untuk semua bahasa, jalankan perintah:
export GOOGLE_APPLICATION_CREDENTIALS=~/key.json- Selain itu, untuk .NET, jalankan perintah:
export GOOGLE_PROJECT_ID=<YOUR-PROJECT-ID>
Error izin saat akun layanan tidak memiliki peran yang diperlukan
Error berikut terjadi saat Anda menjalankan contoh kode:
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"
Masalah ini terjadi jika akun layanan Anda tidak memiliki peran yang diperlukan: retail.admin dan editor. Untuk mengatasi masalah ini, siapkan lingkungan kerja Anda dengan mengikuti langkah-langkah tutorial "Menyiapkan lingkungan kerja".
Operasi penelusuran tidak menampilkan hasil yang cocok
Masalah ini terjadi jika tidak ada produk di katalog yang cocok dengan kueri penelusuran Anda atau katalog produk kosong. Untuk mengatasi masalah ini, periksa apakah Anda memiliki produk di katalog di halaman Katalog di Konsol Google Cloud. Jika tidak, impor data katalog dengan mengikuti langkah tutorial "Mengimpor data katalog".
Masih ada masalah
Coba reset Cloud Shell dan jalankan tutorial dari awal.