Jika Anda mengalami masalah saat mengonfigurasi tutorial, halaman ini akan mencantumkan masalah yang mungkin Anda alami dan memberikan saran untuk memperbaiki setiap masalah.
Folder cloudshell_open tidak ada
Jika Anda tidak dapat melihat folder cloudshell_open di direktori utama dengan menjalankan ls ~, folder dan file-nya akan hilang.
Masalah ini terjadi saat Anda menggunakan Cloud Shell dalam mode Singkat dan kehilangan koneksi Internet atau memuat ulang halaman.
Untuk mengatasi masalah ini, jalankan kembali tutorial dari awal. Untuk menghindari kehilangan file di masa mendatang, pertimbangkan untuk beralih ke mode Default.
Tidak dapat mendeteksi project ID 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 belum ditetapkan. Untuk mengatasi masalah ini, setel 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 itu yang terjadi dengan menjalankan perintah berikut:
cat ~/key.json
Tindakan ini akan mencetak konten file atau pesan No such file or directory. File kosong berarti terjadi error selama pembuatan kunci. File yang hilang berarti error terjadi sebelumnya.
Untuk mengatasi masalah ini, ikuti langkah tutorial "Menyiapkan lingkungan kerja Anda".
Vertex AI Search untuk retail belum pernah digunakan dalam project atau telah dinonaktifkan
Error berikut ini 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 untuk 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.iam.gserviceaccount.com] 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, periksa apakah Anda memiliki akun yang benar dan aktif dengan menjalankan perintah gcloud auth list di Terminal. Pastikan akun yang aktif adalah akun layanan. Buka halaman IAM di Google Cloud Console 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 jika kredensial pengguna akhir digunakan, bukan akun layanan. Masalah ini juga dapat terjadi saat 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 Anda" 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 Anda".
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 Anda di halaman Catalog pada 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.