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