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 Sementara dan koneksi Internet Anda terputus atau Anda memuat ulang halaman.
Untuk mengatasi masalah ini, jalankan kembali 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 sampel kode:
ERROR Unable to detect a Project Id in the current environment.
Masalah ini terjadi saat project Google Cloud Anda tidak disetel. 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
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 sebelumnya.
Untuk mengatasi masalah ini, ikuti langkah tutorial "Siapkan lingkungan kerja Anda".
Vertex AI Search untuk commerce belum pernah digunakan dalam project sebelumnya atau dinonaktifkan
Error berikut terjadi saat Anda mencoba menjalankan tutorial:
PERMISSION_DENIED: Vertex AI Search for commerce API has not been used in project <YOUR-PROJECT-ID> before or it is disabled
Untuk mengatasi masalah ini, aktifkan Vertex AI Search untuk e-commerce di halaman Detail API/Layanan 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, periksa apakah Anda telah mengaktifkan akun yang tepat 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 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 "Siapkan 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 saat 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 "Siapkan lingkungan kerja Anda".
Operasi penelusuran tidak menampilkan hasil yang cocok
Masalah ini terjadi jika tidak ada produk dalam katalog yang cocok dengan kueri penelusuran Anda atau katalog produk kosong. Untuk mengatasi masalah ini, periksa apakah Anda memiliki produk dalam katalog di halaman Katalog di Konsol Google Cloud. Jika tidak, impor data katalog dengan mengikuti langkah-langkah tutorial "Mengimpor data katalog".
Masih ada masalah
Coba reset Cloud Shell dan jalankan tutorial dari awal.