ตรวจหาการละเมิดซ้ำโดยใช้การเรียกคืนอุปกรณ์ (เบต้า)

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

การเรียกคืนของอุปกรณ์ทำงานอย่างไร

การเรียกคืนของอุปกรณ์ช่วยให้แอปสามารถจัดเก็บและเรียกคืนข้อมูลที่กำหนดเองซึ่งเชื่อมโยงกับอุปกรณ์ที่เฉพาะเจาะจงในลักษณะที่รักษาความเป็นส่วนตัวของผู้ใช้ ข้อมูลจะจัดเก็บไว้ในเซิร์ฟเวอร์ของ 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 โดยทำดังนี้

  1. ลงชื่อเข้าใช้ Play Console
  2. เลือกแอปที่จะใช้การเรียกคืนของอุปกรณ์
  3. ไปที่ได้รับการปกป้องด้วย Google Play จากเมนูด้านซ้าย
  4. คลิกจัดการข้าง Play Integrity API
  5. ในส่วนการตอบกลับของหน้า ให้คลิกเปลี่ยนการตอบกลับ
  6. เปิดการเรียกคืนของอุปกรณ์
  7. คลิก "บันทึกการเปลี่ยนแปลง"

เมื่อเปิดหรือปิดการเรียกคืนของอุปกรณ์ ระบบจะลบการตอบกลับการทดสอบ 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"}