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