API รหัสอินสแตนซ์ช่วยให้คุณผสานรวมรหัสอินสแตนซ์กับแอป Android หรือ iOS ได้ โดยรหัสอินสแตนซ์จะให้ตัวระบุที่ไม่ซ้ำกันสำหรับแต่ละอินสแตนซ์ของแอป และกลไกในการตรวจสอบสิทธิ์และให้สิทธิ์การดำเนินการ InstanceID
ใช้งานได้นาน แต่อาจหมดอายุเนื่องจากสาเหตุต่อไปนี้
- รีเซ็ตอุปกรณ์เป็นค่าเริ่มต้น
- ผู้ใช้ถอนการติดตั้งแอป
- ผู้ใช้ดำเนินการ "ล้างข้อมูล" ในแอป
- ไม่มีการใช้งานอุปกรณ์เป็นระยะเวลานาน (อุปกรณ์และภูมิภาคกำหนดช่วงเวลา)
- บริการรหัสอินสแตนซ์จะตรวจหาการละเมิดหรือข้อผิดพลาด และรีเซ็ต
InstanceID
- โค้ดฝั่งเซิร์ฟเวอร์หากแอปไคลเอ็นต์ของคุณจำเป็นต้องใช้ฟังก์ชันการทำงานดังกล่าว
บริการรหัสอินสแตนซ์จะแจ้งเตือนแอปของคุณเกี่ยวกับการรีเซ็ต InstanceID
ผ่านการเรียกกลับไปยัง InstanceIDListenerService
หากแอปได้รับการแจ้งเตือนนี้ จะต้องเรียกใช้ getToken()
และเรียกข้อมูล InstanceID
ใหม่และอัปเดตเซิร์ฟเวอร์ของแอป
ใช้เมธอด getToken
เพื่อพิสูจน์การเป็นเจ้าของ InstanceID
และอนุญาตให้เซิร์ฟเวอร์เข้าถึงข้อมูลหรือบริการที่เชื่อมโยงกับแอปได้ โดยวิธีนี้เป็นไปตามรูปแบบของ OAuth2 และต้องใช้ authorizedEntity
และ scope
โดย authorizedEntity
อาจเป็นรหัสโปรเจ็กต์หรือ InstanceID
อื่นก็ได้ ซึ่งจะระบุบริการที่ได้รับอนุญาตให้ใช้โทเค็นที่สร้างขึ้น scope
จะกำหนดบริการหรือข้อมูลเฉพาะที่โทเค็นอนุญาตให้เข้าถึงได้
ดูข้อมูลเพิ่มเติมเกี่ยวกับ API ของรหัสอินสแตนซ์สำหรับ