Instance ID API מאפשר לכם לשלב מזהה מופע עם אפליקציית Android או iOS. מזהה המופע מספק מזהה ייחודי לכל מופע של האפליקציה ומנגנון לאימות ולאישור פעולות. ה-InstanceID
הוא לטווח ארוך, אבל יכול להיות שהוא יפוג מהסיבות הבאות:
- איפוס המכשיר להגדרות המקוריות.
- המשתמש מסיר את האפליקציה.
- המשתמש מבצע 'ניקוי נתונים' באפליקציה.
- המכשיר לא היה בשימוש במשך תקופה ממושכת (משך הזמן נקבע לפי המכשיר והאזור).
- שירות Instance ID מזהה ניצול לרעה או שגיאות ומאפס את הערך של
InstanceID
. - קוד בצד השרת אם אפליקציית הלקוח שלכם דורשת את הפונקציונליות הזו.
שירות מזהה המופע מודיע לאפליקציה על איפוס של InstanceID
באמצעות קריאה חוזרת אל InstanceIDListenerService
. אם האפליקציה מקבלת את ההתראה הזו, היא צריכה להתקשר אל getToken()
, לאחזר את InstanceID
החדש ולעדכן את השרתים שלה.
משתמשים בשיטה getToken
כדי להוכיח את הבעלות על InstanceID
וכדי לאפשר לשרתים לגשת לנתונים או לשירותים שמשויכים לאפליקציה. השיטה מבוססת על דפוסי OAuth2, ונדרשים בה authorizedEntity
ו-scope
. הערך של authorizedEntity
יכול להיות מזהה פרויקט או InstanceID
אחר, והוא קובע אילו שירותים מורשים להשתמש באסימון שנוצר. הפרמטר scope
קובע את השירות או הנתונים הספציפיים שהאסימון מאפשר גישה אליהם.
מידע נוסף על Instance ID API ל: