Halaman ini berisi beberapa kode error umum, apa yang diwakilinya, dan cara aplikasi atau game Anda meresponsnya.
| Kode error | Deskripsi | Tindakan Anda |
|---|---|---|
API_NOT_AVAILABLE |
Integrity API tidak tersedia. Integrity API tidak diaktifkan, atau versi Play Store mungkin sudah lama. | 1) Pastikan Play Integrity API diaktifkan di Konsol Google Play. 2) Minta pengguna untuk mengupdate Google Play Store. |
NETWORK_ERROR |
Tidak ditemukan jaringan yang tersedia. | Minta pengguna memeriksa konektivitas jaringan. |
PLAY_STORE_NOT_FOUND |
Tidak ada aplikasi Play Store resmi yang ditemukan di perangkat. | Minta pengguna menginstal atau mengaktifkan Google Play Store. |
PLAY_STORE_VERSION_OUTDATED |
Aplikasi Play Store perlu diupdate. | Minta pengguna untuk mengupdate Google Play Store. |
PLAY_STORE_ACCOUNT_NOT_FOUND |
Tidak ditemukan akun Play Store di perangkat. Perlu diketahui bahwa Play Integrity API kini mendukung permintaan yang tidak diautentikasi. Kode error ini hanya digunakan untuk versi Play Store lama yang tidak memiliki dukungan. | Minta pengguna login ke Google Play Store. |
CANNOT_BIND_TO_SERVICE |
Gagal melakukan binding ke layanan di Play Store. Hal ini dapat disebabkan oleh versi Play Store lama yang masih terinstal di perangkat. | Minta pengguna mengupdate Google Play Store. |
APP_NOT_INSTALLED |
Aplikasi panggilan tidak diinstal. | Terjadi masalah; mungkin berupa serangan. Tidak dapat ditindaklanjuti. |
PLAY_SERVICES_NOT_FOUND |
Layanan Play tidak tersedia atau perlu diupdate. | Minta pengguna menginstal atau mengaktifkan Layanan Play. |
PLAY_SERVICES_VERSION_OUTDATED |
Layanan Play perlu diupdate. | Minta pengguna mengupdate layanan Google Play. |
TOO_MANY_REQUESTS |
Aplikasi panggilan membuat terlalu banyak permintaan ke API dan sekarang telah dibatasi. |
|
REQUEST_HASH_TOO_LONG |
requestHash yang diberikan terlalu panjang. Panjang requestHash harus kurang dari 500 karakter. |
Coba lagi dengan requestHash yang lebih singkat. |
GOOGLE_SERVER_UNAVAILABLE |
Error server Google internal tidak diketahui. | Coba lagi dengan backoff eksponensial. |
CLIENT_TRANSIENT_ERROR |
Terjadi error sementara pada perangkat klien. Untuk Permintaan API Standar, permintaan ini didukung mulai library versi 1.3.0 untuk bahasa pemrograman Kotlin dan Java, Plugin Google Play Integrity untuk Unity 1.3.0 atau yang lebih tinggi, dan Play Core Native SDK 1.13.0 atau lebih tinggi. | |
INTERNAL_ERROR |
Error internal tidak diketahui. | Coba lagi dengan backoff eksponensial. |
NONCE_TOO_SHORT |
Panjang nonce terlalu singkat. Panjang nonce harus minimum 16 byte (sebelum encoding base64). | Coba lagi dengan nonce yang lebih panjang. |
NONCE_TOO_LONG |
Panjang nonce terlalu panjang. Panjang nonce harus kurang dari 500 byte sebelum encoding base64. | Coba lagi dengan nonce yang lebih pendek. |
NONCE_IS_NOT_BASE64 |
Nonce tidak dalam bentuk base64 web-safe no-wrap. | Coba lagi dengan format nonce yang benar. |
CLOUD_PROJECT_NUMBER_IS_INVALID |
Nomor project cloud yang diberikan tidak valid. | Gunakan nomor project Cloud untuk project Cloud tempat Anda mengaktifkan Play Integrity API. |
APP_UID_MISMATCH |
UID (ID pengguna) aplikasi panggilan tidak cocok dengan ID dari Pengelola Paket. | Terjadi masalah; mungkin berupa serangan. Tidak dapat ditindaklanjuti. |
INTEGRITY_TOKEN_PROVIDER_INVALID |
StandardIntegrityTokenProvider tidak valid. Kode error ini hanya tersedia untuk permintaan API Standar, yang didukung mulai library versi 1.3.0 untuk bahasa pemrograman Kotlin dan Java, Plugin Google Play Integrity untuk Unity 1.3.0 atau yang lebih tinggi, dan Play Core Native SDK 1.13.0 atau yang lebih tinggi. |
Minta penyedia token integritas baru. |
Kode error khusus native
Awalan INTEGRITY_ ditambahkan ke kode error native untuk menghindari potensi
konflik penamaan. Selain kode error yang tercantum di atas, API native juga
menyertakan kode error berikut:
| Kode error | Deskripsi | Tindakan Anda |
|---|---|---|
INTEGRITY_INITIALIZATION_NEEDED |
IntegrityManager tidak diinisialisasi. | Panggil IntegrityManager_init() terlebih dahulu. |
INTEGRITY_INITIALIZATION_FAILED |
Terjadi error saat melakukan inisialisasi Integrity API. | Coba lagi dengan backoff eksponensial. Sebaiknya laporkan bug. |
INTEGRITY_INVALID_ARGUMENT |
Argumen yang tidak valid diteruskan ke Integrity API. | Coba lagi dengan argumen yang benar. |
Mencoba ulang logika saat terjadi error
Aplikasi harus mencoba ulang panggilan API jika terdapat kode error tertentu. Tinjau semua kode error, dan pastikan aplikasi mencoba ulang sesuai keperluan dengan backoff eksponensial. Strategi percobaan ulang yang direkomendasikan adalah:
- Setelah kegagalan pertama, mulailah dengan penundaan awal selama 5 detik sebelum mencoba lagi.
- Coba lagi maksimal tiga kali, dengan meningkatkan penundaan secara eksponensial dalam tiap percobaan (10 dtk, 20 dtk).
Saat mencoba ulang, periksa koneksi jaringan dan jangan melebihi beban perangkat.
Jika Anda terus melihat error setelah tiga kali percobaan, perlakukan hasilnya seolah-olah klien telah gagal dalam semua pemeriksaan integritas. Error ini dapat disebabkan oleh beberapa alasan, termasuk (tetapi tidak terbatas pada): perangkat yang kelebihan beban, masalah koneksi jaringan, atau upaya oleh penyerang.