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