หน้านี้อธิบายวิธีใช้การเรียกคืนของอุปกรณ์เพื่อจัดเก็บและเรียกข้อมูลที่กำหนดเองด้วยอุปกรณ์ที่เฉพาะเจาะจง คุณสามารถเรียกคืนข้อมูลที่กำหนดเองได้อย่างน่าเชื่อถือในภายหลังเมื่อติดตั้งแอปในอุปกรณ์เครื่องเดิม แม้หลังจากรีเซ็ตอุปกรณ์แล้วก็ตาม ฟีเจอร์นี้ช่วยให้คุณตรวจจับและป้องกันไม่ให้อุปกรณ์ถูกนำมาใช้ซ้ำโดยอิงตามการดำเนินการหรือพฤติกรรมที่คุณระบุ ขณะเดียวกันก็รักษาความเป็นส่วนตัวของผู้ใช้
การเรียกคืนของอุปกรณ์ทำงานอย่างไร
การเรียกคืนของอุปกรณ์ช่วยให้แอปสามารถจัดเก็บและเรียกคืนข้อมูลที่กำหนดเองซึ่งเชื่อมโยงกับอุปกรณ์ที่เฉพาะเจาะจงในลักษณะที่รักษาความเป็นส่วนตัวของผู้ใช้ ข้อมูลจะจัดเก็บไว้ในเซิร์ฟเวอร์ของ Google ซึ่งช่วยให้แอปของคุณเรียกดูข้อมูลที่กำหนดเองได้อย่างน่าเชื่อถือ แม้หลังจากติดตั้งแอปอีกครั้งหรือรีเซ็ตอุปกรณ์แล้วก็ตาม ตัวอย่างเช่น คุณสามารถใช้ฟีเจอร์นี้เพื่อเรียกคืนอุปกรณ์ที่คุณพบหลักฐานการละเมิดอย่างรุนแรง อุปกรณ์ที่แลกรับไอเทมที่มีมูลค่าสูงไปแล้ว (เช่น ช่วงทดลองใช้ฟรี) หรืออุปกรณ์ที่มีการใช้ซ้ำเพื่อสร้างบัญชีใหม่เพื่อวัตถุประสงค์ในการละเมิด การเรียกคืนของอุปกรณ์จะช่วยรักษาความเป็นส่วนตัวของผู้ใช้ เนื่องจากแอปที่ส่งคำขอจะเรียกคืนได้เฉพาะข้อมูลที่จำกัดซึ่งเชื่อมโยงกับอุปกรณ์ โดยไม่ต้องเข้าถึงตัวระบุอุปกรณ์หรือตัวระบุผู้ใช้ หลังจากเปิดการเรียกคืนของอุปกรณ์แล้ว คุณจะทำสิ่งต่อไปนี้ได้
- อ่านข้อมูลต่ออุปกรณ์: คุณสามารถอ่านค่าที่กำหนดเอง 3 ค่าหรือบิตสำหรับอุปกรณ์แต่ละเครื่องเมื่อได้รับการตัดสินความสมบูรณ์ คุณสามารถกำหนดความหมายของค่าเหล่านี้ได้เอง เช่น คุณสามารถใช้ค่าเป็นแฟล็กแยกกัน 3 รายการ หรือจะรวมค่าเพื่อแสดงป้ายกำกับที่กำหนดเอง 8 รายการก็ได้
- แก้ไขข้อมูลต่ออุปกรณ์: หลังจากได้รับโทเค็นความสมบูรณ์แล้ว คุณสามารถใช้โทเค็นดังกล่าวเพื่อเรียกใช้ฝั่งเซิร์ฟเวอร์ไปยังเซิร์ฟเวอร์ของ Google Play เพื่อแก้ไขค่าอย่างน้อย 1 ค่า คุณมีเวลาสูงสุด 14 วันในการใช้โทเค็น ซึ่งจะช่วยให้คุณแก้ไขค่าได้ เช่น หากการละเมิดปรากฏขึ้นอย่างชัดเจนในช่วง 2 สัปดาห์หลังจากที่คุณทำการตรวจสอบความสมบูรณ์เป็นครั้งแรกเท่านั้น เมื่อคุณแก้ไขค่า ระบบจะจัดเก็บเดือนและปีที่ทำการแก้ไขด้วย
ข้อกำหนดเบื้องต้นและข้อควรพิจารณาสำหรับการเรียกคืนของอุปกรณ์
คุณจะใช้การเรียกคืนของอุปกรณ์เพื่อจัดเก็บและเรียกคืนข้อมูลเพื่อปกป้องความปลอดภัยของแอปและลดการละเมิด การประพฤติมิชอบ และการเข้าถึงที่ไม่ได้รับอนุญาตได้เท่านั้น คุณต้องไม่ใช้การเรียกคืนของอุปกรณ์เพื่อทำฟิงเกอร์ปรินต์หรือติดตามผู้ใช้หรืออุปกรณ์แต่ละราย และต้องไม่ใช้การเรียกคืนของอุปกรณ์เพื่อติดตามลักษณะที่ละเอียดอ่อนของผู้ใช้หรืออุปกรณ์ เช่น เพศ อายุ หรือข้อมูลตำแหน่ง
การเรียกคืนของอุปกรณ์มีข้อกำหนดเบื้องต้นต่อไปนี้
- การเรียกคืนของอุปกรณ์ใช้ได้กับโทรศัพท์, แท็บเล็ต, อุปกรณ์แบบพับได้, ทีวี, รถยนต์ และ Wear OS ใน Wear การเรียกคืนของอุปกรณ์จะใช้ได้เฉพาะในอุปกรณ์ที่มาพร้อมกับ Wear OS 5 ขึ้นไปเท่านั้น โปรแกรมจำลองไม่รองรับการเรียกคืนของอุปกรณ์
- การเรียกคืนของอุปกรณ์กำหนดให้ต้องติดตั้งและเปิดใช้ทั้ง Google Play Store และบริการ Google Play เวอร์ชันล่าสุดในอุปกรณ์
- การเรียกคืนของอุปกรณ์กำหนดให้บัญชีผู้ใช้ต้องได้รับอนุญาตจาก Play มิเช่นนั้นคำตัดสินจะไม่มีการประเมิน
การเรียกคืนของอุปกรณ์มีข้อควรพิจารณาเกี่ยวกับเวลาดังต่อไปนี้
- หลังจากยืนยันโทเค็นความสมบูรณ์แล้ว คุณจะมีเวลาสูงสุด 14 วันในการใช้โทเค็นดังกล่าวเพื่อจัดเก็บข้อมูลการเรียกคืนของอุปกรณ์ที่กำหนดเอง
- การเรียกคืนของอุปกรณ์จะรวมการประทับเวลาเพื่อให้คุณพิจารณาข้อมูลที่แก้ไขล่าสุดว่ามีลำดับความสำคัญสูงกว่าข้อมูลที่แก้ไขเมื่อนานมาแล้ว พิจารณาละเว้นหรือรีเซ็ตข้อมูลหลังจากผ่านไประยะเวลาหนึ่งที่นานพอ เพื่อพิจารณาว่าอุปกรณ์อาจเปลี่ยนมือหรือได้รับการซ่อมแซมใหม่และขายต่อ
- ระบบจะจัดเก็บบิตการเรียกคืนของอุปกรณ์เป็นเวลา 3 ปีหลังจากที่มีการเข้าถึงเพื่ออ่านหรือเขียนครั้งล่าสุด
- หากต้องการลบข้อมูลทั้งหมดที่เชื่อมโยงกับอุปกรณ์ แอปของคุณสามารถรีเซ็ตค่าทั้ง 3 ค่าในอุปกรณ์นั้นเป็น "เท็จ" ได้ การดำเนินการนี้จะรีเซ็ตการประทับเวลาโดยอัตโนมัติ
สำหรับนักพัฒนาแอปที่มีแอปหลายแอปและนักพัฒนาแอปที่โอนแอป การเรียกคืนของอุปกรณ์จะทำงานดังนี้
- แอปทั้งหมดในบัญชีนักพัฒนาแอป Google Play ของคุณจะมีสิทธิ์เข้าถึงค่า 3 ค่าเดียวกันต่ออุปกรณ์ กล่าวคือ หากแอปใดแอปหนึ่งของคุณแก้ไขค่าใดค่าหนึ่ง แอปทั้งหมดของคุณจะอ่านค่าที่แก้ไขเมื่อติดตั้งในอุปกรณ์เดียวกัน
- หากมีการโอนแอปจากบัญชีนักพัฒนาแอปหนึ่งไปยังอีกบัญชีหนึ่ง การเรียกคืนของอุปกรณ์จะแสดงข้อมูลต่ออุปกรณ์ของบัญชีนักพัฒนาแอปใหม่ ไม่ใช่ข้อมูลต่ออุปกรณ์ของบัญชีนักพัฒนาแอปเก่า
เปิดการเรียกคืนของอุปกรณ์
เมื่อพร้อมแล้ว ให้เปิดการเรียกคืนของอุปกรณ์ใน Play Console โดยทำดังนี้
- ลงชื่อเข้าใช้ Play Console
- เลือกแอปที่จะใช้การเรียกคืนของอุปกรณ์
- ไปที่ได้รับการปกป้องด้วย Google Play จากเมนูด้านซ้าย
- คลิกจัดการข้าง Play Integrity API
- ในส่วนการตอบกลับของหน้า ให้คลิกเปลี่ยนการตอบกลับ
- เปิดการเรียกคืนของอุปกรณ์
- คลิก "บันทึกการเปลี่ยนแปลง"
เมื่อเปิดหรือปิดการเรียกคืนของอุปกรณ์ ระบบจะลบการตอบกลับการทดสอบ Play Integrity API ที่คุณตั้งค่าไว้ใน Play Console และคุณจะต้องสร้างการตอบกลับอีกครั้ง
อ่านค่าการเรียกคืนของอุปกรณ์
การเรียกคืนของอุปกรณ์ใช้ได้กับทั้งคำขอ Play Integrity API แบบคลาสสิกและแบบมาตรฐาน ในคำขอมาตรฐาน ระบบจะรีเฟรชการเรียกคืนของอุปกรณ์ในการเรียกใช้เพื่อเตรียมความพร้อม กล่าวคือ หลังจากแก้ไขข้อมูลต่ออุปกรณ์แล้ว คุณจะต้องทำการวอร์มอัปอีกครั้งเพื่อดูค่าที่อัปเดต เมื่อเปิดใช้การเรียกคืนของอุปกรณ์แล้ว คุณจะอ่านค่าการเรียกคืนของอุปกรณ์ได้ในการตัดสินความสมบูรณ์
แก้ไขค่าการเรียกคืนของอุปกรณ์
คุณแก้ไขค่าการเรียกคืนของอุปกรณ์ได้โดยทำการเรียก API แบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์ซึ่งคล้ายกับการถอดรหัสคำตัดสินความสมบูรณ์ การตั้งค่าบิตเป็น true จะอัปเดตวันที่เขียนด้วย (แม้ว่าจะเป็น true อยู่แล้วก็ตาม)
การตั้งค่าบิตเป็น false จะรีเซ็ตวันที่เขียนให้ว่างเปล่า บิตที่ไม่ได้ระบุในคำขอจะยังคงไม่เปลี่ยนแปลง มีความล่าช้าในการเผยแพร่เล็กน้อยระหว่างการเขียนบิตและการอ่านบิตเหล่านั้นกลับมาในคำตัดสิน ความล่าช้านี้อาจนานถึง 30 วินาที แต่โดยทั่วไปจะสั้นกว่านั้นมาก คำขอเขียนการเรียกคืนของอุปกรณ์ควรมีความถี่น้อยกว่าคำขอโทเค็นความสมบูรณ์ การตรวจสอบเหล่านี้จะไม่นับรวมในโควต้าคำขอโทเค็นความสมบูรณ์ แต่จะขึ้นอยู่กับการจำกัดอัตราคำขอแยกต่างหาก
playintegrity.googleapis.com/v1/PACKAGE_NAME/deviceRecall:write -d \
'{
"integrityToken": "INTEGRITY_TOKEN",
"newValues": {
"bitFirst": true,
"bitThird": false
}
}'newValues.BitFirst = true // ForceSendFields optional for value true newValues.BitSecond = false // ForceSendFields required for value false newValues.BitThird = nil // do not set ForceSendFields for unspecified bits newValues.ForceSendFields = []string{"BitSecond"}