จัดการรหัสข้อผิดพลาดของ Play Integrity API

หากแอปส่งคำขอ Play Integrity API และการเรียกใช้ไม่สำเร็จ แอปจะได้รับรหัสข้อผิดพลาด ข้อผิดพลาดเหล่านี้อาจเกิดขึ้นได้จากหลายสาเหตุ เช่น ปัญหาด้านสภาพแวดล้อม เช่น การเชื่อมต่อเครือข่ายไม่ดี ปัญหาเกี่ยวกับการผสานรวม API หรือกิจกรรมที่เป็นอันตรายและการโจมตีที่เกิดขึ้นอยู่ ประเภทของรหัสข้อผิดพลาดที่แสดงผลจะขึ้นอยู่กับประเภทของคำขอ ดังนี้

กลยุทธ์การลองใหม่

ใช้ Exponential Backoff สำหรับการดำเนินการของ Play Integrity ที่เกิดขึ้นในเบื้องหลังและไม่ส่งผลต่อประสบการณ์ของผู้ใช้ขณะที่ผู้ใช้อยู่ในเซสชัน

ตัวอย่างเช่น คุณควรใช้กลยุทธ์นี้เมื่อรับทราบการซื้อใหม่ เนื่องจากสามารถดำเนินการนี้ในเบื้องหลังได้ และไม่จำเป็นต้องรับทราบแบบเรียลไทม์หากเกิดข้อผิดพลาด

หลังจากดำเนินการไม่สำเร็จครั้งแรก ให้เริ่มด้วยการหน่วงเวลาเริ่มต้น 5 วินาทีก่อนลองอีกครั้ง

ใช้กลยุทธ์การลองใหม่โดยกำหนดจำนวนครั้งสูงสุดเป็นเงื่อนไขการออก โดยใช้การหน่วงเวลาที่เพิ่มขึ้นแบบทวีคูณในแต่ละครั้ง (10 วินาที, 20 วินาที)

ขณะพยายามลองใหม่เหล่านี้ ให้ตรวจสอบการเชื่อมต่อเครือข่ายและอย่าให้อุปกรณ์ทำงานหนักเกินไป

หากคุณยังคงเห็นข้อผิดพลาดหลังจากพยายามอีก 3 ครั้ง ให้ถือว่าผลลัพธ์เป็นเหมือนกับว่าไคลเอ็นต์ไม่ผ่านการตรวจสอบความสมบูรณ์ทั้งหมด ข้อผิดพลาดอาจเกิดจากหลายสาเหตุ ซึ่งรวมถึง (แต่ไม่จำกัดเพียง) อุปกรณ์ทำงานหนักเกินไป ปัญหาการเชื่อมต่อเครือข่าย หรือความพยายามของผู้โจมตี

ค่ารหัสข้อผิดพลาดสำหรับไลบรารี Java

IntegrityErrorCode StandardIntegrityErrorCode
-1 API_NOT_AVAILABLE API_NOT_AVAILABLE
-2 PLAY_STORE_NOT_FOUND PLAY_STORE_NOT_FOUND
-3 NETWORK_ERROR NETWORK_ERROR
-4 PLAY_STORE_ACCOUNT_NOT_FOUND
-5 APP_NOT_INSTALLED APP_NOT_INSTALLED
-6 PLAY_SERVICES_NOT_FOUND PLAY_SERVICES_NOT_FOUND
-7 APP_UID_MISMATCH APP_UID_MISMATCH
-8 TOO_MANY_REQUESTS TOO_MANY_REQUESTS
-9 CANNOT_BIND_TO_SERVICE CANNOT_BIND_TO_SERVICE
-10 NONCE_TOO_SHORT
-11 NONCE_TOO_LONG
-12 GOOGLE_SERVER_UNAVAILABLE GOOGLE_SERVER_UNAVAILABLE
-13 NONCE_IS_NOT_BASE64
-14 PLAY_STORE_VERSION_OUTDATED PLAY_STORE_VERSION_OUTDATED
-15 PLAY_SERVICES_VERSION_OUTDATED PLAY_SERVICES_VERSION_OUTDATED
-16 CLOUD_PROJECT_NUMBER_IS_INVALID CLOUD_PROJECT_NUMBER_IS_INVALID
-17 CLIENT_TRANSIENT_ERROR REQUEST_HASH_TOO_LONG
-18 CLIENT_TRANSIENT_ERROR
-19 INTEGRITY_TOKEN_PROVIDER_INVALID
-100 INTERNAL_ERROR INTERNAL_ERROR

ค่ารหัสข้อผิดพลาดเพิ่มเติมสำหรับไลบรารีแบบเนทีฟ

IntegrityErrorCode StandardIntegrityErrorCode
-100 INTEGRITY_INTERNAL_ERROR STANDARD_INTEGRITY_INTERNAL_ERROR
-101 INTEGRITY_INITIALIZATION_NEEDED STANDARD_INTEGRITY_INITIALIZATION_NEEDED
-102 INTEGRITY_INITIALIZATION_FAILED STANDARD_INTEGRITY_INITIALIZATION_FAILED
-103 INTEGRITY_INVALID_ARGUMENT STANDARD_INTEGRITY_INVALID_ARGUMENT

รหัสข้อผิดพลาดที่คุณลองอีกครั้งได้

สาเหตุของข้อผิดพลาดเหล่านี้บางครั้งเกิดจากสภาวะชั่วคราว ดังนั้นคุณจึงควรลองเรียกใช้ API อีกครั้ง

NETWORK_ERROR (รหัสข้อผิดพลาด -3)

ข้อผิดพลาดนี้บ่งชี้ว่าเกิดปัญหาเกี่ยวกับการเชื่อมต่อเครือข่ายระหว่างอุปกรณ์กับระบบ Play

การแก้ไขที่เป็นไปได้

  1. ใช้กล่องโต้ตอบ GET_INTEGRITY หรือ GET_STRONG_INTEGRITY เพื่อเริ่มประสบการณ์การใช้งานที่แนะนำโดย Play ซึ่งจะช่วยให้ผู้ใช้สร้างและยืนยันการเชื่อมต่อเครือข่ายได้
  2. ขอให้ผู้ใช้ตรวจสอบการเชื่อมต่อเครือข่าย และใช้การลองใหม่ขั้นพื้นฐานหรือ Exponential Backoff โดยขึ้นอยู่กับการดำเนินการที่ทำให้เกิดข้อผิดพลาด

ดูเพิ่มเติม

NETWORK_ERROR สำหรับคำขอแบบคลาสสิก

TOO_MANY_REQUESTS (รหัสข้อผิดพลาด -8)

แอปการโทรส่งคำขอไปยัง API มากเกินไปและถูกจำกัด หรือแอปของคุณส่งคำขอเกินโควต้ารายวัน

การแก้ไขที่เป็นไปได้

  1. ลองอีกครั้งโดยใช้ Exponential Backoff
  2. ขอเพิ่มจำนวนคำขอสูงสุดต่อวัน

ดูเพิ่มเติม

TOO_MANY_REQUESTS สำหรับคำขอแบบคลาสสิก

GOOGLE_SERVER_UNAVAILABLE (รหัสข้อผิดพลาด -12)

ข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ Google ภายในที่ไม่รู้จัก

การแก้ไขที่เป็นไปได้

ลองอีกครั้งโดยใช้ Exponential Backoff ลองรายงานข้อบกพร่องหากดำเนินการไม่สำเร็จอย่างต่อเนื่อง

ดูเพิ่มเติม

GOOGLE_SERVER_UNAVAILABLE สำหรับคำขอแบบคลาสสิก

CLIENT_TRANSIENT_ERROR (รหัสข้อผิดพลาด -18)

เกิดข้อผิดพลาดชั่วคราวในอุปกรณ์ไคลเอ็นต์

สำหรับคำขอ API แบบ Standard ฟีเจอร์นี้รองรับตั้งแต่เวอร์ชัน 1.3.0 ของไลบรารี Play Integrity API สำหรับ Kotlin และ Java, ปลั๊กอิน Google Play Integrity สำหรับ Unity เวอร์ชัน 1.3.0 ขึ้นไป และ SDK ของ Play Core Native เวอร์ชัน 1.13.0 ขึ้นไป

การแก้ไขที่เป็นไปได้

ลองอีกครั้งโดยใช้ Exponential Backoff

ดูเพิ่มเติม

CLIENT_TRANSIENT_ERROR สำหรับคำขอแบบคลาสสิก

หมายเหตุ: เมื่อรายงานขณะใช้คำขอ API แบบคลาสสิก ค่าที่แสดงผลคือ -17

INTERNAL_ERROR (รหัสข้อผิดพลาด -100)

เกิดข้อผิดพลาดภายในที่ไม่รู้จัก

การแก้ไขที่เป็นไปได้

ลองอีกครั้งโดยใช้ Exponential Backoff ลองรายงานข้อบกพร่องหากดำเนินการไม่สำเร็จอย่างต่อเนื่อง

ดูเพิ่มเติม

INTERNAL_ERROR สำหรับคำขอแบบคลาสสิก

STANDARD_INTEGRITY_INTERNAL_ERROR (รหัสข้อผิดพลาด -100)

เกิดข้อผิดพลาดภายในที่ไม่รู้จัก

การแก้ไขที่เป็นไปได้

ลองอีกครั้งโดยใช้ Exponential Backoff ลองรายงานข้อบกพร่องหากดำเนินการไม่สำเร็จอย่างต่อเนื่อง

ดูเพิ่มเติม

โปรดดู INTEGRITY_INTERNAL_ERROR สำหรับคำขอแบบคลาสสิก

STANDARD_INTEGRITY_INITIALIZATION_FAILED (รหัสข้อผิดพลาด -102)

เกิดข้อผิดพลาดในการเริ่มต้น Standard Integrity API

การแก้ไขที่เป็นไปได้

ลองอีกครั้งโดยใช้ Exponential Backoff ลองรายงานข้อบกพร่องหากดำเนินการไม่สำเร็จอย่างต่อเนื่อง

ดูเพิ่มเติม

โปรดดู INTEGRITY_INITIALIZATION_FAILED สำหรับคำขอแบบคลาสสิก

รหัสข้อผิดพลาดที่ไม่ต้องลองอีกครั้ง

การลองใหม่อัตโนมัติไม่น่าจะช่วยได้ในกรณีเหล่านี้ อย่างไรก็ตาม การลองใหม่ด้วยตนเองอาจช่วยได้หากผู้ใช้แก้ไขเงื่อนไขที่เป็นสาเหตุของปัญหา ตัวอย่างเช่น หากผู้ใช้อัปเดตเวอร์ชัน Play Store เป็นเวอร์ชันที่รองรับ การลองดำเนินการเริ่มต้นอีกครั้งด้วยตนเองอาจได้ผล

API_NOT_AVAILABLE (รหัสข้อผิดพลาด -1)

เวอร์ชัน Play Store ที่ติดตั้งในอุปกรณ์อาจเป็นเวอร์ชันเก่าและ Integrity API ไม่พร้อมใช้งาน อีกสาเหตุหนึ่งที่เป็นไปได้คือไม่ได้เปิดใช้ Integrity API ใน Google Play Console

การแก้ไขที่เป็นไปได้

  • ตรวจสอบว่าได้เปิดใช้ Integrity API ใน Google Play Console แล้ว
  • ขอให้ผู้ใช้อัปเดต Play Store

ดูเพิ่มเติม

ดู API_NOT_AVAILABLE สำหรับคำขอแบบคลาสสิก

PLAY_STORE_NOT_FOUND (รหัสข้อผิดพลาด -2)

ไม่พบแอป Play Store อย่างเป็นทางการในอุปกรณ์

การแก้ไขที่เป็นไปได้

ขอให้ผู้ใช้ติดตั้งหรือเปิดใช้ Google Play Store

ดูเพิ่มเติม

ดู PLAY_STORE_NOT_FOUND สำหรับคำขอแบบคลาสสิก

PLAY_STORE_ACCOUNT_NOT_FOUND (รหัสข้อผิดพลาด -4)

หมายเหตุ: ระบบจะรายงานข้อมูลนี้สำหรับคำขอแบบคลาสสิกผ่าน IntegrityErrorCode เท่านั้น

ไม่พบบัญชี Play Store ในอุปกรณ์ โปรดทราบว่าตอนนี้ Play Integrity API รองรับคำขอที่ไม่ผ่านการตรวจสอบสิทธิ์แล้ว รหัสข้อผิดพลาดนี้ใช้สำหรับ Play Store เวอร์ชันเก่าที่ไม่รองรับเท่านั้น

การแก้ไขที่เป็นไปได้

ขอให้ผู้ใช้อัปเดตและลงชื่อเข้าใช้ Google Play Store

APP_NOT_INSTALLED (รหัสข้อผิดพลาด -5)

ไม่ได้ติดตั้งแอปการโทร เกิดข้อผิดพลาดบางอย่าง (อาจเป็นการโจมตี)

การแก้ไขที่เป็นไปได้

ดำเนินการไม่ได้ ถือว่าผลลัพธ์เป็นเหมือนกับว่าไคลเอ็นต์ไม่ผ่านการตรวจสอบความสมบูรณ์ทั้งหมด

ดูเพิ่มเติม

ดู APP_NOT_INSTALLED สำหรับคำขอแบบคลาสสิก

PLAY_SERVICES_NOT_FOUND (รหัสข้อผิดพลาด -6)

บริการ Google Play ไม่พร้อมใช้งานหรือต้องอัปเดต

การแก้ไขที่เป็นไปได้

  1. ใช้กล่องโต้ตอบ GET_INTEGRITY หรือ GET_STRONG_INTEGRITY เพื่อเริ่มประสบการณ์การใช้งานที่แนะนำโดย Play ซึ่งจะช่วยให้ผู้ใช้ติดตั้ง อัปเดต หรือเปิดใช้บริการ Google Play ได้
  2. ขอให้ผู้ใช้ติดตั้ง อัปเดต หรือเปิดใช้บริการ Google Play

ดูเพิ่มเติม

ดู APP_NOT_INSTALLED สำหรับคำขอแบบคลาสสิก

APP_UID_MISMATCH (รหัสข้อผิดพลาด -7)

UID (รหัสผู้ใช้) ของแอปการโทรไม่ตรงกับ UID จากเครื่องมือจัดการแพ็กเกจ

การแก้ไขที่เป็นไปได้

ดำเนินการไม่ได้ ถือว่าผลลัพธ์เป็นเหมือนกับว่าไคลเอ็นต์ไม่ผ่านการตรวจสอบความสมบูรณ์ทั้งหมด

ดูเพิ่มเติม

ดู APP_UID_MISMATCH สำหรับคำขอแบบคลาสสิก

CANNOT_BIND_TO_SERVICE (รหัสข้อผิดพลาด -9)

เชื่อมโยงกับบริการใน Play Store ไม่สำเร็จ ซึ่งอาจเกิดจากการติดตั้ง Play Store เวอร์ชันเก่าในอุปกรณ์

การแก้ไขที่เป็นไปได้

ขอให้ผู้ใช้อัปเดต Google Play Store

ดูเพิ่มเติม

ดู CANNOT_BIND_TO_SERVICE สำหรับคำขอแบบคลาสสิก

NONCE_TOO_SHORT (รหัสข้อผิดพลาด -10)

หมายเหตุ: ระบบจะรายงานข้อมูลนี้สำหรับคำขอแบบคลาสสิกผ่าน IntegrityErrorCode เท่านั้น

ความยาวของ Nonce สั้นเกินไป Nonce ต้องมีขนาดอย่างน้อย 16 ไบต์ก่อนการเข้ารหัส Base64

การแก้ไขที่เป็นไปได้

ลองอีกครั้งโดยใช้ Nonce ที่ยาวขึ้น

NONCE_TOO_LONG (รหัสข้อผิดพลาด -11)

หมายเหตุ: ระบบจะรายงานข้อมูลนี้สำหรับคำขอแบบคลาสสิกผ่าน IntegrityErrorCode เท่านั้น

ความยาวของ Nonce ยาวเกินไป Nonce ต้องมีขนาดไม่เกิน 500 ไบต์ก่อนการเข้ารหัส Base64

การแก้ไขที่เป็นไปได้

โปรดลองอีกครั้งโดยใช้ Nonce ที่สั้นลง

NONCE_IS_NOT_BASE64 (รหัสข้อผิดพลาด -13)

หมายเหตุ: ระบบจะรายงานข้อมูลนี้สำหรับคำขอแบบคลาสสิกผ่าน IntegrityErrorCode เท่านั้น

Nonce ไม่ได้เข้ารหัสเป็นสตริงแบบไม่มีการตัดบรรทัดที่ปลอดภัยสำหรับเว็บแบบ Base64

การแก้ไขที่เป็นไปได้

ลองอีกครั้งโดยใช้ Nonce ในรูปแบบที่ถูกต้อง

PLAY_STORE_VERSION_OUTDATED (รหัสข้อผิดพลาด -14)

ต้องอัปเดตแอป Google Play Store

การแก้ไขที่เป็นไปได้

ขอให้ผู้ใช้อัปเดต Google Play Store

ดูเพิ่มเติม

ดู PLAY_STORE_VERSION_OUTDATED สำหรับคำขอแบบคลาสสิก

PLAY_SERVICES_VERSION_OUTDATED (รหัสข้อผิดพลาด -15)

ต้องอัปเดตบริการ Google Play

การแก้ไขที่เป็นไปได้

  1. ใช้กล่องโต้ตอบ GET_INTEGRITY หรือ GET_STRONG_INTEGRITY เพื่อเริ่มประสบการณ์การใช้งานที่แนะนำโดย Play ซึ่งจะช่วยให้ผู้ใช้อัปเดตบริการ Google Play ได้
  2. ขอให้ผู้ใช้อัปเดตบริการ Google Play

ดูเพิ่มเติม

ดู PLAY_SERVICES_VERSION_OUTDATED สำหรับคำขอแบบคลาสสิก

CLOUD_PROJECT_NUMBER_IS_INVALID (รหัสข้อผิดพลาด -16)

หมายเลขโปรเจ็กต์ที่อยู่ในระบบคลาวด์ที่ระบุไม่ถูกต้อง

การแก้ไขที่เป็นไปได้

ใช้หมายเลขโปรเจ็กต์ที่อยู่ในระบบคลาวด์สำหรับโปรเจ็กต์ที่อยู่ในระบบคลาวด์ที่คุณเปิดใช้ Play Integrity API

ดูเพิ่มเติม

ดู CLOUD_PROJECT_NUMBER_IS_INVALID สำหรับคำขอแบบคลาสสิก

REQUEST_HASH_TOO_LONG (รหัสข้อผิดพลาด -17)

หมายเหตุ: ระบบจะรายงานข้อมูลนี้เมื่อใช้คำขอมาตรฐานผ่าน StandardIntegrityErrorCode เท่านั้น

requestHash ที่ระบุยาวเกินไป ความยาวของ requestHash ต้องน้อยกว่า 500 อักขระ

การแก้ไขที่เป็นไปได้

โปรดลองอีกครั้งโดยใช้ requestHash ที่สั้นลง

INTEGRITY_TOKEN_PROVIDER_INVALID (รหัสข้อผิดพลาด -19)

หมายเหตุ: ระบบจะรายงานเมตริกนี้สำหรับคำขอมาตรฐานผ่าน StandardIntegrityErrorCode เท่านั้น

StandardIntegrityTokenProvider ใช้งานไม่ได้อีกต่อไป กรณีนี้อาจเกิดขึ้นเนื่องจากผู้ให้บริการโทเค็นหมดอายุหรือผู้ใช้ล้างข้อมูลของแอป Play Store ซึ่งจะนำผู้ให้บริการโทเค็นออก

รหัสข้อผิดพลาดนี้ใช้ได้กับคำขอ Standard API เท่านั้น โดยรองรับตั้งแต่ไลบรารีเวอร์ชัน 1.3.0 สำหรับภาษาโปรแกรม Kotlin และ Java, ปลั๊กอิน Google Play Integrity สำหรับ Unity 1.3.0 ขึ้นไป และ Play Core Native SDK 1.13.0 ขึ้นไป

การแก้ไขที่เป็นไปได้

ขอผู้ให้บริการโทเค็นความสมบูรณ์รายใหม่

STANDARD_INTEGRITY_INITIALIZATION_NEEDED (รหัสข้อผิดพลาด -101)

StandardIntegrityManager ไม่ได้เริ่มต้นใช้งาน

การแก้ไขที่เป็นไปได้

โทรหา StandardIntegrityManager_init() ก่อน

ดูเพิ่มเติม

ดู INTEGRITY_INITIALIZATION_NEEDED สำหรับคำขอแบบคลาสสิก

STANDARD_INTEGRITY_INVALID_ARGUMENT (รหัสข้อผิดพลาด -103)

มีการส่งอาร์กิวเมนต์ที่ไม่ถูกต้องไปยัง Standard Integrity API

การแก้ไขที่เป็นไปได้

โปรดลองอีกครั้งโดยใช้อาร์กิวเมนต์ที่ถูกต้อง

ดูเพิ่มเติม

ดู INTEGRITY_INVALID_ARGUMENT สำหรับคำขอแบบคลาสสิก